Skip to content
Aithor Dev

Commands

On this page

Commands

NationCore registers one command with four names:

Text
/nationcore   (aliases: /nc, /nation, /gov)

Every example below uses /nc for brevity. All four work identically.

NationCore is menu-first. Most features β€” treasury, tax, elections, recall, research, arena, member management β€” are reached through /nc menu, not through dedicated commands.

Player commands

Command Description Permission
/nc Shows the help page β€”
/nc help Shows the help page β€”
/nc menu / /nc gui Opens your nation's main menu β€”
/nc hub Opens the Nation Hub (browse all nations) β€”
/nc info / /nc status Government status: leader, term, time remaining β€”
/nc stats [player] Statistics: playtime, level, votes, endorsements, offices held, arena record β€”
/nc nation [name] Nation information β€” yours, or any nation by name β€”
/nc create [type] [name] Found a nation. With no arguments, opens the government picker β€”
/nc leave Leave your nation. Leaders are warned that this disbands it β€”
/nc disband Disband your nation (leader or admin) β€”
/nc confirm Confirm a pending leave, disband or admin action β€”

Capital

Command Description
/nc capital / /nc capital info Capital world, position and chunk
/nc capital claim Claim the capital at your position (leader only)
/nc capital tp / /nc capital spawn Teleport to your capital

Diplomacy

Command Description
/nc diplomacy Show diplomacy help and the list of statuses
/nc diplomacy propose <nation> <status> Propose PEACE, ALLIANCE, TRUCE or WAR
/nc diplomacy accept <nation> Accept a pending proposal
/nc diplomacy reject <nation> Reject a pending proposal

/nc diplo is an alias. Only the head of state β€” and, in Republic and Communist nations, the Minister of Defense β€” may use these.

Land-use permits

Command Description
/nc permit list Your applications, plus your nation's pending queue if you are the leader
/nc permit info <id> Full details of one application
/nc permit approve <id> Approve (leader only). Alias: accept
/nc permit deny <id> Reject (leader only). Alias: reject

/nc permits is an alias. Only available when the land-permit integration is enabled.

Live map

Command Description Permission
/nc map Clickable link opening your nation's capital on the web map nation.map
/nc map here Clickable link opening your current position nation.map
/nc map color <#RRGGBB|name|reset> Set your nation's map colour (head of state) nation.map.color
/nc map help Map command usage nation.map

/nc livemap is an alias. Only available when squaremap is installed and the integration is active.

Admin commands

All of these require nation.admin (default: operators).

Command Description
/nc admin Shows the admin help page
/nc admin reload Reload config.yml, language.yml, the GUI layer and the live-map settings
/nc admin confirm Confirm a pending admin action

Leadership and announcements

Command Description
/nc admin set leader <nation> <player> Install a new head of state. Asks for /nc confirm when run by a player. The old leader is demoted to citizen; the new leader is added to the nation if they were not a member
/nc admin set announcement <nation> <message> Set a nation's announcement message
/nc admin remove president Remove the sitting president

Treasury

Command Description
/nc admin treasury give <nation> <amount> Add money to a nation's treasury
/nc admin treasury take <nation> <amount> Remove money (fails if the balance is too low)
/nc admin treasury set <nation> <amount> Set the balance exactly

Amounts must be whole, non-negative numbers. Nation names containing spaces are resolved automatically.

Tax invoices

Command Description
/nc admin invoice add <player> Issue a tax invoice to a player (they must be in a nation)
/nc admin invoice remove <player> Settle all active invoices for a player

NPC members

Command Description
/nc admin npc invite <nation> <name> Register a new NPC member
/nc admin npc kick <nation> <name> Remove an NPC member
/nc admin npc role <nation> <name> <CITIZEN|OFFICER> Change an NPC's role
/nc admin npc list <nation> List every NPC in a nation

Research

Command Description
/nc admin research set <nation> <research_id> <level> Set a research level. The level is validated against the configured maximum
/nc admin research reset <nation> Clear all research levels, cancel any active project and reset the counters

Research ids are the keys from research.yml, for example mining_luck_i.

Live map

Command Description
/nc admin map status Health and performance: squaremap version, mapped worlds, layers, rendered nations/markers/vertices, last render time, average scan time, public URL
/nc admin map reload Reload live-map settings and popup templates
/nc admin map refresh Force a full redraw

Tab completion

Tab completion is context-aware:

Position Suggestions
First argument menu, help, info, stats, hub, create, nation, leave, disband, confirm, capital, diplomacy, permit, map β€” plus admin for administrators
stats <tab> Online player names
create <tab> republic, communist
nation <tab> Every nation name
capital <tab> info, claim, tp, spawn
permit <tab> list, info, approve, deny
permit approve <tab> Only permit ids you are entitled to act on
map <tab> here, color, help
map color <tab> reset plus every named colour
admin <tab> set, remove, treasury, reload, confirm, npc, invoice, research, map
admin treasury <tab> give, take, set
admin npc <tab> invite, kick, role, list
admin invoice <tab> add, remove
admin research <tab> set, reset
admin map <tab> status, reload, refresh

Console

Most commands work from the console. Anything that needs a player context β€” menus, /nc create, /nc capital, /nc map, /nc permit β€” replies with This command is for players only!.

/nc admin set leader runs immediately from the console instead of asking for confirmation.

Search documentation

    Type to start searching.