Skip to content

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.