Economy¶

Configured in economy.yml. Commands: /balance, /pay, /eco.

Balances¶

Every player has a balance, starting at 100 (starting-balance). A player who never earns costs no storage: nothing is written until their balance changes.

/balance              # yours (aliases /bal, /money)
/balance <player>     # someone else's
/pay <player> 250     # send money

/pay sends 1 at least (pay.minimum-amount), and can be turned off on its own (pay.enabled).
maximum-balance caps an account (0 = no ceiling). A credit that would cross it is refused rather than clamped, so money is never silently destroyed.
Amounts are shown with the currency symbol — $1,234.50 — or named, 1 dollar, 2 dollars (currency).

Shop¶

Money comes in by selling and goes out by buying, at the shop — signs at spawn, the /shop menu, or both, as the server chooses (shop.mode). A server with its own shop plugin switches this one off (shop.enabled: false), and /shop is then the other plugin's.

A sign, placed by staff: a right click trades one lot; sneaking, a stack's worth (buying) or everything you hold (selling).
```
[Sell]
16
Diamond
400
```
The menu (/shop): shelves — ores, combat, the Archer's leather and every dye, potions, food, building, utility, farming — and in each, left click buys, right click sells, sneak for more.

Only plain items are counted and taken: a renamed or enchanted stack is never sold by mistake. Staff write a shop sign with hcfcore.economy.shop.admin.

Bounties¶

/bounty <player> <amount> puts money on a player's head — taken from your balance at once — and whoever kills them collects all of it. Bounties on one player add up, and survive a restart. /bounty lists the largest, /bounty check <player> shows one. A teammate or an ally of the target cannot collect it: the bounty waits for somebody who will actually fight for it.

Kill reward¶

A kill pays the killer 10 (kill-reward.amount) — the unit the rest of the economy is priced on, and, if the server sets steal-percent, a share of the dead player's balance too. Killing an ally pays nothing, and the same victim pays nothing again for 5 minutes — two accounts trading kills earn one reward, not a salary.

Team banks¶

A team has a balance of its own: /team deposit <amount|all> (every member) and /team withdraw <amount|all> (the leader). See Teams.

Staff¶

/eco give <player> <amount>
/eco take <player> <amount>
/eco set <player> <amount>

Aliases /economy; needs hcfcore.economy.admin. The player is told about the change — a balance that changes silently reads as a bug.

Safety¶

Every change is atomic: two withdrawals at the same moment cannot spend the same money twice, and the total amount of money is conserved — checked by load tests with dozens of threads.

Balances are stored as decimal numbers (double), the type Vault's own interface uses: anything else would mean converting on every call and losing the same precision at the boundary.

Vault¶

With Vault installed, shops, crates, paid ranks and any Vault-aware plugin read and change the same balances as /balance and /pay — with exactly the same ceiling and refusals. Team banks are not exposed to Vault, and there are no per-world balances. See Integrations.

Switching it off¶

enabled: false disables balances, /pay, /eco and the team bank commands, and Vault then reports the economy as disabled.