Rejection codes
A command the engine cannot accept comes back with a rejection: a structured refusal
carrying a dotted snake_case code, never an exception. Validation is a pure
pre-phase, so a rejected command consumes no randomness, no game time, and mutates
nothing — in-fiction failures are a normal outcome, not an error. See
Rejection and
CommandResult.
This page lists every rejection code the engine emits, grouped by namespace. Each command's own documentation lists the codes it can come back with.
battle.*
| Code | Meaning |
|---|---|
battle.declaration.back_stab_no_ability |
A character declares a back-stab, but their class has no back-stab ability. Only a class like the thief can back-stab. |
battle.declaration.back_stab_not_attack |
A character declares a back-stab on an action other than an attack. A back-stab is a way to make an attack, so the engine refuses it before it checks the action itself. |
battle.declaration.back_stab_not_melee |
A character declares a back-stab that would be a missile attack, with a missile weapon like a bow, or with a weapon like a dagger aimed at a group farther away than 5 feet. A back-stab is a strike from behind, so it has to be a melee attack. |
battle.declaration.back_stab_target_aware |
A character declares a back-stab in a round when the monsters can act. A back-stab needs an unaware opponent, which the engine reads as a monster the party surprised, so it's only possible in the free round the party gets by surprising the monsters. |
battle.declaration.cannot_move |
A character declares a move, alone or as the close before an attack, while dead, paralyzed, petrified, asleep, or entangled (such as by a web spell), any of which makes movement impossible this round. |
battle.declaration.cast_cannot_move |
A character declares a spell and sets a move in the same declaration. The OSE SRD says "The spell caster cannot move and cast a spell in the same round", so a cast can't set any move. |
battle.declaration.invisible_target |
A spell or item-use declaration names a specific target that is currently invisible, and the engine won't let the caster target something they can't see. |
battle.declaration.item_unusable |
The declared item can't do what the declaration asks. An attack named a wielded item with no weapon to swing, like a wand. Or a use_item named an item with no use in battle: a mundane item that isn't a splash weapon like holy water or a flask of oil, or a magic item of a category other than a potion, scroll, rod, staff, or wand. |
battle.declaration.member_out_of_reach |
In a battle, a character declares an action on another party member who stands more than 5 feet away on the range track, where the two will stand once the round's declared moves are made. Giving a potion to another member to drink, handing over an item, and touching a member with a staff of healing need the two within 5 feet of each other. The rejection has the acting character's id as character and the other member's id as target. Outside a battle, the party stands together, so every member reaches every other. |
battle.declaration.missing_move |
A move action is declared without specifying which kind of movement (closing distance, retreating, or a fighting withdrawal) the character is taking. |
battle.declaration.missing_spell |
A cast action is declared without specifying which spell to cast or which mode of that spell to use. |
battle.declaration.move_not_combinable |
A character sets a move on an action that can't take one. Only an attack takes a move, and only a close, so the character closes on the group and attacks it in the same round. A turn undead, an item use, a hand-over, or a hold can't set a move. An attack can't set a fighting withdrawal or a retreat, because a character who falls back makes no attack that round. |
battle.declaration.no_mirror |
A character declares the mirror gaze defense, fighting by watching a petrifying gazer in a mirror, without carrying a mirror from the equipment catalog. |
battle.declaration.no_target |
The chosen enemy group has no living, visible monster in its front rank that can currently be targeted. |
battle.declaration.not_in_front_rank |
A character declares a melee attack, a staff's strike for a charge, or a touch on a monster with a touch spell or a staff of healing, on a group they stand within 5 feet of, but they aren't in the party's front rank toward that group. The ranks toward a group are the living members sorted by their distance to it and cut into rows as wide as the space the party stands in allows. Members at the same distance stand in the order they got there, then in marching order, so the front row can be full before this character's turn comes. |
battle.declaration.replacement_unavailable |
A character who makes a fighting withdrawal or a retreat alone names a member to trade places with in the marching order, and the named member can't be named. The named member isn't another character declaring this round, makes a fighting withdrawal or a retreat of their own, or was already named by a character earlier in marching order. A declaration that names a member in a fighting withdrawal or a retreat the whole party makes gets this code too, because every member is moving with the party. |
battle.declaration.roster_mismatch |
The set of characters submitting declarations for the round doesn't exactly match the party members who are currently able to act and are expected to declare. |
battle.declaration.unknown_action |
The declaration's action type isn't one the engine recognizes as a legal move for the round (such as hold, move, attack, use_item, give_item, turn_undead, or cast). |
battle.declaration.unknown_group |
The declaration references a target group that doesn't exist in the current encounter, or that has already fled. |
battle.declaration.weapon_not_wielded |
An attack declaration names a weapon the character isn't currently wielding. |
battle.none_active |
The command tries to resolve a battle round, but no battle is currently in progress in the session. |
combat.*
| Code | Meaning |
|---|---|
combat.attack.attacker_blind |
The attacking combatant is blinded and cannot make an attack this round. |
combat.attack.attacker_incapacitated |
The attacking combatant is dead, petrified, paralysed, asleep, or weakened, and therefore cannot make an attack. |
combat.attack.out_of_range |
The target is farther away than the attacking missile weapon's longest range band. In a battle, the distance is the attacking character's own distance to the group, after any close the same declaration makes. |
combat.attack.out_of_reach |
The attacker declared a melee attack, or a melee-range magic item effect, against a target or group more than 5 feet away. In a battle, the distance is the attacking character's own distance to the group, after any close the same declaration makes, so a character who can't reach the group this round can declare the close without the attack. A touch on a monster, with a touch spell or a staff of healing, also gets this code when the monster isn't in its group's front rank, whatever the distance. Then the target param is the monster's id. |
combat.attack.reload |
The attacker tried to fire a weapon that requires a reload, such as a crossbow, again this round after firing it last round without a round spent reloading in between. |
combat.breath.exhausted |
The monster has already used its breath weapon the maximum number of times allowed per day. |
combat.breath.no_breath_weapon |
The monster attempting to breathe does not have a breath weapon ability at all. |
creation.*
| Code | Meaning |
|---|---|
creation.adjustment.above_cap |
The player tried to raise a prime requisite ability score by an amount that would push it above the maximum score of 18. |
creation.adjustment.below_floor |
The player tried to lower an ability score by an amount that would drop it below the minimum allowed score of 9. |
creation.adjustment.class_restriction |
The player tried to lower an ability score that the chosen class specifically forbids lowering, such as a thief's Strength. |
creation.adjustment.not_lowerable |
The player tried to lower an ability score other than Strength, Intelligence, or Wisdom, the only three scores that can be traded down during character creation. |
creation.adjustment.points_mismatch |
The points added to raised ability scores do not equal half the points removed from lowered ability scores, as the two-for-one trade requires. |
creation.adjustment.prime_requisite_lowered |
The player tried to lower one of the chosen class's prime requisite ability scores, which cannot be traded away. |
creation.adjustment.raise_not_prime_requisite |
The player tried to raise an ability score that is not one of the chosen class's prime requisites. |
creation.adjustment.reduction_not_even |
The player tried to lower an ability score by an odd number of points; each reduction must be an even amount. |
creation.class.requirements_not_met |
One of the character's rolled ability scores falls below the chosen class's minimum requirement for that ability. |
creation.languages.duplicate_choice |
The player selected the same extra language more than once among the character's language choices. |
creation.languages.duplicates_native |
The player chose an extra language that the character's class already speaks natively. |
creation.languages.not_available |
The player chose a language that does not appear on the list of languages available for extra selection. |
creation.languages.too_many |
The player chose more extra languages than the character's Intelligence score allows. |
encounter.*
| Code | Meaning |
|---|---|
encounter.evade.already_evading |
The party sends another evade command while it is already fleeing and being chased in the current encounter. |
encounter.evade.nothing_to_drop |
The party tries to drop treasure or food to slow its pursuers, but no living party member is carrying anything of that kind to drop. |
encounter.none_active |
The command applies only during an encounter, but no encounter is currently active in the session. |
encounter.parley.mid_pursuit |
The party tries to open negotiations while a pursuit is underway, and parley isn't available once a chase has started. |
encounter.spawn.mid_pursuit |
The referee tries to spawn monsters while a pursuit is underway, and no new group can join an encounter once a chase has started. |
encounter.turning.mid_pursuit |
A cleric tries to turn undead while a pursuit is underway, and turning isn't available once a chase has started. |
exploration.*
| Code | Meaning |
|---|---|
exploration.action.requires_light |
The character tried to take an action that needs light, and neither the party's active light source nor the character's infravision (where it would apply) is available. |
exploration.door.already_closed |
The party tried to close a door that is already closed. |
exploration.door.already_open |
The party tried to open or force a door that is already standing open. |
exploration.door.gate_refused |
The party tried to open or force a door whose authored condition — a key carried, a flag set, an effect active — is not satisfied right now. Distinct from a lock: a door can require both, and the refusal carries the adventure's own refusal text when its author wrote one. |
exploration.door.locked |
The party tried to open or force a door that is locked and hasn't yet been unlocked. |
exploration.door.no_door |
The party targeted a direction that has no known door — it's either solid wall or a secret door the party hasn't discovered yet. |
exploration.door.no_spike |
The party tried to wedge a door open, but no member is carrying an item, such as iron spikes, to wedge it with. |
exploration.door.not_stuck |
The party tried to force open a door that isn't stuck, so forcing it isn't necessary. |
exploration.door.stuck |
The party tried to open a stuck door the normal way; it must be forced open instead. |
exploration.door.wedged |
The party tried to close or re-wedge a door that a spike or similar item is already holding open. |
exploration.feature.emptied |
The party tried to take treasure from a cache that has already been emptied. |
exploration.feature.unknown |
The command references a feature at the party's location that doesn't exist, or that isn't the kind of feature (such as a treasure cache) the action expects. |
exploration.give.same_member |
A character was told to give items or coins to themselves, with a command or a battle declaration. The giver and the recipient must be different party members. |
exploration.item.not_carried |
The character or party doesn't currently have the referenced item, coin amount, or dropped item in their possession at this location. |
exploration.item.not_equipped |
The character tried to unequip an item that isn't currently worn or wielded. |
exploration.light.no_flame |
The party has no open flame currently burning to light this from, and the character isn't carrying a tinder box to strike a new one. |
exploration.light.not_a_source |
The party tried to light an item that isn't a light source — only a torch, lantern, or flask of oil can be lit. |
exploration.light.not_burning |
The character tried to extinguish a torch or lantern, but has none currently lit. |
exploration.listen.already_tried |
The character already listened at this door and can't attempt it again. |
exploration.lock.locked_out |
The character already failed to pick this lock and hasn't gained a level since, so they can't try it again yet. |
exploration.lock.no_tools |
The character tried to pick a lock without carrying thieves' tools. |
exploration.lock.not_a_thief |
The character's class has no thief skills, so they can't attempt to pick locks. |
exploration.lock.not_locked |
The character tried to pick a lock on a door that isn't locked, or whose lock is already open. |
exploration.move.blocked |
The party tried to move in a direction that isn't passable — a wall, a closed door, or an undiscovered secret door. |
exploration.move.cannot_move |
The party can't move because a member is carrying more than their maximum load, or because a living member is incapacitated or entangled. |
exploration.party.bad_order |
The proposed marching order doesn't list exactly the party's current members. |
exploration.search.already_tried |
The character already searched here for this same kind of thing and can't try again. |
exploration.stairs.none |
The party tried to use stairs or a level transition at a location that has none. |
exploration.transition.gate_refused |
The party tried to take a stair, trapdoor, or chute whose authored condition is not satisfied right now — the unpaid toll at the threshold. The refusal carries the adventure's own refusal text when its author wrote one. |
exploration.trap.already_resolved |
The party tried to disarm or remove a trap that has already been removed or has already sprung. |
exploration.trap.not_a_thief |
The character's class has no thief skills, so they can't find or remove traps on treasure. |
exploration.trap.not_found |
The party tried to remove a trap that hasn't been discovered yet. |
exploration.travel.not_at_entrance |
The party tried to travel to town from somewhere other than the dungeon level's mapped entrance. |
items.*
| Code | Meaning |
|---|---|
items.coins.insufficient |
A referee tried to remove more coins of some denomination than the member's purse holds. The purse pays in the coins named, so coins of another denomination don't make up the difference. |
items.curse.stuck |
The character tried to unequip or drop a magic item that has already revealed itself as cursed, and a cursed item stays bound to its bearer until a remove curse effect lifts it. |
items.device.inert |
The character tried to activate a charged magic device, such as a wand, staff, or rod, that has no charges remaining. |
items.equip.armour_forbidden |
The character tried to equip body armour, but the class's armour policy forbids wearing armour of any kind. |
items.equip.armour_not_allowed |
The character tried to equip a piece of body armour other than leather, but the class's armour policy restricts it to leather armour only. |
items.equip.not_equippable |
The character tried to equip an item the engine doesn't treat as equippable at all, such as a potion, a scroll, plain ammunition, gear with no combat use, or a magic item whose underlying base item can't be identified. |
items.equip.not_usable |
The character tried to equip a magic rod, wand, or miscellaneous magic item whose usability restriction doesn't permit that class to use it. |
items.equip.shield_forbidden |
The character tried to equip a shield, but the class's armour policy doesn't allow shields. |
items.equip.two_handed_with_shield |
The character tried to equip a two-handed weapon while a shield is already equipped, or a shield while a two-handed weapon is already wielded, and the two cannot be used together. |
items.equip.weapon_forbidden |
The character tried to equip a weapon that the class's weapon policy explicitly excludes. |
items.equip.weapon_not_allowed |
The character tried to equip a weapon that isn't on the class's list of permitted weapons. |
items.purchase.insufficient_funds |
The character tried to buy equipment costing more than the character's purse holds, or the party tried to pay for a temple healing service that the whole gold pieces in its purses together cannot cover. |
items.purchase.not_stocked |
The character tried to buy an item the adventure bundles rather than one the shipped equipment lists carry; the town shop stocks the shipped lists only, and bundled items are found in the dungeon rather than bought. |
items.remove.not_carried |
A referee tried to remove an item the member doesn't carry: fewer units of a mundane item than asked for, a magic item's catalog id rather than the instance id of a copy, or an instance id with a quantity other than 1. |
items.ring.hands_full |
The character tried to equip a third magic ring while already wearing the maximum of two. |
items.scroll.no_such_spell |
The character tried to read a spell from a scroll that isn't among the spells still inscribed on it. |
items.scroll.spent |
The character tried to read from a scroll whose inscribed spells have all already been used up. |
items.scroll.wrong_caster |
The character tried to read an arcane or divine scroll but the character's class can't cast that kind of magic, and, for a thief attempting a magic-user scroll, doesn't meet the minimum level for that exception. |
items.use.battle_only |
The character tried to use a magic staff whose only power is a strike against a group, like the staff of striking, outside a battle. A strike is possible only as a battle declaration. |
items.use.not_usable |
The character tried to activate a magic device, such as a wand, staff, or rod, whose own usability restriction doesn't permit that class to use it. |
items.use.target_cannot_be_healed |
A character tried to use a staff of healing on a creature that's dead or turned to stone, which the staff can't heal. The item param is the staff's instance id, and the target param is the creature's id. |
items.use.target_cannot_drink |
A character tried to give a potion to a party member who is dead or turned to stone, who can't drink it. A member who is asleep or paralyzed can be given a potion to drink. |
items.use.target_not_allowed |
A character tried to give a potion to someone who isn't a party member, or a battle declaration named more than one member to drink it. A potion goes to the character who carries it or to one other party member. |
items.use.target_required |
The character tried to activate an area-effect magic device during an encounter without naming which monster group to target. |
items.use.unknown_target |
The character tried to activate a magic device against a target, an encounter group or a character, that doesn't exist, has already fled, or otherwise can't be resolved. In a battle, a staff of healing whose declaration has more than one id in targets gets this code too. |
magic.*
| Code | Meaning |
|---|---|
magic.book.already_chosen |
The character's starting spell book has already been chosen once and cannot be set a second time. |
magic.book.capacity_exceeded |
Adding this spell to the caster's spell book would push the number of book entries at that spell level above the caster's current spell slots for that level. |
magic.book.capacity_mismatch |
The number of starting spells chosen at a given spell level doesn't exactly equal the number of level-1 spell slots the class receives at that level. |
magic.book.duplicate |
The chosen spell already appears in the caster's spell book, whether it was picked twice among the starting choices or is already present from an earlier addition. |
magic.book.not_arcane |
The character's class is not an arcane spellcaster, so it cannot be given starting spells or have spells added to a spell book. |
magic.book.unknown_spell |
The spell id supplied for a starting-spell choice or spell-book addition doesn't match any spell in the loaded spell catalog. In a session, a spell-book addition also gets this code while the caster's book already has a spell the session's catalog doesn't, and the rejection's spell is that one. |
magic.book.wrong_list |
The spell being chosen as a starting spell or added to a spell book belongs to a different spell list than the one the caster's class uses. |
magic.cast.anti_magic_shell |
An anti-magic shell effect is currently active on the caster, which blocks the caster from casting any spell while inside it. |
magic.cast.caster_incapacitated |
The caster is dead, petrified, paralysed, asleep, silenced, feebleminded, or weakened, any of which leaves it unable to cast spells. |
magic.cast.caster_restrained |
The caster is bound or gagged, and casting a spell requires both free hands and the ability to speak. |
magic.cast.not_memorized |
The caster has no matching prepared copy of the spell in the requested normal or reversed form (or belongs to a class with no spellcasting profile at all), so there is nothing to cast. |
magic.cast.not_reversible |
The cast asks for the reversed form of a spell that has no reversed form. |
magic.cast.out_of_range |
A distance to the target was supplied for the cast and it exceeds the spell's maximum range for the caster's level. A touch spell reaches 5 feet. In a battle, the distance is the caster's distance to the target's group, or to a target party member, where that member will stand once the round's declared moves are made. |
magic.cast.silenced_area |
The caster's current location is under an active silence effect, which prevents spellcasting there. |
magic.cast.target_count |
The number of targets supplied for the spell doesn't match what its targeting mode requires, such as a self-only spell receiving explicit targets, a single-target spell not receiving exactly one, or a multi-target effect like magic missile not receiving the required number of targets. |
magic.cast.target_must_be_creature |
A target of the cast is a location, like a cell reference, and the mode works only on creatures: it allows a saving throw, deals damage or heals, kills or raises the dead, spends a pool of Hit Dice, or grants a condition or modifiers. A spell like web, light, or dispel magic can still be cast at a location. |
magic.cast.unknown_mode |
The requested casting mode key isn't a valid mode for this spell in the form (normal or reversed) being cast. |
magic.cast.unknown_spell |
The spell id given in a cast command doesn't match any spell in the loaded spell catalog. |
magic.cast.unknown_target |
One of the target references given for a cast, or for reading a spell from a scroll, doesn't resolve to any known entity or location in the current session. |
magic.memorize.divine_reverses_at_cast |
A divine caster tried to prepare a spell already fixed to its reversed form; divine casters choose whether to reverse a spell only at the moment they cast it, not when they memorize it. |
magic.memorize.needs_sleep |
The character hasn't slept yet, or has already prepared its spells since its last sleep, so it cannot memorize spells again until it sleeps. |
magic.memorize.not_a_caster |
The character's class has no spellcasting profile, so it has no spells to memorize. |
magic.memorize.not_in_book |
An arcane caster tried to memorize a spell that isn't in its spell book. |
magic.memorize.not_reversible |
An arcane caster tried to memorize the reversed form of a spell that has no reversed form. |
magic.memorize.slots_exceeded |
The number of spells selected for memorization at a spell level exceeds the caster's available spell slots at that level for its current class level. |
magic.memorize.unknown_spell |
The spell id given in a memorization selection doesn't match any spell in the loaded spell catalog. |
magic.memorize.wrong_list |
A spell selected for memorization belongs to a different spell list than the one the caster's class uses. |
magic.turning.caster_incapacitated |
The would-be turner is dead, petrified, paralysed, asleep, or weakened, any of which prevents it from attempting to turn undead. |
magic.turning.not_a_turner |
The character's class has no turn-undead ability, so it cannot attempt to turn undead. |
party.*
| Code | Meaning |
|---|---|
party.add.carries_instances |
A referee tried to add a party member who carries a magic item or a valuable, equipped or not. Those have instance ids from the game that created them, which could match an id this session hands out. Add the character without them and give magic items afterwards with a grant. |
party.add.id_assigned |
A referee tried to add a party member whose id is already set: a character from another game, or one who is already a member. The session assigns the new member's id, so the character must arrive with no id. |
party.add.under_effects |
A referee tried to add a party member who has a condition, such as dead or asleep, or a stat modifier. Each of those belongs to an effect in the game that applied it, and this session can't end an effect it doesn't have. |
party.remove.carries_quest_item |
A referee tried to remove a party member without naming a member in give_to, and the member carries an item the adventure depends on. A door, stair, trigger, or open quest names the item, so removing the member would take it out of the game and could leave the party stuck. Send the command again with give_to set to a member who can take everything, the item included. |
party.remove.last_standing |
A referee tried to remove the last party member who is neither dead nor turned to stone, or the only member. A party with nobody standing has lost the game. Add the replacement first, and then remove the old member. |
party.remove.same_member |
A referee tried to remove a party member and give their belongings to that same member. Name a different member to take them, or leave the recipient out so the belongings leave with the member. |
session.*
| Code | Meaning |
|---|---|
session.command.member_incapacitated |
The named party member is dead, paralyzed, petrified, or asleep and can't carry out the requested action. |
session.command.no_door |
The map edge at the given position and direction is not a door, so no door state can be set there. |
session.command.no_living_members |
The party tried to take treasure from a cache or pile, but every party member is dead, leaving no one to carry it. |
session.command.out_of_bounds |
The party was placed at a dungeon position that falls outside the mapped area of that level. |
session.command.quest_state |
A quest lifecycle command contradicts the state the quest is already in: activating a quest that is active or finished, revealing an objective that is already visible or already complete, completing an objective that is already complete, or revealing or completing anything on a quest that isn't active. |
session.command.unknown_item |
The command referenced an item id that doesn't exist in the equipment catalog or, for a grant, the magic item catalog, or, when identifying an item, a magic item the named member isn't carrying. |
session.command.unknown_location |
The command referenced a dungeon id or level number that doesn't exist in the adventure, or the target dungeon has no level with an entrance defined. |
session.command.unknown_member |
The command referenced a character id that doesn't belong to any member of the current party. |
session.command.unknown_monster |
The referee tried to spawn monsters using a template id that doesn't exist in the monster catalog. |
session.command.unknown_objective |
A quest lifecycle command referenced an objective id that the named quest doesn't define. |
session.command.unknown_quest |
A quest lifecycle command referenced a quest id that the adventure doesn't define; quest ids resolve against the adventure's own quest specs. |
session.command.wrong_mode |
The command isn't legal in the session's current mode, such as sending a battle-only command while the session isn't in battle. |
town.*
| Code | Meaning |
|---|---|
town.healing.caster_level_out_of_range |
The party asked for a temple cleric of a level that can't cast the service: below the lowest level that can cast it, or above the highest level a cleric can reach. The minimum and maximum params give the levels the temple accepts for the service. The temple refuses before it takes any payment. |
town.healing.no_effect |
The party asked the temple for a service that would do nothing for the member: raise dead on a living member or on one dead longer than the spell reaches at the cleric's level, cure disease on a member who isn't diseased, or neutralize poison on a member who isn't poisoned and didn't die of poison in the last 10 rounds. The temple refuses before it takes any payment. |
town.sell.no_fixed_value |
The party tried to sell a magic item, which carries no fixed market value a shop will pay for. |