Using it

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
  • symbol and color are used by economy.amount-format (%color%%symbol% %amount% %name%).
  • starting-balance is what a new player starts with.
  • paying controls /coinshop pay and /<currency> pay. tax-percentage is charged on top of the amount: the sender pays the amount plus the tax, and the receiver gets the full amount.
  • command creates 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.

Top lists

/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):

  • /coins or /coins balance [player] shows a balance.
  • /coins pay <player> <amount> sends currency.
  • /coins top shows the richest players (size from economy.top-size).
  • /coins withdraw <amount> turns currency into a voucher item.
  • /coins give|take|set <player> <amount> and /coins reset <player> are admin commands (need coinshop.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].