Skip to content

RemoveTreasureTrap

Have a thief disarm a treasure trap the party has already found (one turn).

Full documentation: RemoveTreasureTrap. Wire type: remove_treasure_trap.

Legal session modes: exploring

JSON Schema

{
  "description": "Have a thief disarm a treasure trap the party has already found (one turn).\n\nThe party must be exploring a dungeon (see\n`EnterDungeon`), and it needs light: infravision\nisn't enough. A member must already have found the trap with\n`InspectTreasure`. Only a member with thief\nskills can try, and each member gets one attempt at each trap. A failed attempt springs\nthe trap on the thief who tried, unless\n`Ruleset.failed_trap_removal_springs`\nis off. With the flag off, the trap stays armed and found, and another thief in the party\ncan try. Once the trap is removed,\n`TakeTreasure` empties the cache safely.\n\nModes:\n    `exploring`\n\nRejections:\n    - `session.command.wrong_mode` - the session is not exploring a dungeon.\n    - `session.command.unknown_member` - `character_id` matches no party member.\n    - `session.command.member_incapacitated` - the member cannot act.\n    - `exploration.trap.not_a_thief` - the member has no thief skills.\n    - `exploration.feature.unknown` - `feature_id` matches no trapped cache on\n      this cell.\n    - `exploration.trap.not_found` - nobody has found the trap yet.\n    - `exploration.trap.already_resolved` - the trap was already removed or has\n      already sprung.\n    - `exploration.action.requires_light` - the party has no light. Infravision\n      isn't enough to remove a trap.\n    - `exploration.search.already_tried` - this member already tried to remove\n      this trap.\n\nEvents:\n    `DetectionRolledEvent` with the\n    skill roll, then a `TrapEvent`:\n    `exploration.trap.removed` on success. A failure gives `exploration.trap.sprung`, or\n    `exploration.trap.removal_failed` when `failed_trap_removal_springs` is off.\n    The sprung trap resolves at once against the thief, or against every living\n    member when the trap catches the whole party. Each step is a separate event:\n    a `SavingThrowRolledEvent` when\n    the trap allows a save,\n    `DamageDealtEvent` and\n    `HitPointsReportedEvent` for\n    damage, `EffectAttachedEvent` and\n    `ConditionGainedEvent` for a\n    condition, `DeathEvent` when it kills\n    outright, and\n    `LocationEnteredEvent`, `via`\n    `\"trap\"`, when it drops the party somewhere else. One turn passes.",
  "properties": {
    "command_type": {
      "const": "remove_treasure_trap",
      "default": "remove_treasure_trap",
      "title": "Command Type",
      "type": "string",
      "description": "The name that identifies the command class in serialized data. Each command class fixes\nit to a distinct snake_case string, like `\"move_party\"` or `\"open_door\"`, and constructing\nthe class sets it, so you never pass it yourself.\n`parse_command` and the\n`AnyCommand` union use it to rebuild the right class\nfrom a serialized mapping. A class's value never changes between releases."
    },
    "source": {
      "anyOf": [
        {
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Source",
      "description": "Who or what issued the command on whose behalf: an authored trigger or quest id, or the\nname of one of your game's systems. The engine never reads it, so a command with a\n`source` does exactly what the same command without one does. The session logs and\nreplays it with the command, so the log alone shows why something happened. Leave it\n`None` when there's nothing to record. An empty string fails validation when the command\nis constructed."
    },
    "character_id": {
      "title": "Character Id",
      "type": "string",
      "description": "The thief who works on the trap, by\n`MemberView.id`. A failed attempt springs the trap on\nthis member."
    },
    "feature_id": {
      "title": "Feature Id",
      "type": "string",
      "description": "Which trapped cache to disarm, by its\n`FeatureSpec.id` in the adventure document. Only an\nauthored cache can be trapped, so the session refuses the id of a cache the engine generated\nwith `exploration.feature.unknown`. The trap has to have been found already, or the command\ncomes back with `exploration.trap.not_found`."
    }
  },
  "required": [
    "character_id",
    "feature_id"
  ],
  "title": "RemoveTreasureTrap",
  "type": "object"
}