Skip to content
Aithor Dev

Troubleshoot

On this page

Troubleshooting

The plugin will not start

Vault not found! Disabling plugin...

NationCore needs Vault and a registered economy provider.

  1. Install Vault.
  2. Install an economy plugin (EssentialsX Economy, CMI, …).
  3. Confirm with /vault-info or your economy plugin's own status command.

Vault alone is not enough β€” it is only an adapter.

The plugin does not appear in /plugins

  • 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 ClassNotFoundException or an unsupported class version error tells you which of the two is wrong.

Commands

/nc says "Unknown command"

The plugin did not load. See above.

A subcommand from an old guide does not work

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.

"This command is for players only!"

You ran a player-context command from the console. Menus, /nc create, /nc capital, /nc map and /nc permit all need a player.

Nations

"Nation name is already taken"

Names are unique server-wide. Pick another, or check with /nc nation <name>.

"You are already in a nation"

A player can only belong to one nation. Use /nc leave first.

"The chunk you are standing on is already claimed"

You must found a nation on unclaimed ground β€” the chunk you stand in becomes the capital. Move further out.

"You need at least $X to establish a nation"

Lower creation.cost in the relevant nations/*.yaml, or give the player money.

Territory

"You can only claim chunks that border your existing territory"

Claims must be orthogonally adjacent to land you already own. Walk to a chunk touching your border.

"Your nation must establish a capital before expanding"

Claim the capital first: /nc capital claim.

"Capital relocation is on cooldown"

Default 24 hours. Change it:

YAML
nation:
  territory:
    capital-relocate-cooldown-hours: 24

Claim costs come from the wrong place

That is intentional. Territory costs come from the leader's Vault balance; the capital claim cost comes from the nation treasury.

Taxes

Players complain about constant bills

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").

A player cannot get out of national debt

National debt is permanent until paid. The state seizes any balance they hold, on join and every minute. To clear it manually:

Text
/nc admin invoice remove <player>

Tax is being charged twice

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.

Changing Communist tax also changed Monarchy tax

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

The election never starts

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

Nobody can register

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

Registration ended with no candidates

During a founding term the first president continues. Otherwise the registration phase restarts.

A candidate wants their fee back

Registration fees are non-refundable by design. Every candidate's fee is forfeit into the state treasury when the election concludes.

Executive orders

An order is missing from the menu

  1. Check order.yaml β€” is status: false?
  2. Check the government's executive_order list in nations/*.yaml β€” is the id listed under that office?

An order disabled globally never appears, regardless of the office list.

The King has no cooldown

Correct. The Monarchy is deliberately exempt from executive-order cooldowns.

"Treasury cannot afford this order"

Default cost is 1,000,000 per national order. Lower cost in order.yaml or top up the treasury.

Land permits

Builds are blocked and nobody gets a prompt

  • Check integration.land-permit.enabled on the NationCore side.
  • Check the partner plugin's matching switch (integration.nation-land-permit.enabled).
  • Both must be on.

"The head of state is offline"

By design. Set require-leader-online: false to let requests queue instead.

Staff cannot build inside nations

Grant nation.landpermit.bypass, or add their role to the exempt block.

Requests are refused with AREA_TOO_LARGE

The footprint exceeds max-area-chunks (default 1024). Raise it only if you genuinely use huge regions.

Requests are refused with ASYNC

The partner plugin is calling the API off the main server thread. That is a bug on their side β€” NationCore refuses rather than racing.

Live map

Nothing appears on the map

  1. Is squaremap installed and running?
  2. Is integration.squaremap.enabled true?
  3. Is the world drawn? Check worlds.mode and worlds.list.
  4. Is the nation hidden? Check hidden-nations.
  5. Run /nc admin map status.

/nc map says no public URL

Set it:

YAML
integration:
  squaremap:
    web:
      public-url: "https://map.example.com"

Then /nc admin map reload.

Popups do not reflect my template edits

Run /nc admin map reload. Delete the file and reload to restore the default design.

Updates feel slow

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.

Integrations

Factory or apartment tax is not reaching treasuries

Both sides must be enabled:

YAML
# NationCore
integration:
  factory-tax:
    enabled: true
YAML
# FactoryCore
integration:
  nation-tax:
    enabled: true

Also check that the build actually sits on claimed land, and watch the console for [FactoryTax] lines with log: true.

Placeholders return nothing

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

Data

A nation disappeared

Check whether it was disbanded β€” that is permanent. Restore from a backup of plugins/NationCore/data/ if you have one.

Warnings like Failed to load nations data

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.

I edited a data file and my changes vanished

State is held in memory and overwritten on the next save. Always stop the server before editing data/.

Getting help

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.

Search documentation

    Type to start searching.