Nations
On this page
A nation is the central object in NationCore. Everything else — land, money, politics, research — belongs to one.
| 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. |
See Founding Your First Nation for the player
walkthrough. In short, createNation runs these checks in order:
- The name is valid (3–24 characters, letters/numbers/spaces).
- The name is not already taken.
- The founder is not already in a nation.
- The chunk the founder stands in is unclaimed.
- The founder can afford the founding cost.
- 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.
| 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. |
/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.
/nc nation # your own nation
/nc nation <name> # any nation by namePrints the nation's type, leader, member count, treasury balance and capital chunk.
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.