EssentialsC - Economy

Overview

EssentialsC ships a full virtual economy system with per-player balances stored in SQLite (economy.db). Running a network? The MySQL expansion syncs balances between servers. 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 and the balance leaderboard. Balances can never go below zero - payments and withdrawals that would overdraw an account are refused - and an optional max balance cap applies to every deposit. Admins can run /eco on every online player at once with the @everyone (or *) target.

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` or `*` as the player to target everyone online - this works for `take`, `set` and `reset` too.	`essentialsc.eco.give`
`/eco take <player> <amount>`	Take money from a player.	`essentialsc.eco.take`
`/eco set <player> <amount>`	Set a player's balance to an exact amount.	`essentialsc.eco.set`
`/eco reset <player>`	Reset a player's balance to the starting amount.	`essentialsc.eco.reset`
`/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.enabled`	Boolean	`true`	Disable the economy system and unregister the Vault provider.
`economy.starting-balance`	Double	`100.00`	Balance given to new players on their first join.
`economy.currency-space`	Boolean	`false`	Put a space between the currency name and the amount.
`economy.currency-before-amount`	Boolean	`true`	Place the currency name before the amount.
`economy.currency.singular`	String	`$`	Currency name when the amount is exactly 1.
`economy.currency.plural`	String	`$`	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 allowed in any transaction (`/pay`, `/eco give`, etc.).
`economy.max-balance`	Double	`-1`	Maximum balance a player can hold. Set to `-1` for no limit.

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.

If you have another economy plugin registered with Vault (such as CMI or a dedicated economy plugin), remove it or disable its Vault hook to avoid conflicts. Only one Vault economy provider can be active at a time.

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`	Admin economy management.	Operators
`essentialsc.eco.give`	Allow giving money to players.	Operators
`essentialsc.eco.take`	Allow taking money from players.	Operators
`essentialsc.eco.set`	Allow setting player balances.	Operators
`essentialsc.eco.reset`	Allow resetting player balances.	Operators
`essentialsc.eco.everyone`	Allow using `@everyone` for mass operations.	Operators
`essentialsc.baltop`	View the balance leaderboard.	Everyone
`essentialsc.baltop.exempt`	Hide the player from the baltop list.	Nobody