InspectTreasure
Have a thief check a treasure cache on the party's cell for a trap (one turn).
Full documentation: InspectTreasure. Wire type: inspect_treasure.
Legal session modes: exploring
JSON Schema
{
"description": "Have a thief check a treasure cache on the party's cell for a trap (one turn).\n\nThe party must be exploring a dungeon (see\n`EnterDungeon`), and it needs light: infravision\nisn't enough. Only a member with thief skills can find a treasure trap, and each member\ngets one attempt at each cache. Remove a trap found here with\n`RemoveTreasureTrap`. Until then, finding\nthe trap doesn't disarm it, and it still gets its chance to spring on every\n`TakeTreasure`. Only an authored cache can be\ntrapped. Inspecting a cache the engine generated always finds nothing.\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 treasure cache on\n this cell.\n - `exploration.action.requires_light` - the party has no light. Infravision\n isn't enough to inspect a cache.\n - `exploration.search.already_tried` - this member already inspected\n this cache.\n\nEvents:\n `DetectionRolledEvent` with the\n skill roll, then either a `TrapEvent` with code\n `exploration.trap.found` or a\n `SearchCompletedEvent`\n reporting nothing. One turn passes, with the turn's usual events.",
"properties": {
"command_type": {
"const": "inspect_treasure",
"default": "inspect_treasure",
"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 inspects, by `MemberView.id`. Only a\nmember with thief skills can find a treasure trap, and each one gets a single attempt per\ncache."
},
"feature_id": {
"title": "Feature Id",
"type": "string",
"description": "Which cache to check for a trap. Name an authored cache by its\n`FeatureSpec.id` in the adventure document. Name a\ncache the engine generated by the\n`HoardGeneratedEvent.cache_ref` the\nsession emitted when it generated the cache. That event has referee visibility, and the\nplayer view doesn't list generated caches, so read the id from the events of the command\nthat generated it. The cache has to be on the party's cell."
}
},
"required": [
"character_id",
"feature_id"
],
"title": "InspectTreasure",
"type": "object"
}