Location Settings (Advanced)
locationSettingsControls 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.
"World generation settings like region size, travel distances, etc."
- Editor location
- Other → Advanced → Location Settings
- Editor type
- JSON + ADD ITEM
- Size limits
No character-length caps for this section.
Schema
{
"locationSettings": {
"regionSize": "number",
"simpleRadius": "number",
"complexRadius": "number",
"regionLocationCount": "number",
"regionFactionCount": "number",
"avgTravelDistance": "number",
"minTravelDistance": "number",
"newRegionGenerationEnabled": "boolean",
"encountersEnabled": "boolean",
"regionMapBorderFeatheringEnabled": "boolean"
}
}Example
{
"regionSize": 100,
"simpleRadius": 2,
"complexRadius": 5,
"regionLocationCount": 8,
"avgTravelDistance": 30,
"minTravelDistance": 5,
"regionFactionCount": 4,
"newRegionGenerationEnabled": true,
"encountersEnabled": false
}"Keep the default values unless you decide you want them to be different."
Fields
regionSize
the 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.
simpleRadius
the map footprint (in coordinate units) of a complexityType: "simple" location. Determines when the player is considered "at" vs "near" that location during map travel.
complexRadius
same as simpleRadius but for complexityType: "complex" locations, which are larger on the map.
regionLocationCount
target 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.
avgTravelDistance
avgTravelDistance must be ≤ regionSize. Critical note: "If your region is 10km wide but avgTravelDistance is 20km, the player will overshoot every destination."
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.
minTravelDistance
minimum distance between locations. Prevents locations from spawning so close together that travel is instantaneous.
regionFactionCount
factions placed in AI-generated regions. Required.
newRegionGenerationEnabled
whether AI can create new regions during play. Required.
encountersEnabled
enables random encounter system. Required.
regionMapBorderFeatheringEnabled
whether region map images fade out around their edges. When true (the default), the outer area of each region map image is feathered into a soft fade; when false, the full image renders edge-to-edge with no fade. Set it to false when aligning region images side by side into one continuous map, so the seams between regions don't show a faded border. Optional.