Skip to content
Aithor Dev

Vault

On this page

Vault

Vault is NationCore's economy bridge. It is the plugin's only hard dependency.

Why it is required

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.

What you need

  1. Vault itself.
  2. An economy plugin that registers a Vault Economy service β€” EssentialsX Economy, CMI, or any other Vault-compatible economy.

Vault alone is not enough. It is only an adapter.

What NationCore does through Vault

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

Treasuries are separate

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:

Text
Player Vault balance  ◀──────▢  Nation treasury (NationCore)
       tax, fees, donations, salaries, rewards

This 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.

Common problems

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

Search documentation

    Type to start searching.