UnofficialWIKI
Builder
Edit / Suggest changeSuggest deletion

Location Settings

locationSettings

Controls the map and travel parameters: region size, the default location radii, travel distances, how many locations a generated region gets, and whether new regions and encounters can be created during play.

In the editor

"World generation settings like region size, travel distances, etc."

Editor location
Files → Other → Advanced → Location Settings
Editor type
Edit in Studio + View JSON
API endpoint
/sections/locationSettings.json/sections/locationSettings.md
Size limits

No character-length caps for this section.

Related

Schema

json
{
  "locationSettings": {
    "regionSize": "number",
    "simpleRadius": "number",
    "complexRadius": "number",
    "regionLocationCount": "number",
    "avgTravelDistance": "number",
    "minTravelDistance": "number",
    "newRegionGenerationEnabled": "boolean",
    "encountersEnabled": "boolean",
    "regionMapBorderFeatheringEnabled": "boolean"
  }
}

Example

json
{
  "locationSettings": {
    "regionSize": 100,
    "simpleRadius": 2,
    "complexRadius": 5,
    "regionLocationCount": 8,
    "avgTravelDistance": 20,
    "minTravelDistance": 5,
    "newRegionGenerationEnabled": true,
    "regionMapBorderFeatheringEnabled": true,
    "encountersEnabled": false
  }
}

"Keep the default values unless you decide you want them to be different."

Fields

regionSize

the width of each region, in kilometres. Location x/y offsets are relative to it: coordinates range from −regionSize/2 to +regionSize/2 within a region, so the default of 100 means −50 to +50, and a location outside that range is flagged as off the map.

simpleRadius

the radius, in kilometres, used for complexityType: "simple" locations. The default is 2.

complexRadius

the same as simpleRadius, for complexityType: "complex" locations. The default is 5.

regionLocationCount

how many locations a generated region gets. The default is 8.

avgTravelDistance

average travel distance, in kilometres. The default is 20. Keep it well below regionSize, or travel overshoots its destination.

minTravelDistance

minimum distance between locations, in kilometres. The default is 5.

newRegionGenerationEnabled

whether AI can create new regions during play. The default is true.

encountersEnabled

enables the random encounter system. The default is false.

regionMapBorderFeatheringEnabled

whether region map images fade out around their edges. When true, 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. A world created in Studio starts at false; the engine's base world, which fills the field when a world leaves it out, sets true. 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.