Skip to content

LightSource

Light a torch or lantern, or ignite dropped oil (one round).

Full documentation: LightSource. Wire type: light_source.

Legal session modes: exploring, town

JSON Schema

{
  "description": "Light a torch or lantern, or ignite dropped oil (one round).\n\nLegal in town and while exploring. Without an open flame already burning in\nthe party, the bearer needs a tinder box, and striking it is a 2-in-6 chance \u2014\nthe round is spent per attempt (RAW). Lighting an `oil_flask` ignites a flask\npreviously dropped on the party's cell as a burning pool.\n\nModes:\n    `town`, `exploring`\n\nRejections:\n    - `session.command.wrong_mode` \u2014 an encounter or battle is underway, or the\n      game is over.\n    - `session.command.unknown_member` \u2014 `character_id` names no party member.\n    - `session.command.member_incapacitated` \u2014 the member cannot act.\n    - `exploration.light.not_a_source` \u2014 `item_id` is not `torch`, `lantern`,\n      or `oil_flask`.\n    - `exploration.item.not_carried` \u2014 the member lacks the source (or oil for\n      the lantern), or no dropped flask lies on the cell.\n    - `exploration.light.no_flame` \u2014 no open flame and no tinder box.\n\nEvents:\n    [`LightEvent`][osrlib.crawl.events.LightEvent] with code\n    `exploration.light.lit` \u2014 an\n    [`EffectAttachedEvent`][osrlib.core.events.EffectAttachedEvent] carries the\n    burn-down effect \u2014 or `exploration.light.failed` when the tinder does not\n    catch. One round passes.",
  "properties": {
    "command_type": {
      "const": "light_source",
      "default": "light_source",
      "title": "Command Type",
      "type": "string"
    },
    "character_id": {
      "title": "Character Id",
      "type": "string"
    },
    "item_id": {
      "title": "Item Id",
      "type": "string"
    }
  },
  "required": [
    "character_id",
    "item_id"
  ],
  "title": "LightSource",
  "type": "object"
}