{
  "tab": "other",
  "section": "locationSettings",
  "title": "Location Settings (Advanced)",
  "summary": "Controls the map and travel system parameters: region size, location radii, travel distances, how many `factions` the engine places in AI-generated `regions`, and whether new `regions` and encounters can be created during play.",
  "uiLocation": "Other → Advanced → Location Settings",
  "uiSubtitle": "\"World generation settings like region size, travel distances, etc.\"",
  "editor": "JSON + ADD ITEM",
  "sizeLimits": [],
  "related": "regions - region size parameters defined here; locations - travel distances and visibility settings apply to these",
  "wikiUrl": "/other/locationSettings",
  "schema": {
    "_type": "intersection",
    "parts": [
      {
        "_type": "required",
        "fields": {
          "regionSize": "number",
          "simpleRadius": "number",
          "complexRadius": "number",
          "regionLocationCount": "number",
          "regionFactionCount": "number",
          "avgTravelDistance": "number",
          "minTravelDistance": "number",
          "newRegionGenerationEnabled": "boolean",
          "encountersEnabled": "boolean"
        }
      },
      {
        "_type": "partial",
        "fields": {
          "regionMapBorderFeatheringEnabled": "boolean"
        }
      }
    ]
  },
  "body": "## Example\r\n\r\n```json\r\n{\r\n  \"locationDifficultyTiers\": [\"beginner\", \"intermediate\", \"advanced\", \"expert\", \"mythic\", \"legendary\"],\r\n  \"regionSize\": 100,\r\n  \"simpleRadius\": 2,\r\n  \"complexRadius\": 5,\r\n  \"regionLocationCount\": 8,\r\n  \"avgTravelDistance\": 30,\r\n  \"minTravelDistance\": 5,\r\n  \"regionFactionCount\": 4,\r\n  \"newRegionGenerationEnabled\": true,\r\n  \"encountersEnabled\": false\r\n}\r\n```\r\n\r\n## Fields\r\n\r\n\"Keep the default values unless you decide you want them to be different.\"\r\n\r\n### locationDifficultyTiers\r\n\r\n**Extra-codec field.** Array of tier name strings that defines the valid difficulty labels the narrator uses when determining encounter power and obstacle complexity for locations.\r\n\r\n### regionSize\r\n\r\nthe width of each region in internal coordinate units. Location `x`/`y` offsets are relative to this; the default of `100` means locations range from −50 to +50 within a region.\r\n\r\n### simpleRadius\r\n\r\nthe map footprint (in coordinate units) of a `complexityType: \"simple\"` location. Determines when the player is considered \"at\" vs \"near\" that location during map travel.\r\n\r\n### complexRadius\r\n\r\nsame as `simpleRadius` but for `complexityType: \"complex\"` locations, which are larger on the map.\r\n\r\n### regionLocationCount\r\n\r\ntarget density for AI-generated regions: how many points of interest the engine generates to make a region feel populated. For authored regions, the narrator uses this as a density reference rather than a hard cap.\r\n\r\n### avgTravelDistance\r\n\r\n`avgTravelDistance` must be ≤ `regionSize`. Critical note: \"If your region is 10km wide but avgTravelDistance is 20km, the player will overshoot every destination.\"\r\n\r\n`avgTravelDistance` default of 20 works for small maps (5–6 regions). For larger maps (10+ regions with a wide coordinate spread), raise it to 25–35 proportionally. If it's set too low relative to your coordinate space, players overshoot every destination.\r\n\r\n### minTravelDistance\r\n\r\nminimum distance between locations. Prevents locations from spawning so close together that travel is instantaneous.\r\n\r\n### regionFactionCount\r\n\r\nfactions placed in AI-generated regions. **Required.**\r\n\r\n### newRegionGenerationEnabled\r\n\r\nwhether AI can create new regions during play. **Required.**\r\n\r\n### encountersEnabled\r\n\r\nenables random encounter system. **Required.**\r\n\r\n### regionMapBorderFeatheringEnabled\r\n\r\nwhether region map images render with feathered, rounded borders. Defaults to feathered; set `false` to render region maps as flat square tiles. **Optional.**"
}