Economy

The economy gives your players a virtual currency. They earn it by playing and spend it on commands and in the shop.

• Currency is per server. Each player has a separate balance on each game server. Your PvP server can have different prices than your PvE server.
• You name it. The default name is “Takaro coins”.
• Modules do the work. Takaro stores the balances. Modules decide how players earn and spend.

Turn the economy on

The economy is off by default.

1. Go to Settings → General.
2. Pick the Scope: Domain — all servers, or one game server.
3. Open the Economy section.
4. Turn on Economy Enabled.
5. Optional: change Currency Name.
6. Save.

Settings on a game server follow the domain-wide value until you click Override. So you can turn the economy on for every server at once, then turn it off again for one. Your server’s Settings page in the sidebar opens the same screen, scoped to that server.

How players earn currency

Install a module that pays out currency. Built-in options:

Module	How players earn
dailyRewards	/daily once a day. The reward grows with their login streak. Bonus rewards at milestones.
economyUtils	Currency for each zombie kill, paid out every 5 minutes. Set the amount with Zombie kill reward.
lottery	Players buy tickets. A daily draw pays the pot to one winner.

You can give some roles more. For example, dailyRewards has a Multiplier permission and economyUtils has a Zombie kill reward override permission. Set the number on the role. See Roles and permissions.

Want another way to earn, like currency for playtime? Build your own module. See Modules.

How players spend currency

• In the shop. Players buy listings on the web storefront or in game. See Shop.
• On commands. Any command can have a cost. Set it when you configure the module, under System Config → commands. If a player can’t pay, the command doesn’t run and they get a chat message.
• With each other. economyUtils lets players send currency with /transfer.

Player commands from economyUtils

Command	What it does
/balance	Check your balance.
/topcurrency	The 10 players with the highest balance.
/transfer	Send currency to another player.
/confirmtransfer	Confirm a large transfer. Set the limit with Pending amount.
/shop	Browse the shop in game.
/claim	Claim your pending shop orders.
/grantcurrency	Create new currency for a player. Needs the Manage currency permission.
/revokecurrency	Remove currency from a player. Needs the Manage currency permission.

Your server may use another prefix than /. See Command Prefix in Settings.

Give or take currency by hand

1. Open your server, then Players.
2. Select one or more players.
3. Choose Add / Deduct Currency.
4. Pick Add or Deduct, enter the Amount, then choose Add currency or Deduct currency.

For one player, you can also use the row menu on that player.

The change only affects the balance on that server. The action is greyed out when the economy is off for the server.

See balances

• One player: open their profile and the Economy tab. It shows their balance on each server.
• All players on a server: the server’s Players list has a currency column.
• Over time: your server’s Statistics page shows a currency chart. Analytics → Players shows Currency flow: how much was added and deducted. See Analytics.

Every change creates a currency-added or currency-deducted event, with a reason when the module gives one. Find them in Events.