Regions

Edit tabs/regions.json.

Required Fields

Field	Requirement
`name`	Must match object key exactly
`basicInfo`	One paragraph describing geography, climate, and atmosphere
`x`	Integer grid coordinate - must be adjacent to other regions in the same realm
`y`	Integer grid coordinate - must be adjacent to other regions in the same realm
`realm`	Which realm this region belongs to
`imageUrl`	URL for the region’s map image

Conditional Fields

Field	When to Include
`known`	Set to `false` to hide from map at game start. Omit or set `true` for visible by default
`factions`	Only when region has dominant faction presence affecting the entire area

Never Include

Field	Reason
`hiddenInfo`	Unused field — region secrets belong in location or NPC entries instead

basicInfo Format

One paragraph covering three aspects:

Geography - Terrain, landmarks, natural features
Climate/Atmosphere - Weather patterns, sensory details, mood
Inhabitant hints - Who or what lives here, without full faction details

Format: “[Terrain description]. [Climate and atmospheric details]. [Brief mention of inhabitants or dangers].”

Coordinate System

Regions use integer grid coordinates. Within a realm, regions must be adjacent (differ by 1 in x or y, not diagonal).

(0,0)  (1,0)  (2,0)
(0,1)  (1,1)  (2,1)
(0,2)  (1,2)  (2,2)

Rules:

Regions in the same realm must form a connected grid (no isolated regions)
Adjacent means sharing an edge, not diagonal
Check existing regions in tabs/regions.json before assigning coordinates

Design guidance:

Place related regions adjacent to each other
Consider travel routes when positioning
North is -y, South is +y, East is +x, West is -x
Regions at same coordinates in different realms can represent parallel locations

Region Scope

Regions are large geographic areas containing multiple 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

Each region typically contains various locations.

Schema

interface Region {
  name: string
  basicInfo: string
  x: number
  y: number
  realm?: string
  known?: boolean
  hiddenInfo?: string
  factions?: string[]
}

Reference

For detailed documentation, see regions-reference.md.