Troubleshoot
On this page
NationCore needs Vault and a registered economy provider.
- Install Vault.
- Install an economy plugin (EssentialsX Economy, CMI, β¦).
- Confirm with
/vault-infoor your economy plugin's own status command.
Vault alone is not enough β it is only an adapter.
- Check the Java version. The jar requires Java 21.
- Check the server version. It is built against Paper 1.21.4.
- Read the startup log β a
ClassNotFoundExceptionor an unsupported class version error tells you which of the two is wrong.
The plugin did not load. See above.
Several features moved from commands into menus. The registered subcommands are:
menu, gui, help, info, status, stats, admin, hub, create,
nation, leave, disband, confirm, capital, diplomacy, diplo,
permit, permits, map, livemap.
Treasury, tax, recall, elections, orders, arena and research are all reached
through /nc menu. Some older chat hints still mention /nc recall, /nc order
or /nc arena β those texts are stale; use the menus.
You ran a player-context command from the console. Menus, /nc create,
/nc capital, /nc map and /nc permit all need a player.
Names are unique server-wide. Pick another, or check with /nc nation <name>.
A player can only belong to one nation. Use /nc leave first.
You must found a nation on unclaimed ground β the chunk you stand in becomes the capital. Move further out.
Lower creation.cost in the relevant nations/*.yaml, or give the player money.
Claims must be orthogonally adjacent to land you already own. Walk to a chunk touching your border.
Claim the capital first: /nc capital claim.
Default 24 hours. Change it:
nation:
territory:
capital-relocate-cooldown-hours: 24That is intentional. Territory costs come from the leader's Vault balance; the capital claim cost comes from the nation treasury.
The invoice system bills every active member once a day. A nation can turn it off from its Settings menu ("Toggle Tax System" / "Toggle Zakah System").
National debt is permanent until paid. The state seizes any balance they hold, on join and every minute. To clear it manually:
/nc admin invoice remove <player>That is two different systems, both working as designed:
- The invoice system bills every nation, every government type, once a day.
- Communist / Monarchy / Caliphate nations also run their own tax phase.
To remove one, disable invoicing for that nation in its Settings menu, or set
communist.tax-amount: 0 in comunist.yaml.
Also intentional. Monarchy and Caliphate read their tax phase, amount, food
distribution and weekly stipend from nations/comunist.yaml. There is no
separate setting.
- Elections are Republic-only.
- The first one starts 7 days after founding.
- Later ones start 5 days before a term ends, or immediately with no president.
Check the term length in republic.yaml β president.term-length-days.
Registration has strict requirements. Check president.requirements in
republic.yaml β level 100, 100 hours playtime, 500,000 balance, 10 endorsements
and a 30-day clean record by default. Also check election.registration-fee
(500,000).
During a founding term the first president continues. Otherwise the registration phase restarts.
Registration fees are non-refundable by design. Every candidate's fee is forfeit into the state treasury when the election concludes.
- Check
order.yamlβ isstatus: false? - Check the government's
executive_orderlist innations/*.yamlβ is the id listed under that office?
An order disabled globally never appears, regardless of the office list.
Correct. The Monarchy is deliberately exempt from executive-order cooldowns.
Default cost is 1,000,000 per national order. Lower cost in order.yaml or top
up the treasury.
- Check
integration.land-permit.enabledon the NationCore side. - Check the partner plugin's matching switch
(
integration.nation-land-permit.enabled). - Both must be on.
By design. Set require-leader-online: false to let requests queue instead.
Grant nation.landpermit.bypass, or add their role to the exempt block.
The footprint exceeds max-area-chunks (default 1024). Raise it only if you
genuinely use huge regions.
The partner plugin is calling the API off the main server thread. That is a bug on their side β NationCore refuses rather than racing.
- Is squaremap installed and running?
- Is
integration.squaremap.enabledtrue? - Is the world drawn? Check
worlds.modeandworlds.list. - Is the nation hidden? Check
hidden-nations. - Run
/nc admin map status.
Set it:
integration:
squaremap:
web:
public-url: "https://map.example.com"Then /nc admin map reload.
Run /nc admin map reload. Delete the file and reload to restore the default
design.
squaremap itself publishes marker changes every 5 seconds by default
(map.markers.update-interval-seconds in squaremap's own config). NationCore
cannot push faster than that.
Both sides must be enabled:
# NationCore
integration:
factory-tax:
enabled: true# FactoryCore
integration:
nation-tax:
enabled: trueAlso check that the build actually sits on claimed land, and watch the console
for [FactoryTax] lines with log: true.
- Is PlaceholderAPI installed? The console logs
PlaceholderAPI found! Registered placeholders.at startup. - Is the identifier right? It is
nation, so%nation_president%. - Player-specific placeholders need a player context.
Check whether it was disbanded β that is permanent. Restore from a backup of
plugins/NationCore/data/ if you have one.
A data file is malformed. The plugin falls back to empty data rather than crashing, which means that file's contents were lost. Stop the server and restore from backup.
State is held in memory and overwritten on the next save. Always stop the server
before editing data/.
When reporting a problem, include:
- The plugin version (
/version NationCore). - Your server version and Java version.
- The full console output from startup.
- The relevant section of your config file.
- The exact command or action that failed, and the message you received.