UnofficialWIKI
Builder
Edit / Suggest changeSuggest deletion

Encounters

generateEncounters

Generates encounter options for travel through the wilderness. Use custom to shape what those encounters look like in your world; encounterElements supplies reusable ingredients.

In the editor

"Runs when travel can produce an unscripted encounter. Use it to shape threats, discoveries, creature behavior, complications, and peaceful resolutions; pair it with Encounter Elements for reusable ingredients."

Editor location
Files → AI → Encounters
Editor type
Edit in Studio + View JSON
API endpoint
/sections/generateEncounters.json/sections/generateEncounters.md
Size limits
  • Each string leaf under a task (aiInstructions.<task>.<key>) — 5,000
Related

Schema

json
{
  "aiInstructions": {
    "generateEncounters": {
      "<key>": "string"
    }
  }
}

Example

json
{
  "aiInstructions": {
    "generateEncounters": {
      "custom": "## Structure\nFrame encounters as situations, not ambushes. Give the player a moment to observe before committing. Every encounter has a non-combat resolution path.\n\n## Mix\nTwo of five options should involve conflict or danger. Three should offer interaction, exploration, or opportunity."
    }
  }
}

Fields

custom

The only key — free-form encounter-framing rules. The encounterElements section supplies the raw palette this task draws from.

Authoring pattern

Cover in custom:

  • Difficulty tiers and how they map to enemy strength or environmental danger in your setting.
  • Creature type behavior rules for the monster categories in your world.
  • Non-combat resolution conditions that are specific to your world's tone and genre.
  • Encounter mix guidance — the ratio of dangerous to non-dangerous options appropriate for your world.