Tuki API

This mod/API works in conjunction with the Tukitas mod. It allows for the creation of shops on servers, enabling users to sell items to other players using Tukitas. It adds further functionality via commands. Please check the README for more information. Economy mod/API for servers using Neo Tukitas. Adds persistent virtual Tukitas accounts, a server bank, commands for setting up shops and NPCs, a general marketplace between players, and a Java API so other mods can use Tukitas. Available for NeoForge, Forge, and Fabric. The mc/1.21.1 branch is for Minecraft 1.21.1 and main for 26.3. Neo Tukitas 1.2.0 or higher requires it: the Tukitawallet becomes a window to your virtual account. All amounts are measured in copper value: 1 Gold = 10 Silver = 100 Copper. In commands, currencies can be typed in English or Spanish (copper/cobre, silver/plata, gold/oro); if omitted, copper is assumed.

Virtual Accounts

Each player has an account saved with the world. Physical coins can be converted into a balance and vice versa at any time:

The Tukitawallet from Neo Tukitas does the same through its UI: whatever you deposit into it goes to your account, and whatever you withdraw comes out of your account. If it gets lost, the money remains safely in the account. Balances stored in Tukitawallets from previous versions automatically transfer to the account of whoever holds them.

General Marketplace (/tukimarket or /tukimercado)

• /tukimercado sell <price> [currency]: puts whatever you are holding in your main hand up for sale. The server bank pays you the price immediately.
• /tukimercado: opens the market. Click on an item and confirm to buy it; the payment goes to the server bank.
• /tukimercado mine: your listed items. You can retrieve them by paying their price (returning to the bank what it paid you).

To prevent anyone from draining the bank by selling expensive junk, each player can earn a maximum of 5 Gold per day from their sales (any item, at any price), and the bank only pays as long as it has funds. Since everyone can see what is listed for sale, unfair pricing is easy to spot and report to an admin. If you retrieve an item on the same day you listed it, your limit allowance is restored. The day follows the server clock, and the limit does not reset when restarting the server. Admins can refill the bank using /tukibank bank add.

Admin Commands (permission level 2, ideal for NPCs, command blocks, and datapacks)

Example: A Vendor NPC with Easy NPC

In Easy NPC's dialogue actions, add a command action set to run with level 2 permissions:

tukibank admin sell @initiator minecraft:golden_apple 3 2 oro

The player interacting with the NPC pays 2 Gold from their account and receives 3 golden apples. If they cannot afford it, they receive a notification and nothing happens. With a command block, you would use @p instead of @initiator. For more complex setups, charge returns success or failure and can be chained (for instance, in command blocks or a datapack function):

scoreboard objectives add tk_pago dummy
execute store success score @p tk_pago run tukibank admin charge @p 50
execute if score @p tk_pago matches 1 run tp @p 100 64 200

Market Configuration

config/tukitas_api-market.json is generated automatically with initial default values:

• daily_sell_limit: how much each player can earn per day in the market (default: 500 = 5 Gold).
• blocked_items: items that cannot be sold (by default, coins and the Tukitawallet).
• max_listings_per_player: how many items each player can have listed at once.