Skip to content

Economy

EssentialsLite provides player balances and payment commands when economy.enabled is true. The built-in currency is named Coin for one unit and Coins for multiple units. The default starting balance is 0.

Commands

Command Aliases Usage Permission Gate
/balance bal, money /balance [player] essentials.balance; another player requires essentials.balance.others economy.enabled
/pay epay /pay <player> [player2...] <amount> essentials.pay; multiple recipients require essentials.pay.multiple; receiving requires essentials.pay.receive economy.enabled
/balancetop baltop /balancetop [page] essentials.balancetop economy.enabled and baltop.enabled
/economy eco, econ /economy give <player\|@a\|*> <amount> [-s] or /economy <take\|set\|reset\|check> <player> [amount] [-s] essentials.eco and the matching essentials.eco.* permission economy.enabled
/eco economy, econ Same as /economy Same as /economy economy.enabled

essentials.balance is enabled by default for a player’s own balance; essentials.balance.others is operator-level by default. The economy administration nodes are essentials.eco.give, essentials.eco.take, essentials.eco.set, essentials.eco.reset, and essentials.eco.check; essentials.eco.* grants the administration group. essentials.pay and essentials.pay.receive are enabled by default, while essentials.pay.multiple is operator-level by default.

Examples:

/balance
/balance Alex
/pay Alex 12.50
/pay Alex Sam 5
/balancetop 2
/economy give Alex 100
/eco check Alex

Limits And Precision

Amounts must be at least 0.01 and no greater than 1000000000 (1e9). Use decimal amounts with a maximum practical precision of cents, for example 12.50. Invalid, negative, zero, or out-of-range amounts are rejected rather than silently adjusted.

Configuration

The relevant economy defaults are:

economy:
  enabled: true
  currency-name-plural: Coins
  currency-name-singular: Coin
  max-payment: 1000000000.0
  min-payment: 0.01
  save-interval-ticks: 200

  mysql-sync:
    enabled: true
    poll-interval-ticks: 1
    lock-ttl-ms: 2000
    max-events-per-poll: 500

mysql:
  enabled: false

The MySQL synchronization settings are enabled in the economy section by default, but storage itself is disabled by mysql.enabled: false. Do not enable synchronization as a substitute for configuring the MySQL connection. YAML remains the active persistence path with the defaults above.

Edge Cases And Interactions

  • Commands are unavailable while economy.enabled is false.
  • /balancetop also requires baltop.enabled.
  • /pay can name multiple recipients only with essentials.pay.multiple.
  • A target that cannot receive payments because receiving is disabled does not receive the payment; players can control payment reception with the essentials.settings.accept-payments setting.
  • @a and * are valid targets for the give administration operation. They are not valid for take, set, reset, or check.
  • Vault is optional. When present, it supports economy interoperability; EssentialsLite’s own balance provider remains available when economy is enabled.
  • PlaceholderAPI is optional for commands. With it installed, %essentials_balance% returns the player’s formatted balance, and %essentials_baltop_<position>_name% and %essentials_baltop_<position>_balance% expose leaderboard entries subject to baltop.placeholder-limit.