Introduction
On this page
NationCore is designed to sit at the centre of a server's plugin ecosystem. It talks to other plugins in three ways.
| Plugin | Why |
|---|---|
| Vault | Every money movement goes through Vault. NationCore disables itself on startup if Vault or an economy provider is missing. |
These are declared in plugin.yml as softdepend, so NationCore loads after them
when they are present, and runs fine when they are not.
| Plugin | What it adds | Page |
|---|---|---|
| PlaceholderAPI | ~90 %nation_...% placeholders |
PlaceholderAPI |
| squaremap | Live web map of nation borders and capitals | squaremap |
These call into NationCore through the public API. They do not need to be on the classpath at build time β the API is built only from JDK and Bukkit types so partner plugins can bind to it reflectively.
| Plugin | What it does | Page |
|---|---|---|
| FactoryCore | Routes factory taxes into the owning nation's treasury, and asks permission before building on national soil | FactoryCore |
| ApartmentCore | The same, for apartments | ApartmentCore |
| Anything else | Territory lookups, tax routing and land permits | Developer API |
Every cross-plugin money or land integration requires both sides to enable it.
NationCore has its own switch in config.yml, and the partner plugin has a
matching one. Nothing moves until both are on.
This is deliberate: neither server operator can be surprised by money appearing in a treasury or a build being blocked because the other plugin was updated.
# NationCore side
integration:
factory-tax:
enabled: true
apartment-tax:
enabled: true
land-permit:
enabled: true# Partner plugin side
integration:
nation-tax:
enabled: true
nation-land-permit:
enabled: trueAll policy lives on the side that owns the resource:
- Money policy (share percentage, per-payment cap, audit logging) lives in NationCore, because NationCore owns the treasury.
- Land policy (who may build, rate limits, expiry, exemptions) lives in NationCore, because NationCore owns the territory.
A partner plugin that is outdated, buggy or hostile therefore cannot move more money than the operator authorised, and cannot grant itself territory.
The public API never throws and never returns null where a value is expected.
If NationCore is mid-disable or not yet fully initialised, calls degrade to
"no nation / nothing routed" rather than failing. Keeping that contract frozen is
what lets the plugins version independently.