Operational Error Dictionary
Reason Codes & Fixes
Search reason codes to see what they mean and what to do next.
Tick
2 codesTICK_OVERVIEW
PermalinkConstruction, market settlements, and war actions resolve when the world tick runs.
Next step: Use tick recap and outcomes to confirm what changed this tick.
Learn more: Progression timing explainer
LOCK_HELD
PermalinkA world tick is already running, so this action is temporarily blocked.
Next step: Wait a moment, then retry.
Market
8 codesQuantityTooLow
PermalinkOrder quantity is below the minimum allowed for this world.
Next step: Increase quantity and submit again.
PriceTooLow
PermalinkOrder price is below the allowed minimum band.
Next step: Raise the price into the current market limits.
PriceTooHigh
PermalinkOrder price is above the allowed maximum band.
Next step: Lower the price into the current market limits.
TooManyOpenOrders
PermalinkYou have reached the open-order cap.
Next step: Cancel one or more open orders, then try again.
OrdersPerTickLimit
PermalinkYou have hit the per-tick order submit limit.
Next step: Wait for the next tick before placing more orders.
PingPongCooldown
PermalinkRapid buy/sell flipping on the same resource is on cooldown.
Next step: Wait for cooldown or use a different resource.
InsufficientResource
PermalinkYou do not have enough of this resource to place a sell order.
Next step: Reduce quantity or choose another resource.
InsufficientCash
PermalinkYou do not have enough cash for this buy order.
Next step: Reduce quantity or price, or increase your cash before retrying.
War
21 codesOFFENSIVE_SLOTS_EXHAUSTED
PermalinkYour nation has no available offensive war slots.
Next step: End or peace an active offensive war before declaring another.
DEFENDER_NEWBIE_PROTECTED
PermalinkTarget nation is under newbie protection.
Next step: Choose a different target.
DEFENDER_POST_WAR_PROTECTED
PermalinkTarget nation has temporary post-war protection.
Next step: Choose a different target or wait for protection to expire.
DECLARE_RANGE_EXCEEDED
PermalinkTarget is outside your valid war declare range.
Next step: Pick a closer target.
ACTIVE_PAIR_EXISTS
PermalinkAn active war already exists between these two nations.
Next step: Open the existing war instead of redeclaring.
WAR_NOT_FOUND
PermalinkThe referenced war could not be found.
Next step: Return to war control and choose an active war.
WAR_ENDED
PermalinkThis war has ended and cannot accept attacks.
Next step: View recap or declare a new war.
WAR_INACTIVE_EXPIRED
PermalinkThis war auto-expired after low activity in the rolling WDP window.
Next step: Declare a new war when you are ready to sustain activity.
NATION_NOT_PARTICIPANT
PermalinkYour selected nation is not a participant in this war.
Next step: Switch to a participant nation.
ATTACK_TYPE_NOT_UNLOCKED
PermalinkThe chosen attack type is not unlocked for the acting nation.
Next step: Use an unlocked attack type or research prerequisites.
ATTACK_REJECTED
PermalinkServer-side combat validation rejected the attack input.
Next step: Review attack requirements and retry with valid inputs.
NUKE_DAILY_CAP_REACHED
PermalinkThis nation has already used its nuke launch for the current tick-day.
Next step: Wait until the next tick-day reset before launching another nuke.
WAR_GAMES_STRATEGIC_ATTACK_DISABLED
PermalinkWar games disable strategic attacks.
Next step: Use a standard war to launch missiles or nukes.
MISSILE_COMMAND_REQUIRED
PermalinkMissile launch requires an active Missile Command structure.
Next step: Build and complete Missile Command Tier 1+.
MISSILE_TECH_PREREQ_MISSING
PermalinkMissile Engineering prerequisites are missing.
Next step: Research T16 Missile Engineering I.
MISSILE_STOCKPILE_CAP_EXCEEDED
PermalinkCurrent missile stockpile is above allowed cap for Missile Command tier.
Next step: Spend missiles or upgrade Missile Command to raise cap.
NUKE_ERA_PREREQ_MISSING
PermalinkNuke launch is blocked below Nation era.
Next step: Advance nation era to Nation or higher.
NUKE_TECH_PREREQ_MISSING
PermalinkNuke launch requires both Nuclear Physics and Delivery Systems technologies.
Next step: Research T26 Nuclear Physics and T27 Delivery Systems I.
NUKE_WONDER_PREREQ_MISSING
PermalinkNuke launch requires Nuclear Program wonder.
Next step: Build and complete W05 Nuclear Program.
NUKE_MISSILE_COMMAND_TIER_REQUIRED
PermalinkNuke launch requires Missile Command Tier 2 or higher.
Next step: Upgrade Missile Command to Tier 2+.
NUKE_STOCKPILE_CAP_EXCEEDED
PermalinkCurrent nuke stockpile is above the hard cap.
Next step: Spend nukes to return at or below cap 3.
Construction
10 codesMaxCostExceeded
PermalinkThis construction action exceeds your max-cost safety threshold.
Next step: Reduce build size or increase max-cost setting.
BUILDER_QUEUE_LIMIT_REACHED
PermalinkThe selected builder slot queue is full.
Next step: Wait for queued items to complete or use another slot.
BuilderQueueLimitReached
PermalinkLegacy casing for builder queue limit reached.
Next step: Treat this as BUILDER_QUEUE_LIMIT_REACHED and open build queue.
NO_IMPROVEMENT_SLOTS
PermalinkNo free improvement slots are available.
Next step: Add infrastructure capacity or remove an existing improvement.
NoImprovementSlots
PermalinkLegacy casing for no free improvement slots.
Next step: Treat this as NO_IMPROVEMENT_SLOTS.
IMPROVEMENT_SLOTS_FULL
PermalinkThe targeted improvement slot is already full.
Next step: Choose a different slot or remove queued work.
ImprovementSlotsFull
PermalinkLegacy casing for improvement slot full.
Next step: Treat this as IMPROVEMENT_SLOTS_FULL.
STRUCTURE_NOT_FOUND
PermalinkThe requested improvement/wonder instance could not be found for this nation.
Next step: Refresh construction data and select a valid structure row.
STRUCTURE_NOT_DAMAGED
PermalinkRepairs can only be queued for structures below full integrity.
Next step: Pick a structure with integrity below 100%.
REPAIR_ALREADY_QUEUED
PermalinkA repair job is already active or pending for that structure.
Next step: Wait for the existing repair queue item to complete.
Research
8 codesResearchAlreadyQueued
PermalinkA research project is already queued for this nation.
Next step: Wait for completion or cancel current research.
AlreadyAcquired
PermalinkThis technology has already been acquired.
Next step: Choose a different technology.
UnknownTechNode
PermalinkThe requested tech node is not recognized.
Next step: Refresh and retry from a valid tech node.
MissingPrereq
PermalinkA prerequisite technology is missing (often returned as MissingPrereq:<NODE>).
Next step: Research the prerequisite node first.
Learn more: Era and progression gates
PROJECT_KEY_INVALID
PermalinkThe submitted project key does not match a configured progression era project.
Next step: Submit funding from a valid project card/key.
Learn more: Labor funding and era projects
PROJECT_NOT_FOUND
PermalinkNo matching nation project exists for the provided project key.
Next step: Refresh project state and retry from the active project list.
Learn more: Labor funding and era projects
PROJECT_NOT_ACTIVE
PermalinkOnly active projects can be funded. Completed/cancelled projects are not fundable.
Next step: Fund your currently active era project instead.
Learn more: Labor funding and era projects
INSUFFICIENT_LABOR
PermalinkYou do not have enough labor to start the selected project builder.
Next step: Wait for labor regen ticks, then retry.
Learn more: Labor funding and era projects
Auth
9 codesAUTH_REQUIRED
PermalinkYou must be signed in to perform this action.
Next step: Sign in and retry.
AUTH_LOGIN_LOCKED
PermalinkToo many failed login attempts were detected for this account.
Next step: Wait for the lock window to expire, then retry with correct credentials.
ACCOUNT_SUSPENDED
PermalinkThis account is temporarily suspended by an administrator.
Next step: Contact support/admin for a suspension review.
ACCOUNT_BANNED
PermalinkThis account has been banned by an administrator.
Next step: Contact support/admin if you believe this was an error.
FORBIDDEN
PermalinkYour account does not have access to perform this action.
Next step: Switch to a valid nation/account context.
NATION_OWNERSHIP_REQUIRED
PermalinkYou do not own the nation required for this action.
Next step: Select your owned nation and retry.
NATION_NOT_FOUND
PermalinkThe specified nation was not found in this world context.
Next step: Return to nations and choose a valid target.
NationNotFound
PermalinkLegacy casing for nation not found.
Next step: Treat this as NATION_NOT_FOUND.
WORLD_NOT_FOUND
PermalinkThe referenced world could not be loaded.
Next step: Return to nations and reopen your world.