Economy
Balance management, player payments, admin economy controls, and leaderboards.
Overview
EssentialsC ships a full virtual economy system with per-player balances stored in SQLite. It registers itself as a Vault economy provider so any plugin that reads balances through Vault will automatically use EssentialsC's economy.
The economy tracks player balances, transaction history, and top balances. It supports negative balances, a configurable max balance cap, and mass admin operations via the @everyone wildcard.
Commands
| Command | Description | Permission |
|---|---|---|
/balance [player] |
Check your own balance or another player's balance. | essentialsc.balance / .others |
/pay <player> <amount> |
Send money to another player. | essentialsc.pay |
/eco give <player> <amount> |
Give money to a player (use @everyone for all online players). |
essentialsc.eco |
/eco take <player> <amount> |
Take money from a player. | essentialsc.eco |
/eco set <player> <amount> |
Set a player's balance to an exact amount. | essentialsc.eco |
/eco reset <player> |
Reset a player's balance to the starting amount. | essentialsc.eco |
/baltop [page] |
View the balance leaderboard, paginated. | essentialsc.baltop |
Configuration
Economy settings live under the economy section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
economy.starting-balance |
Double | 100.0 |
Balance given to new players on their first join. |
economy.currency-singular |
String | Dollar |
Currency name when the amount is exactly 1. |
economy.currency-plural |
String | Dollars |
Currency name for all other amounts. |
economy.format |
String | #,##0.00 |
Decimal format pattern for balance display. |
economy.minimum-transaction |
Double | 0.01 |
Smallest amount that can be sent with /pay. |
economy.max-balance |
Double | 999999999.99 |
Hard cap on how much a player can hold. |
Vault Integration
When Vault is present on the server, EssentialsC automatically registers itself as the economy provider. Any plugin that reads balances through Vault - chest shops, auction plugins, buy/signs, etc. - will use EssentialsC's economy without any additional configuration.
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.balance |
Check your own balance. | Everyone |
essentialsc.balance.others |
Check another player's balance. | Operators |
essentialsc.pay |
Send money to other players. | Everyone |
essentialsc.eco |
Admin economy commands - give, take, set, reset. | Operators |
essentialsc.baltop |
View the balance leaderboard. | Everyone |