Currencies
Currencies are defined under economy in config.yml. You can add as many as you like. Each built-in currency gets its own command as soon as you set command and run /mccs reload.
economy:
default-currency: coins
# How amounts look in messages and lore.
amount-format: "%color%%symbol% %amount% %name%"
# Number of players in /coins top.
top-size: 10
# Lets players turn currency into a voucher item with /coins withdraw <amount>.
player-vouchers: true
# Add as many currencies as you like. Each one gets its own command right away.
# Copy a block, change the id and the command, then run /mccs reload.
currencies:
coins:
enabled: true
display-name: "Coins"
symbol: "⛁"
color: "&6"
starting-balance: 100
command: "coins"
paying:
enabled: true
min-amount: 1
tax-percentage: 0
symbolandcolorare used byeconomy.amount-format(%color%%symbol% %amount% %name%).starting-balanceis what a new player starts with.payingcontrols/coinshop payand/<currency> pay.tax-percentageis charged on top of the amount: the sender pays the amount plus the tax, and the receiver gets the full amount.commandcreates a command such as/coins. Leave it blank for no command.
Add a currency#
Copy one block under economy.currencies, change the id and the command, then run /mccs reload. In an item, use that id in price.currency. You can also create, edit and delete currencies in game from /mccs then Currencies: name, symbol, color, command, starting balance, payment rules and the default currency. Changes go live with no restart.
Vault and PlayerPoints#
# Charge any Vault economy. Use "currency: vault" in an item's price.
vault:
enabled: true
display-name: "Money"
symbol: "$"
color: "&a"
command: ""
paying:
enabled: false
min-amount: 1
tax-percentage: 0
# Charge PlayerPoints. Use "currency: playerpoints" in an item's price.
playerpoints:
enabled: true
display-name: "Points"
symbol: "⚡"
color: "&e"
command: ""
paying:
enabled: false
min-amount: 1
tax-percentage: 0
Use currency: vault (or money) or currency: playerpoints (or points) in an item's price to charge those plugins. They need Vault with an economy plugin, or PlayerPoints, to be installed. Give them a command to get a balance command for them, and set paying.enabled: true to allow payments with the same tax rules.
/coins top only works for built-in currencies. For Vault and PlayerPoints use the economy plugin's own top list.
Currency commands#
Each currency command works like this (replace coins with the command you set):
/coinsor/coins balance [player]shows a balance./coins pay <player> <amount>sends currency./coins topshows the richest players (size fromeconomy.top-size)./coins withdraw <amount>turns currency into a voucher item./coins give|take|set <player> <amount>and/coins reset <player>are admin commands (needcoinshop.admin).
Vouchers#
Players with coinshop.voucher can turn currency into an item with /coins withdraw <amount>, when economy.player-vouchers is on. Right-clicking redeems it. Each voucher works once, so copies are worthless. Admins can hand one out with /mccs voucher <player> <amount> [currency].