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:

Command	Description
/tukibank or /tukibanco	Displays your balance
/tukibank deposit	Deposits all Tukitas from your inventory
/tukibank deposit <amount> <currency>	Deposits that amount of coins
/tukibank withdraw <amount> <currency>	Withdraws physical coins from your account
/tukibank pay <player> <amount> [currency]	Pays another player from your account

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)

Command	Description
/tukibank balance <player>	View someone's balance
/tukibank admin give <players> <amount> [currency]	Creates money and deposits it
/tukibank admin take <players> <amount> [currency]	Removes money (down to a balance of 0)
/tukibank admin set <players> <amount> [currency]	Sets the balance
/tukibank admin charge <player> <amount> [currency]	Charges a fee (goes to the bank). Fails if the player cannot afford it, making it useful for conditioning other commands
/tukibank admin sell <player> <item> <amount> <price> [currency]	Server shop: charges the player and gives the item, or does nothing if they cannot afford it
/tukibank admin buy <player> <item> <amount> <price> [currency]	Server buys from player: removes the items and pays them from the bank
/tukibank bank	Server bank balance
/tukibank bank add|remove <amount> [currency]	Refill or withdraw funds from the bank
/tukibank bank pay <player> <amount> [currency]	Pay from the bank (rewards, quests...)
/tukimercado admin dailylimit <amount> [currency]	Changes the daily sales limit per player
/tukimercado admin reload	Reloads config/tukitas_api-market.json

Example: A Vendor NPC with Easy NPC

In Easy NPC's dialogue actions, add a command action set to run with level 2 permissions: 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):

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.