Economy

Voxy includes a multi-currency economy system. You can create as many currencies as you need, designate one as the primary Vault currency, and manage player balances via commands or the GUI.

Currencies

Each currency has a unique identifier. The default setup includes a coins currency.

Managing currencies

Command	Permission	Description
`/currencies`	`voxy.admin`	Open the currency management GUI

Managing balances

Command	Aliases	Description
`/currency give <currency> <player> <amount>`	`add`	Give currency to a player
`/currency take <currency> <player> <amount>`	`remove`	Remove currency from a player
`/currency set <currency> <player> <amount>`	-	Set exact balance
`/currency randomgive <currency> <player> <min> <max>`	`randomadd`	Give a random amount within a range
`/currency help [page]`	-	Show the command help pages

So /currency add ... behaves the same as /currency give ..., /currency remove ... as take, and /currency randomadd ... as randomgive.

All currency commands require voxy.admin.

Primary Currency and Vault

One currency is designated as the primary currency for Vault. Configure this in economy.yml:

# Register Voxy as the Vault economy provider
register-as-eco: false
# The currency ID to expose via Vault
primary-currency: coins

Set register-as-eco: true if you want plugins that integrate with Vault (shop plugins, job plugins, etc.) to use Voxy's economy.

Vault must be installed for register-as-eco to have any effect. Voxy checks for Vault on startup and registers automatically if the option is enabled.

Rewards Integration

Currencies are usable as reward actions. See Rewards for details on setting up currency-based rewards.