Warring NationsWarring Nations MC 1.21.1.NEOFORGE.JAVA 21
Wiki/Reference/Commands: Core

Commands: Core

Every top-level command the base Warring Nations mod registers: every subcommand, its arguments, and the permission it requires. This covers the core mod only, not the Siege, Discord, or BlueMap addons.

PLAYERSSERVER ADMINS
At a glance

The core mod registers 230 leaf commands across 15 player roots and 13 admin roots. Every root is documented in full below, with worked examples on the most-used ones.

How commands work

Warring Nations registers every command as its own top-level root (/nation, /war, /claim, and so on). There is no single /wn mega-command by default. If a server operator enables the commandNamespacePrefixEnabled config option, every root on this page becomes reachable only as /wn <root> ... (e.g. /wn nation create, /wn war declare) - a single global toggle applied uniformly to all roots, not a special admin-only grouping. This page writes every command without the optional prefix; mentally prepend wn to all of them if your server has the toggle on. See configuration reference for that and related config keys.

Nation permission

An in-fiction, per-nation, delegable permission (the NationPermission enum, e.g. MANAGE_SETTINGS, DECLARE_WAR) that a nation's own leadership grants to its custom roles. Checked against the acting player's role inside their own nation. The nation's leader always passes every nation-permission check.

Server permission

An out-of-fiction, server-operator-tier permission node (the WnPermission enum, node warringnations.<path>) checked via NeoForge's PermissionAPI (LuckPerms, etc). Defaults to op level for admin capabilities, or wide open (ALL) for the handful of player actions that carry one. With no permission plugin installed, op-level nodes behave like today's op check and ALL nodes are open to everyone.

Where a command checks both, the server permission gates whether the command may be attempted at all, and the nation permission then gates whether the acting player's in-nation role allows it.

i
Warn then confirm. Several destructive commands use a two-step pattern: running the command once shows a warning and does nothing; a second invocation of the sibling ... confirm leaf (within 30 seconds) actually performs the action. The confirm leaf has no permission check of its own - it inherits whatever permission was already checked on the first invocation.
i
Feature-gated subtrees. Some command roots and subtrees only exist when a server enables the matching feature flag: capital (/nation capital), bounty (/bounty), village (/village), rebellion (/rebellion), and koth (/koth, admin-only). These are noted per section below.

/nation

Bare /nation shows your nation's info (or help, if you're in none). This is the largest command root: everything from founding and membership to roles, regions, treasury, and diplomacy.

Player commands

SubcommandArgumentsDescriptionPermission
nation help-Show command help-
nation create <name>name: greedy stringFound a new nationServer: NATION_CREATE (ALL by default); also gated by playerCreationEnabled / requireLinkedAccountForNationCreation / requireNationApproval config
nation disband / disband confirm-Disband your own nation (warn+confirm)Must be leader
nation rename <name>name: greedy stringRename your nationNation: MANAGE_SETTINGS; may require parent approval if subordinate (SubordinationGate)
nation invite <player>player: wordInvite a player to your nationNation: INVITE_MEMBERS
nation accept [nation]nation: greedy string (optional)Accept a pending nation inviteMust be invited
nation decline [nation]nation: greedy string (optional)Decline a pending inviteMust be invited
nation invites-List your pending invites-
nation kick <player>player: wordRemove a member from your nationNation: KICK_MEMBERS; cannot kick the leader or anyone who outranks you
nation promote <player>player: wordPromote a memberNation: PROMOTE_MEMBERS
nation demote <player>player: wordDemote a memberNation: PROMOTE_MEMBERS
nation transfer <player> / transfer confirmplayer: wordTransfer leadership (warn+confirm)Must be leader
nation leader list (also bare nation leader)-List leader/co-leaders-
nation leader add <player>player: wordGrant co-leader statusMust be leader
nation leader remove <player>player: wordRevoke co-leader statusMust be leader
nation abdicate-Leader steps downMust be leader
nation leave-Leave your nation (auto-disbands if you're a solo leader)Must be a member
nation info [nation]nation: greedy string (optional)Show a nation's info (yours, or named)-
nation list-List all nations-
nation top [metric]metric: word, suggested power/claims/level/members/wars (optional)Leaderboard-
nation roster [nation]nation: greedy string (optional)Show a nation's member roster-
nation relations-Show your nation's diplomatic relations-
nation politics-Show internal politics/government summary-
nation history [nation]nation: greedy string (optional)Show a nation's event history-
nation log-Show your nation's action log-
nation apply <nation>nation: greedy stringApply to join a nation-
nation applyanswer <input>input: greedy stringAnswer a nation's join-application questions-
nation applyquestions [questions]questions: greedy string (optional)View/set your nation's application questionsNation: MANAGE_APPLICANTS (when setting)
nation unapply <nation>nation: greedy stringWithdraw a pending application-
nation join <nation>nation: greedy stringJoin a nation directly (open-join policy)-
nation setjoin <policy>policy: word, suggested from NationJoinPolicySet nation join policyNation: MANAGE_SETTINGS
nation allybuild <on|off>toggle: wordToggle whether allies can build on your claimsNation: MANAGE_SETTINGS
nation warvote <on|off>toggle: wordToggle requiring a member vote before declaring warNation: MANAGE_SETTINGS
nation applicants-List pending join applicantsNation: MANAGE_APPLICANTS
nation recruit <player>player: wordApprove a join applicationNation: MANAGE_APPLICANTS
nation reject <player>player: wordReject a join applicationNation: MANAGE_APPLICANTS
nation msg <message>message: greedy stringSend a message to your nation's internal chat channel-
nation chatmute <on|off>toggle: wordMute/unmute the nation chat channel for yourself-
nation color <hex>hex: wordSet nation colorNation: MANAGE_SETTINGS
nation banner / banner clear-Open the banner editor GUI / clear custom bannerNation: MANAGE_SETTINGS; may require parent approval on submission (SubordinationGate)
nation tag <tag> / tag cleartag: wordSet/clear a short nation tagNation: MANAGE_SETTINGS
nation leadertitle <title> / leadertitle cleartitle: greedy stringSet/clear a custom title for the leader roleNation: MANAGE_SETTINGS
nation region list (also bare nation region)-List your nation's named regions-
nation region info <name>name: wordShow a region's info-
nation region create <name>name: wordCreate a named regionNation: MANAGE_SETTINGS
nation region delete <name>name: wordDelete a regionNation: MANAGE_SETTINGS
nation region rename <name> <newName>name: word, newName: wordRename a regionNation: MANAGE_SETTINGS
nation region addclaim <name>name: wordAdd your current claim to a regionNation: MANAGE_SETTINGS
nation region removeclaim <name>name: wordRemove your current claim from a regionNation: MANAGE_SETTINGS
nation region delegate <name> <player>name: word, player: wordDelegate management of a region to a playerNation: MANAGE_SETTINGS
nation region undelegate <name> <player>name: word, player: wordRemove a region delegateNation: MANAGE_SETTINGS
nation description <text>text: greedy stringSet nation descriptionNation: MANAGE_SETTINGS
nation motd <text> / motd cleartext: greedy stringSet/clear nation MOTDNation: SET_MOTD
nation treasury deposit <amount>amount: long ≥1Deposit currency into nation treasury- (any member, via economy bridge)
nation treasury withdraw <amount>amount: long ≥1Withdraw currency from nation treasuryNation: ACCESS_ADMIN_CHEST
nation role list (also bare nation role)-List your nation's custom roles-
nation role create <name>name: wordCreate a custom roleNation: MANAGE_ROLES
nation role rename <role> <newname>role: word, newname: wordRename a roleNation: MANAGE_ROLES
nation role delete <role> [reassignTo] / role delete confirmrole: word, reassignTo: word (optional)Delete a role, optionally reassigning its members (warn+confirm)Nation: MANAGE_ROLES
nation role grant <role> <permission>role: word, permission: word (a NationPermission name)Grant a permission to a roleNation: MANAGE_ROLES; capped by "can't grant more than you hold"
nation role revoke <role> <permission>role: word, permission: wordRevoke a permission from a roleNation: MANAGE_ROLES
nation role moveup <role> / role movedown <role>role: wordReorder a role's rankNation: MANAGE_ROLES
nation role assign <player> <role> [minutes]player: word, role: word, minutes: int ≥1 (optional, temp assignment)Assign a role to a member, optionally time-limitedNation: MANAGE_ROLES; outrank + grant-ceiling checks apply
nation role color <role> <hex>role: word, hex: wordSet a role's display colorNation: MANAGE_ROLES
nation role setparent <role> <parent>role: word, parent: wordSet a role's parent (rank inheritance)Nation: MANAGE_ROLES
nation role supreme <role> <true|false>role: word, value: boolMark a role "supreme" (leader-equivalent)Nation: MANAGE_ROLES
nation role grantcustom <role> <permission>role: word, permission: word (addon-defined custom permission id)Grant a custom (addon-registered) permissionNation: MANAGE_ROLES
nation role revokecustom <role> <permission>role: word, permission: wordRevoke a custom permissionNation: MANAGE_ROLES
nation home set-Set your nation's home teleport pointNation: SET_HOME
nation home go-Teleport to your nation's home-
nation home clear-Clear the home point- (implementation-level SET_HOME gate)
nation colony found <name> / colony found confirmname: greedy stringFound a colony nation off your own (warn+confirm)Must be leader
nation ally request <nation>nation: greedy stringRequest an allianceNation: MANAGE_DIPLOMACY (sovereign-only for request)
nation ally accept <nation>nation: greedy stringAccept a pending alliance requestNation: MANAGE_DIPLOMACY
nation ally decline <nation>nation: greedy stringDecline an alliance requestNation: MANAGE_DIPLOMACY
nation ally revoke <nation>nation: greedy stringEnd an existing allianceNation: MANAGE_DIPLOMACY
nation ally requests-List pending alliance requests-
nation nap request <nation>nation: greedy stringRequest a non-aggression pactNation: MANAGE_DIPLOMACY (sovereign-only)
nation nap accept <nation>nation: greedy stringAccept a pending NAP requestNation: MANAGE_DIPLOMACY
nation nap decline <nation>nation: greedy stringDecline a NAP requestNation: MANAGE_DIPLOMACY
nation nap revoke <nation>nation: greedy stringEnd an existing NAPNation: MANAGE_DIPLOMACY
nation enemy <nation>nation: greedy stringDeclare another nation an enemy (relation state, not war)Nation: MANAGE_DIPLOMACY (sovereign-only)
nation neutral <nation>nation: greedy stringSet relation with another nation to neutralNation: MANAGE_DIPLOMACY

/nation capital, only if the capital feature is enabled

SubcommandArgumentsDescriptionPermission
nation capital (bare) / capital info [nation]nation: greedy string (optional)Show a nation's capital info-
nation capital help-Show help-
nation capital set <name>name: greedy stringSet your nation's capital at your current claimNation: MANAGE_CAPITAL
nation capital rename <name>name: greedy stringRename the capitalNation: MANAGE_CAPITAL
nation capital clear-Clear the capital designationNation: MANAGE_CAPITAL

Admin commands (attach onto the same /nation root)

SubcommandArgumentsDescriptionPermission
nation delete <nation> / delete confirmnation: stringDelete a nation outrightServer: ADMIN_NATION_DELETE
nation setcolor <nation> <hex>nation: string, hex: wordForce-set a nation's colorServer: ADMIN_NATION_EDIT
nation addmember <nation> <player>nation: string, player: wordForce-add a memberServer: ADMIN_NATION_MEMBERS
nation removemember <nation> <player>nation: string, player: wordForce-remove a memberServer: ADMIN_NATION_MEMBERS
nation settier <nation> <tier>nation: string, tier: wordForce-set nation tierServer: ADMIN_NATION_EDIT
nation setleader <nation> <player>nation: string, player: wordForce-install a leaderServer: ADMIN_NATION_MEMBERS
nation coleader add <nation> <player>nation: string, player: wordForce-grant co-leaderServer: ADMIN_NATION_MEMBERS
nation coleader remove <nation> <player>nation: string, player: wordForce-revoke co-leaderServer: ADMIN_NATION_MEMBERS
nation rename <nation> <newname> (admin form)nation: string, newname: wordForce-rename a nationServer: ADMIN_NATION_EDIT
nation setclaims <nation> <bonus>nation: string, bonus: int ≥0Set bonus claim slotsServer: ADMIN_NATION_CLAIMS
nation treasury set <nation> <amount>nation: string, amount: long ≥0Force-set treasury balanceServer: ADMIN_NATION_TREASURY
nation treasury add <nation> <amount>nation: string, amount: longAdjust treasury balanceServer: ADMIN_NATION_TREASURY
nation treasury bindtreasury <nation> <providerId> <accountId>nation: string, providerId: word, accountId: stringBind an external treasury provider accountServer: ADMIN_NATION_TREASURY
nation treasury unbindtreasury <nation>nation: stringUnbind external treasuryServer: ADMIN_NATION_TREASURY
nation approve <player>player: wordApprove a pending nation-creation requestServer: ADMIN_NATION_CREATE
nation deny <player> [reason]player: word, reason: greedy string (optional)Deny a pending nation-creation requestServer: ADMIN_NATION_CREATE
nation pending-List pending nation-creation requestsServer: ADMIN_NATION_CREATE
nation setmotd <nation> <text>nation: string, text: greedy stringForce-set a nation's MOTDServer: ADMIN_NATION_EDIT
nation setdescription <nation> <text>nation: string, text: greedy stringForce-set descriptionServer: ADMIN_NATION_EDIT
nation settag <nation> <tag>nation: string, tag: wordForce-set tagServer: ADMIN_NATION_EDIT
nation cleartag <nation>nation: stringClear tagServer: ADMIN_NATION_EDIT
nation setjoinpolicy <nation> <policy>nation: string, policy: wordForce-set join policyServer: ADMIN_NATION_EDIT
nation adopt <party>party: greedy stringAdopt an existing FTB team as a nationServer: ADMIN_NATION_CREATE
nation create <nationname> <player> (admin form)nationname: string, player: wordAdmin-forced nation creationServer: ADMIN_NATION_CREATE

nation list and nation info are not duplicated by the admin file - the player-facing versions above are already console-safe.

Examples

/nation create Ironhold
/nation invite Steve
/nation accept Ironhold
/nation role create Officer
/nation role assign Steve Officer 60
/nation ally request Ashenreach

/bloc

Multi-nation alliance blocs.

SubcommandArgumentsDescriptionPermission
bloc (bare) / bloc help-Show help-
bloc create <name>name: greedy stringCreate a blocNation: MANAGE_DIPLOMACY (sovereign-only)
bloc invite <nation>nation: greedy stringInvite a nation to your blocNation: MANAGE_DIPLOMACY
bloc accept <bloc>bloc: greedy stringAccept a bloc inviteNation: MANAGE_DIPLOMACY (sovereign-only)
bloc decline <bloc>bloc: greedy stringDecline a bloc inviteNation: MANAGE_DIPLOMACY
bloc leave-Leave your blocNation: MANAGE_DIPLOMACY
bloc kick <nation>nation: greedy stringRemove a nation from your blocNation: MANAGE_DIPLOMACY
bloc disband / disband confirm-Disband a bloc you lead (warn+confirm)Nation: MANAGE_DIPLOMACY
bloc info-Show your bloc's info-
bloc invites-List pending bloc invites-
bloc list-List all blocs-

/bounty, only if the bounty feature is enabled

Post and claim bounties on players.

SubcommandArgumentsDescriptionPermission
bounty (bare) / bounty help-Show help-
bounty post <player> <amount>player: word, amount: long ≥1Post a bounty on a player (requires economy enabled)Nation: ACCESS_ADMIN_CHEST
bounty cancel <player>player: wordCancel a bounty you postedNation: ACCESS_ADMIN_CHEST
bounty list-List all bounties-
bounty list <player>player: wordList bounties on one player-

/claim and /unclaim

Bare /claim claims the chunk you're standing in; bare /unclaim unclaims the chunk you're standing in.

SubcommandArgumentsDescriptionPermission
claim (bare)-Claim the current chunk for your nationNation: CLAIM_LAND (+ claim cap); Server: CLAIM (ALL by default)
claim help-Show help-
claim grant <player>player: wordGrant an outsider build access to the current chunkNation: MANAGE_CLAIM_ACCESS
claim revoke <player>player: wordRevoke a previously granted accessNation: MANAGE_CLAIM_ACCESS
claim grants-List access grants on the current chunk-
claim grants all-List every access grant nation-wide-
unclaim (bare)-Unclaim the chunk you're standing inNation: UNCLAIM_LAND

Examples

/claim
/claim grant Steve
/claim grants
/claim grants all
/unclaim

Admin commands

SubcommandArgumentsDescriptionPermission
claim <nation> (admin form, same literal as bare)nation: stringForce-claim the current chunk for <nation>Server: ADMIN_CLAIM
claim at <dim> <cx> <cz> <nation>dim: dimension, cx: int, cz: int, nation: stringForce-claim a specific chunk by coordinatesServer: ADMIN_CLAIM
claim list <nation>nation: stringList a nation's claimsServer: ADMIN_CLAIM
claim clearall <nation> / clearall confirmnation: stringClear every claim a nation owns (warn+confirm)Server: ADMIN_CLAIM
unclaim op-Force-unclaim the current chunk regardless of ownerServer: ADMIN_CLAIM
unclaim op at <dim> <cx> <cz>dim: dimension, cx: int, cz: intForce-unclaim a specific chunk by coordinatesServer: ADMIN_CLAIM

Protection and force-loading

Four one-liner roots: /protect, /unprotect, /forceload, and /unforceload all act on the chunk you're currently standing in.

SubcommandArgumentsDescriptionPermission
protect (bare)-Flag the current chunk as protected infrastructureNation: CLAIM_LAND
unprotect (bare)-Remove the protected-infrastructure flag from the current chunkNation: CLAIM_LAND
forceload (bare)-Force-load the current chunk (keeps ticking with no players nearby)Nation: FORCE_LOAD_CHUNKS
unforceload (bare)-Remove a force-load on the current chunkNation: FORCE_LOAD_CHUNKS

/pvp

Personal and nation-wide PvP opt-out controls.

SubcommandArgumentsDescriptionPermission
pvp (bare) / pvp help-Show help-
pvp opt-out-Personally opt out of PvP-
pvp opt-in-Personally opt back into PvP-
pvp nation opt-out-Opt your whole nation out of PvP (e.g. wars can't target it)Nation: DECLARE_WAR
pvp nation opt-in-Opt your whole nation back into PvPNation: DECLARE_WAR

Staff chat

/helpop pages online staff and only registers if SEF's own /helpop is not installed. /adminchat broadcasts to staff and only registers if SEF integration is not installed.

SubcommandArgumentsDescriptionPermission
helpop <message>message: greedy stringPage every online staff member holding the admin-chat permissionServer: ADMIN_CHAT (paged recipients)
adminchat <message>message: greedy stringBroadcast to every online staff member holding admin-chat permissionServer: ADMIN_CHAT

/village, only if the village feature is enabled

A village is a settlement tier independent of nations - its own root, not under /nation.

SubcommandArgumentsDescriptionPermission
village (bare) / village info [village]village: greedy string (optional)Show village info-
village help-Show help-
village create <name>name: greedy stringFound a village-
village claim-Claim the current chunk for the village-
village unclaim-Unclaim the current chunk from the village-
village list-List all villages-
village join <village>village: greedy stringJoin a village-
village leave-Leave your village-
village rename <name>name: greedy stringRename your village-
village setleader <player> / setleader confirmplayer: wordTransfer village leadership (warn+confirm)-
village affiliate-Affiliate the village with a nation-
village standalone-Make the village standalone (unaffiliate)-
village siege-Show/trigger village siege status-
village delete / delete confirm-Delete the village (warn+confirm)-
village upgrade / upgrade confirm-Upgrade the village tier (warn+confirm)-
!
Permissions not fully traced. The exact per-leaf role gates for /village were not confirmed at the NationPermission/WnPermission level during extraction from source. The command file gates these mostly via village-leadership checks internal to the village siege service rather than the two enums documented elsewhere on this page. Treat mutating leaves as "village leader only" unless verified further.

/rebellion, only if the rebellion feature is enabled

Internal nation rebellions get their own root so a rebelling member isn't forced through their own nation's command namespace.

SubcommandArgumentsDescriptionPermission
rebellion (bare) / rebellion info-Show rebellion status-
rebellion help-Show help-
rebellion create-Start a rebellion movement-
rebellion join-Join an existing rebellion in your nation-
rebellion abandon-Abandon your participation in a rebellion-
rebellion start <name> / start confirmname: greedy stringStart the rebellion vote/process (warn+confirm)-

/war

Declaring, fighting, negotiating, and ending wars. Many of these gameplay gates interact directly with a nation's chosen war preset.

SubcommandArgumentsDescriptionPermission
war (bare) / war help-Show help-
war declare <nation> / declare confirmnation: greedy stringDeclare war on a nation (warn+confirm)Nation: DECLARE_WAR (sovereign-only on the initial call); many gameplay gates apply: curfew, ally/NAP/pvp-optout, size parity, concurrent-war cap, min claims, treasury cost, optional war vote
war declare-as <warTypeId> <nation> / declare-as confirmwarTypeId: word (suggested from registered war presets), nation: greedy stringDeclare a war using a specific composable war presetNation: DECLARE_WAR (sovereign-only)
war reinforce <ally> <opponent> / reinforce confirmally: string, opponent: greedy stringJoin an ally's ongoing war via your own linked declarationNation: DECLARE_WAR (sovereign-only)
war vote yes / vote no-Cast your vote in your nation's pending war-declaration vote-
war vote status-Show your nation's current war-vote status-
war breach-Spend treasury to instantly breach a siege's wall ringNation: DECLARE_WAR
war status-Show your nation's current war status-
war active-List active wars-
war history-Show war history-
war stats [player]player: word (optional)Show war statistics (yours, or a player's)-
war bet <backedNation> <opponentNation> <amount>backedNation: string, opponentNation: string, amount: long ≥1Place a bet on a war outcome- (requires economy enabled)
war bets <nationA> <nationB>nationA: string, nationB: greedy stringList bets on a war between two nations-
war propose-peace <nation>nation: greedy stringPropose white peace to an enemyNation: DECLARE_WAR
war accept-peace-Accept a pending peace proposalNation: DECLARE_WAR
war decline-peace-Decline a pending peace proposalNation: DECLARE_WAR
war surrender <nation> / surrender confirmnation: greedy stringSurrender a war (warn+confirm)Nation: DECLARE_WAR
war propose-terms white <nation>nation: greedy stringPropose white-peace termsNation: DECLARE_WAR
war propose-terms <cede> <reparations> <tribute> <vassalize> <dmz> <nation>cede/reparations/tribute/dmz: int 0-100, vassalize: bool, nation: greedy stringPropose full negotiated peace termsNation: DECLARE_WAR
war counter-terms white <nation>nation: greedy stringCounter with white-peace termsNation: DECLARE_WAR
war counter-terms <cede> <reparations> <tribute> <vassalize> <dmz> <nation>same as propose-termsCounter a pending terms offerNation: DECLARE_WAR
war ultimatum <cede> <reparations> <tribute> <vassalize> <dmz> <nation>same shapeIssue a take-it-or-leave-it terms ultimatumNation: DECLARE_WAR
war mediate white <beneficiary> <other>beneficiary: string, other: greedy stringMediate a white peace between two other nationsNation: DECLARE_WAR (on the mediator's own nation)
war mediate <cede> <reparations> <tribute> <vassalize> <dmz> <beneficiary> <other>cede/reparations/tribute/dmz: int 0-100, vassalize: bool, beneficiary: string, other: greedy stringMediate full terms between two other nationsNation: DECLARE_WAR
war accept-terms-Accept the currently pending terms offerNation: DECLARE_WAR
war decline-terms-Decline the currently pending terms offerNation: DECLARE_WAR
war terms-Show the currently pending terms offer-
war end <nation>nation: greedy stringForce-end a warServer: ADMIN_WAR

Admin commands

SubcommandArgumentsDescriptionPermission
war list-List all warsServer: ADMIN_WAR
war setscore <attacker> <score>attacker: word, score: int ≥0Force-set a war's scoreServer: ADMIN_WAR
war approve <attacker>attacker: greedy stringApprove a pending war declarationServer: ADMIN_WAR
war deny <attacker>attacker: greedy stringDeny a pending war declarationServer: ADMIN_WAR
war forcewin <nation>nation: greedy stringForce a nation to win its warServer: ADMIN_WAR
war reload-Reload the composable war-preset registry from diskServer: ADMIN_WAR_TYPES
war types-List registered war presetsServer: ADMIN_WAR_TYPES

war end is the one player-facing-shaped leaf gated directly by a server permission (ADMIN_WAR) rather than a nation permission - registered inline in the main command file, not merged from the admin file.

Examples

/war declare Ashenreach
/war declare confirm
/war status
/war propose-peace Ashenreach
/war bet Ironhold Ashenreach 500

/gov

The government-framework subtree: entities, memberships, proposals/votes, and procedure hooks. The id argument used throughout is a government-entity id (UUID), tab-suggested from the caller's own nation's entities.

SubcommandArgumentsDescriptionPermission
gov (bare) / gov help-Show help-
gov entity <id>id: wordShow one entity's info-
gov entities [nation]nation: greedy string (optional)List a nation's (or your own) government entities-
gov members <id>id: wordList an entity's members-
gov children <id>id: wordList an entity's child entities-
gov create <kind> <name> [parent]kind: word, name: string, parent: word (optional)Create a government entityNation: MANAGE_GOVERNMENT
gov remove <id>id: wordRemove a government entityNation: MANAGE_GOVERNMENT
gov grant player <id> <role> <player> [term-minutes]id: word, role: word, player: word, term-minutes: int ≥1 (optional)Grant a player membership/role in an entity, optionally time-limitedNation: MANAGE_GOVERNMENT
gov grant nation <id> <role> <nation> / ... for <term-minutes> <nation>id: word, role: word, nation: greedy string, term-minutes: int ≥1 (optional)Grant a nation-level membership/role, optionally time-limitedNation: MANAGE_GOVERNMENT
gov revoke player <id> <role> <player>id: word, role: word, player: wordRevoke a player's membership/roleNation: MANAGE_GOVERNMENT
gov revoke nation <id> <role> <nation>id: word, role: word, nation: greedy stringRevoke a nation's membership/roleNation: MANAGE_GOVERNMENT
gov open <id> <kind> <minutes>id: word, kind: word, minutes: int ≥1Open a new proposal/vote in an entity-
gov vote <id> <choice>id: word, choice: greedy stringCast a vote on an open proposal- (some paths check MANAGE_GOVERNMENT)
gov status <id> [policy]id: word, policy: word (optional)Show entity/proposal status-
gov resolve <id> <outcome>id: word, outcome: greedy stringResolve an open proposal-
gov cancel <id>id: wordCancel an open proposal-
gov procedure <id> <hook>id: word, hook: wordRun a defined procedure hook-
gov procedure-define <id> <hook> <script>id: word, hook: word, script: greedy stringDefine a procedure script for a hookNation: MANAGE_GOVERNMENT
gov procedure-remove <id>id: wordRemove a defined procedureNation: MANAGE_GOVERNMENT
gov my-procedures-List procedures defined for your nation-

Admin commands

SubcommandArgumentsDescriptionPermission
gov reload-Rescan and reload gov-procedure definitions from diskServer: ADMIN_GOV
gov procedures-List all registered gov proceduresServer: ADMIN_GOV
gov seed-usa-Seed a synthetic USA-scale federal government structure (demo/test)Server: ADMIN_GOV

/preset

Mixed-audience root: the root itself is open to everyone, read/browse leaves are unrestricted, applying to your own nation needs the PRESET_APPLY server permission, and library management or force-applying to other nations needs ADMIN_PRESETS.

SubcommandArgumentsDescriptionPermission
preset list [collection]collection: word (optional, suggested)List presets, optionally filtered by collection-
preset search <query>query: greedy stringSearch presets-
preset info <id>id: word (suggested)Show a preset's info-
preset preview <id>id: word (suggested)Preview a preset-
preset compare <id1> <id2>id1: word, id2: word (suggested)Compare two presets-
preset apply <id> / apply <id> confirmid: word (suggested)Apply a preset to your own nation (warn+confirm)Server: PRESET_APPLY (ALL by default)
preset undo [nation]nation: string (optional)Undo the last preset applicationServer: PRESET_APPLY
preset reload-Reload the preset library from diskServer: ADMIN_PRESETS
preset validate-Validate the preset libraryServer: ADMIN_PRESETS
preset duplicate <id> <newId>id: word, newId: wordDuplicate a preset into an editable variantServer: ADMIN_PRESETS
preset export <nation> <newId>nation: string, newId: wordExport a live nation as a new presetServer: ADMIN_PRESETS
preset forceapply <id> <nation> / ... confirmid: word, nation: stringApply a preset to any nation, not just your own (warn+confirm)Server: ADMIN_PRESETS
preset states-List state templates available under your nation's applied presetServer: PRESET_APPLY
preset state <name> create / ... confirmname: string (suggested)Found a state from a preset state-template (warn+confirm)Server: PRESET_APPLY

Standalone admin-only commands

None of these have a player-facing counterpart - each is its own bare root registered by the admin command file. All still respect the global /wn prefix toggle described above.

/banner

SubcommandArgumentsDescriptionPermission
banner (root gate)--Server: ADMIN_BANNER
banner approve <nation>nation: stringApprove a nation's pending custom bannerServer: ADMIN_BANNER
banner deny <nation>nation: stringDeny a pending custom bannerServer: ADMIN_BANNER
banner clear <nation>nation: stringClear a nation's bannerServer: ADMIN_BANNER

/inactive and /purgeinactive

SubcommandArgumentsDescriptionPermission
inactive-List nations inactive 30+ days (default)Server: ADMIN_INACTIVE
inactive <days>days: int ≥1List nations inactive at least the given number of daysServer: ADMIN_INACTIVE
purgeinactive <days> / purgeinactive confirmdays: int ≥1Disband every nation inactive at least the given number of days (warn+confirm)Server: ADMIN_INACTIVE

/diplomacy, /player, /stats, /features

SubcommandArgumentsDescriptionPermission
diplomacy clear <nation>nation: stringReset every relation involving a nation to neutralServer: ADMIN_DIPLOMACY
player info <player>player: wordShow a player's nation membership + last-seen summaryServer: ADMIN_PLAYER
stats-Server-wide nation/war/claim summaryServer: ADMIN_STATS
stats help-Full admin command referenceServer: ADMIN_STATS
features / features list-Report every feature-flag-gated system and its current stateServer: ADMIN_STATS

/config and /reload

Config keys these commands touch are documented in full at Configuration: Core.

SubcommandArgumentsDescriptionPermission
config check-Re-run the boot-time config-consistency check liveServer: ADMIN_CONFIG
config get <path>path: word (suggested)Read one config valueServer: ADMIN_CONFIG
config set <path> <value>path: word, value: greedy stringWrite a config value liveServer: ADMIN_CONFIG
config list-List all configServer: ADMIN_CONFIG
config list <section>section: wordList config under one sectionServer: ADMIN_CONFIG
reload-Reload WN config + war-preset definitions from diskServer: ADMIN_RELOAD

/season

SubcommandArgumentsDescriptionPermission
season wipe / wipe confirm-Run a seasonal wipe (warn+confirm)Server: ADMIN_SEASON
season status-Report season statusServer: ADMIN_SEASON

/koth, only if the koth feature is enabled

SubcommandArgumentsDescriptionPermission
koth create <id> <intervalTicks> <durationTicks>id: word, intervalTicks: int ≥1, durationTicks: int ≥1Create a KOTH siteServer: ADMIN_KOTH
koth delete <id>id: word (suggested)Delete a KOTH siteServer: ADMIN_KOTH
koth list-List KOTH sitesServer: ADMIN_KOTH