Skip to content
Aithor Dev

Nations

On this page

Nations

A nation is the central object in NationCore. Everything else — land, money, politics, research — belongs to one.

What a nation has

Property Description
Id A unique internal id (UUID string). Used in data files and admin commands.
Name 3–24 characters, letters, numbers and spaces. Must be unique on the server.
Tag A short 3-letter badge shown in menus and on the live map.
Government type Republic, Communist, Monarchy or Caliphate. Chosen at creation.
Leader The head of state. Exactly one player.
Members Every player in the nation, each with a role.
NPC members Optional admin-created fake members.
Capital One chunk, claimed at creation, that acts as the seat of government.
Territory The set of claimed chunks, including the capital.
Treasury The nation's own money pot with a full transaction log.
Welcome message Optional text shown to players entering the territory.
Map colour Optional custom colour on the live web map.
Tax switch Whether citizens are billed tax invoices.
Founded at Timestamp, shown in menus and on the map.

Creating a nation

See Founding Your First Nation for the player walkthrough. In short, createNation runs these checks in order:

  1. The name is valid (3–24 characters, letters/numbers/spaces).
  2. The name is not already taken.
  3. The founder is not already in a nation.
  4. The chunk the founder stands in is unclaimed.
  5. The founder can afford the founding cost.
  6. The founder meets the playtime requirement, if any.

Only then is the fee withdrawn and the nation created — the capital chunk is claimed automatically, the starting treasury is funded, and the founder becomes leader.

Joining and leaving

Action Who Effect
Join Any player without a nation Added as a CITIZEN.
Leave Any member except the leader Removed from the nation; player record cleared.
Leave (as leader) Leader Not allowed directly — the command warns that leaving disbands the nation, and asks for /nc confirm.
Kick Leader or admin Forcibly removes a member. The leader cannot be kicked.
Disband Leader or admin Destroys the nation permanently. Requires /nc confirm.

The Nation Hub

/nc hub opens a browser of every nation on the server, sorted by member count. Each entry shows the nation's name, government type, leader, member count and treasury state. From the hub a player can:

  • Open the menu of their own nation.
  • Start creating a new nation if they do not have one.
  • Refresh the list.

Nation information

Text
/nc nation             # your own nation
/nc nation <name>      # any nation by name

Prints the nation's type, leader, member count, treasury balance and capital chunk.

Deleting data safely

A nation lives entirely inside data/nations.json. Disbanding removes it from that file on the next save. Anything that referenced the nation degrades gracefully:

  • Tax invoices issued by a dissolved nation are voided — there is no treasury left to receive the money.
  • Land-use permits for that nation stop being actionable.
  • The live map removes its polygons on the next refresh.

Search documentation

    Type to start searching.