Regions

📋

Note: Each region value must be a plain object.

#Map coordinate system

You can plan out the shape of your realm and arrange the regions in whatever order you want.

Region and location coordinates use completely different systems.

#Region x/y (grid cell position)

• Each integer unit represents one full region cell (regionSize=100 units wide)
• Adjacent regions should differ by exactly 1 in x or y (e.g., (0,1) and (1,1) are side-by-side)
• A gap of 2+ between coordinates = empty random-terrain cells between regions
• DO NOT use large values like 95, 220, 555 — these place regions thousands of cells apart, making the map unnavigable
• x increases eastward, y increases northward: north is +y, south is -y, east is +x, west is -x (positive y renders upward on the map)

Example 11-region grid layout:

        x=0           x=1           x=2           x=3           x=4
y=2  [safe NW]    [mid NE]      [random]      [random]      [random]
y=1  [safe W]     [mid W]       [mid C]       [frontier E]  [frontier FE]
y=0  [coastal S]  [random]      [danger C]    [danger E]    [endgame]

Each region's playable area is its ±50 local grid. The map editor shows all regions on a global grid for editing. Players navigate between regions via in-game travel.

#Location x/y (local offset)

Location coordinates are a local offset from the parent region's center, not global.

• Range: ±50 (since regionSize=100 → each region spans 50 units in each direction from center)
• A location at (0,0) appears at the region center; (-23,25) is 23 units west, 25 units north
• The location editor shows e.g. x=-23, y=25, and the pin appears correctly inside the region box

#Realm vs region

Realm ≠ geographic zone. A realm is the top-level container — roughly equivalent to a world, country, or plane of existence. Most scenarios should have exactly one realm containing all regions. Regions are the actual geographic map units visible on the interactive player map. Do NOT split a single world into multiple realms as if they were continents or zones — use regions for that.

#Cross-region travel

When players travel past a region boundary, coordinates wrap into the adjacent region. With locationSettings.regionSize: 100:

From location (95, 50) in region (2, 2)
Travel +10 in x direction
→ Arrive at (5, 50) in region (3, 2)

The regionSize setting in locationSettings determines the float coordinate space within each region (default 100).

#Authoring tips

#What belongs in region basicInfo

A region describes a geographic area — the physical terrain, climate, landmarks, and who lives there. It does not describe a nation, political entity, or cultural tradition. Those belong in worldLore.

basicInfo should describe:

• Terrain type (plains, mountains, coast, forest, desert, urban)
• Climate and weather (temperature, rainfall, seasonal variation)
• Physical landmarks (rivers, peaks, coasts, notable formations)
• Who inhabits it (sparse vs dense, what kind of settlement)
• Local flavour (what makes this patch of land distinct to look at)

basicInfo should NOT describe:

• Full national history, dynastic succession, or political lore — that belongs in worldLore
• Cultural traditions, religious practices, or economic systems in depth
• School reputations, sports results, or institutional standing

A brief note on current political or military situation is appropriate — who controls this land and whether that control is contested helps the AI understand the region's mood and NPC loyalties. Keep it to one sentence; the details belong in worldLore.

#basicInfo template (3-aspect pattern)

One paragraph covering three aspects:

1. Geography — terrain, landmarks, natural features
2. Climate / atmosphere — weather patterns, sensory details, mood
3. Inhabitant hints — who or what lives here, without full faction details

Pattern: "[Terrain description]. [Climate and atmospheric details]. [Brief mention of inhabitants or dangers]."

#Region scope

Regions are large geographic areas, typically containing 3-8 locations. Think a forest (not a single grove), a mountain range (not a single peak), a coastal stretch (not a single beach), a district or quarter (not a single building).

#One region per geographic zone, not per country

A large nation with 10+ locations should be split into geographic sub-regions (northern highlands, southern plains, capital valley, coastal zone). Put the nation's political and cultural identity in worldLore under that nation's entry. The region just describes what the land looks like and who lives on it.

Example: Instead of "The Kingdom of Varn: an ancient monarchy with a proud military tradition.", write "A high granite mountain range forming the kingdom's northern border. Permanent snowfields at elevation, forested mid-slopes, and glacial valleys. Cold and dry at altitude. Two passes are the only overland routes through."

#Geographic layout tip

Adjacent regions connect for travel, so arrange them to hint at geography — e.g. safe starting regions on the west, dangerous frontier regions on the east, coastal regions in the south. This makes the map feel coherent without requiring any additional config.