Skip to main content

How to make a Currency

Default configs​

The default configs can be found here.

How to add currencies​

EcoBits lets you make as many currencies as you want, and you make each one by adding a new entry to the currencies list. Simply add and remove currencies as you please.

Example Currency Config​

currencies:
    - id: crystals # The ID of the currency.
      name: "&bCrystals ❖" # The name of the currency.
      default: 0 # The default balance.
      max: -1 # The maximum balance, set to -1 if no max.
      payable: false # If players should be able to use /ecobits pay to pay other players
      decimal: true # If decimal amounts are allowed rather than just integer amounts
      vault: false # If this currency should be registered with vault
      local: false # If this currency should not sync between servers
      commands: # A list of commands dedicated to this currency (for easier paying, checking balance, etc)
          - crystals
          - ecocrystals

Understanding all the sections​

id: The ID of the currency. This is what you use in commands, [[prices]] and placeholders. ID's must be lowercase letters, numbers, and underscores only.

name: The name of the currency.

default: The default balance

max: The maximum balance, set to -1 if no max.

payable: If players should be able to use /ecobits pay to pay other players

decimal: If decimal amounts are allowed

vault: If this currency should be registered with Vault

local: If this currency should not sync between servers

commands: A list of commands for this currency (for paying, balance, etc.)

Using EcoBits currencies​

You can use your EcoBits anywhere within effects using the Price system. By setting your EcoBits currency as your Vault currency you can use your currency in other plugins too. Other plugins can also interact with EcoBits using the placeholders and commands.