Search

Search the party's cell for one hidden-feature kind (one turn).

Full documentation: Search. Wire type: search.

Legal session modes: exploring

JSON Schema

{
  "description": "Search the party's cell for one hidden-feature kind (one turn).\n\nThe party must be exploring a dungeon (see\n[`EnterDungeon`][osrlib.crawl.commands.EnterDungeon]), with light (infravision\nsuffices). Each character gets one attempt per cell per kind, ever.\n\nModes:\n    `exploring`\n\nRejections:\n    - `session.command.wrong_mode` \u2014 the session is not exploring a dungeon.\n    - `session.command.unknown_member` \u2014 `character_id` names no party member.\n    - `session.command.member_incapacitated` \u2014 the member cannot act.\n    - `exploration.action.requires_light` \u2014 the party is in the dark and the\n      searcher lacks infravision.\n    - `exploration.search.already_tried` \u2014 this character already searched this\n      cell for this kind.\n\nEvents:\n    [`DetectionRolledEvent`][osrlib.crawl.events.DetectionRolledEvent] with the\n    roll, a [`TrapEvent`][osrlib.crawl.events.TrapEvent] when a room trap is\n    found, then\n    [`SearchCompletedEvent`][osrlib.crawl.events.SearchCompletedEvent] naming\n    what turned up. One turn passes with its usual follow-on events.",
  "properties": {
    "command_type": {
      "const": "search",
      "default": "search",
      "title": "Command Type",
      "type": "string"
    },
    "character_id": {
      "title": "Character Id",
      "type": "string"
    },
    "kind": {
      "enum": [
        "secret_doors",
        "room_traps",
        "construction"
      ],
      "title": "Kind",
      "type": "string"
    }
  },
  "required": [
    "character_id",
    "kind"
  ],
  "title": "Search",
  "type": "object"
}