Evade
Run from the encounter before a battle starts.
Full documentation: Evade. Wire type: evade.
Legal session modes: encounter
JSON Schema
{
"description": "Run from the encounter before a battle starts.\n\nAn encounter must be open. Monsters whose stance is `attacks` or `hostile` pursue the\nparty, if any of them can move. The party gets away at once when no monster pursues it,\nor when it runs faster than the slowest monster that pursues it. Otherwise a pursuit\nstarts, and each `Wait` or\n`DropItems` runs one round of it. `drop` scatters\nbait as the party runs: coins tempt intelligent monsters, and food tempts unintelligent\nones. Once battle has started, the party can't evade. The OSE SRD allows evasion only\nbefore combat.\n\nModes:\n `encounter`\n\nRejections:\n - `session.command.wrong_mode` - no encounter is open.\n - `encounter.none_active` - a second check behind the mode gate, which normal\n play never reaches.\n - `encounter.evade.already_evading` - a pursuit is already running.\n - `encounter.evade.nothing_to_drop` - no living member has coins (for\n `treasure`) or rations (for `food`) to scatter.\n\nEvents:\n An `ItemsDroppedEvent` for each member who\n scatters bait. For `food`, its `item_ids` has the catalog id of the ration the member\n dropped, `rations_standard` or `rations_iron`. Then an\n `EvasionEvent` with code\n `encounter.evasion.succeeded`, which ends the encounter, or\n `encounter.evasion.pursuit`, which starts a pursuit, and the pursuit's first\n `PursuitEvent` round. A pursuit ends when the\n party escapes, when it exhausts the party at the round limit\n (`ExhaustionEvent`, with an\n `EffectAttachedEvent` and a\n `ConditionGainedEvent` for the\n exhaustion), or when the monsters catch the party and battle starts\n (`BattleStartedEvent`).\n\n When the encounter ends, the session emits an\n `EncounterEndedEvent`, a\n `MonsterDefeatedEvent` for each\n monster killed or driven off, a\n `LootDroppedEvent` when the slain leave\n anything on the floor,\n `EffectReleasedEvent`s for the\n effects that end with it, and, under the immediate XP timing,\n `XpAwardedEvent` and\n `CharacterLeveledUpEvent`.\n The clock then advances by the time the encounter took, with the usual\n `LightEvent` and\n `ProvisionsEvent` events for that time.",
"properties": {
"command_type": {
"const": "evade",
"default": "evade",
"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."
},
"drop": {
"default": "none",
"enum": [
"none",
"treasure",
"food"
],
"title": "Drop",
"type": "string",
"description": "What to scatter behind the party as it runs. `treasure` empties every living member's\npurse onto the trail, where the coins are lost, and tempts intelligent monsters to stop\nfor them. `food` drops one ration from each living member who carries one, and tempts\nunintelligent monsters. `none`, the default, drops nothing. The bait is dropped even when\nthe party gets away at once, but it has an effect only during a pursuit. When nobody has anything\nof that kind to drop, the session refuses the command with\n`encounter.evade.nothing_to_drop`, and the party doesn't run."
}
},
"title": "Evade",
"type": "object"
}