Skip to content
Aithor Dev

Admin Guide

On this page

Admin Guide

Day-to-day operation of NationCore.

Permissions

Grant nation.admin to your staff. It unlocks every /nc admin command and bypasses in-game authority checks throughout the plugin β€” see Permissions.

Reloading

Text
/nc admin reload

reloads:

  • config.yml
  • language.yml
  • All four nations/*.yaml files
  • order.yaml
  • research.yml
  • The GUI layer
  • The live-map settings

For live-map template changes, also run:

Text
/nc admin map reload

A reload never touches data/. Nations, treasuries and player records are untouched by configuration changes.

Everyday tasks

Give a nation money

Text
/nc admin treasury give Avalon 500000
/nc admin treasury take Avalon 100000
/nc admin treasury set  Avalon 0

Nation names with spaces work β€” the parser resolves them automatically.

Replace a head of state

Text
/nc admin set leader Avalon Steve
/nc confirm

The old leader is demoted to citizen; the new leader is added to the nation if they were not already a member. Run from the console, it executes immediately without the confirmation step.

Remove a president

Text
/nc admin remove president

Clear a player's tax problem

Text
/nc admin invoice remove Steve

Settles all of their active invoices.

Give a nation a research level

Text
/nc admin research set Avalon mining_luck_i 5
/nc admin research reset Avalon

Populate a small nation

Text
/nc admin npc invite Avalon Bertrand
/nc admin npc role Avalon Bertrand OFFICER
/nc admin npc list Avalon
/nc admin npc kick Avalon Bertrand

Set a nation announcement

Text
/nc admin set announcement Avalon The gates open at dawn.

Check the live map

Text
/nc admin map status
/nc admin map refresh

Balancing a fresh server

A suggested first pass:

Setting Where Consider
Founding cost nations/*.yaml β†’ creation.cost Lower on a small or new server
Starting treasury creation.starting-treasury-percent 100 makes founding effectively free in net terms; lower it to make the fee bite
Chunk claim cost config.yml β†’ nation.territory.claim-cost The main land-grab brake
Invoice amount Fixed at $50 per cycle in code Turn invoicing off per nation from its Settings menu if it is too harsh
Tax phase comunist.yaml β†’ communist.tax-amount Affects Communist, Monarchy and Caliphate
Order cost / cooldown order.yaml The main pacing lever for big effects
Research cost / time research.yml Scaling values let you stretch progression without editing every level
Election timings republic.yaml β†’ election.* 14 days end-to-end by default; shorten for a fast server

Monitoring

Watch the console for these prefixes:

Prefix Meaning
[FactoryTax] A routed factory tax payment, or a deposit failure
[ApartmentTax] The same, for apartments
[LandPermit] Permits filed, approved, denied, consumed, or requests refused
Tax billing cycle #N completed A daily billing summary

Enable or disable each audit log with the log key in its config.yml block.

Before an upgrade

  1. Stop the server.
  2. Back up plugins/NationCore/data/.
  3. Back up your edited config files.
  4. Replace the jar.
  5. Start the server and read the console.

New message keys fall back to their English defaults, so an older language.yml never breaks.

Safety notes

  • Disbanding is permanent. There is no undo. Invoices issued by a dissolved nation are voided automatically.
  • Treasury set is absolute. It does not log an income or expense entry the way give and take do.
  • nation.admin is powerful. It lets a holder reshape any nation's territory, disband any nation and approve any permit.
  • Do not edit data/ while the server runs. In-memory state overwrites it.

Search documentation

    Type to start searching.