Vault
On this page
Vault is NationCore's economy bridge. It is the plugin's only hard dependency.
Almost every NationCore feature touches money:
- Founding a nation
- Claiming territory
- Paying tax invoices
- Salaries and stipends
- Executive orders and office decisions
- Research
- Election fees and voter rewards
- Recall deposits
- Arena rewards and penalties
If Vault is missing, or no economy provider is registered with Vault, NationCore
logs Vault not found! Disabling plugin... and disables itself during startup.
plugin.yml lists Vault under softdepend so load order is handled gracefully,
but in practice Vault is mandatory β the plugin refuses to run without it.
- Vault itself.
- An economy plugin that registers a Vault
Economyservice β EssentialsX Economy, CMI, or any other Vault-compatible economy.
Vault alone is not enough. It is only an adapter.
| Operation | Used for |
|---|---|
getBalance |
Requirement checks (founding cost, claim cost, election fee, recall deposit, vote weight bonus) |
has |
Auto-pay checks |
withdraw |
Fees, taxes, deposits, penalties |
deposit |
Salaries, rewards, refunds, stimulus payments |
format |
Rendering currency in messages |
Nation treasuries are not Vault accounts. They are stored inside NationCore's
own nations.json. Vault is only used for the player side of every transaction:
Player Vault balance ββββββββΆ Nation treasury (NationCore)
tax, fees, donations, salaries, rewardsThis means:
- A treasury balance cannot be manipulated by economy commands.
- Every treasury movement is recorded in the nation's own transaction log.
- Resetting a player's Vault balance does not touch any treasury.
| Symptom | Cause |
|---|---|
| Plugin disables on startup with "Vault not found" | Vault is missing, or no economy provider is registered |
| All costs appear to be zero | Your economy provider may not be reporting balances correctly |
| Money deducted but nothing happens | Check the console β treasury deposits log failures |