Location Details

generateLocationDetails

Generates location descriptions, areas and paths. Use custom to set how your world's places should read; locationArchetypes supplies reusable place concepts.

In the editor

"Runs when the game creates or expands a location. Use it to shape atmosphere, culture, hazards, infrastructure, and recurring place archetypes so new locations fit the surrounding world."

Editor location
Files → AI → Location Details
Editor type
Edit in Studio + View JSON
Size limits
  • Each string leaf under a task (aiInstructions.<task>.<key>) — 5,000

Schema

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

Example

json
{
  "aiInstructions": {
    "generateLocationDetails": {
      "custom": "## First Entry\nEstablish three layers on entry: what the player sees, what they hear, what the atmosphere feels like. One detail per layer — weave them into the description, don't list them.\n\n## Archetype Integration\nThe location archetype is the generative spine. Every area should express a different facet of its core tension."
    }
  }
}

Fields

custom

The only key — free-form rules added to this task's built-in instructions.

Authoring pattern

Cover in custom:

  • Three sensory layers on first entry: sight, sound, atmosphere — one detail each, woven into the prose.
  • detailType interpretation guidance for your world's location archetypes.
  • Atmosphere rules specific to location types (e.g. how dungeons feel vs. cities vs. wilderness).