TheriapolisV3/theriapolis-rpg-procgen.md

Theriapolis — Procedural World Generation

Technical Design Document (High Level)

---

Executive Summary

The continent of Veldara is procedurally generated each playthrough while preserving the narrative spine of the main quest. The player experiences the same story in a different world every time — settlements shift, roads reroute, dungeons relocate, and the spaces between fixed narrative anchors are always fresh.

The core principle: Geography is authored. Topology is generated.

Meaning: the continental layout (temperate east, plains center, mountains west, tundra north, subtropical south) is fixed as a macro-template. But the specific shape of coastlines, the exact placement of mountain passes, the course of rivers, and the location of every settlement, road, and point of interest within those macro-regions is procedurally determined per seed.

---

---

LAYER 0: THE CONTINENTAL TEMPLATE

What Is Fixed (Every Playthrough)

The continental template is a hand-authored macro-biome map — a low-resolution grid (approximately 32×32 cells, each cell representing a large region) that defines the broad strokes:

NORTH
┌──────────────────────────────────┐
│  TUNDRA / BOREAL FOREST          │
│  (Polar Ursid, Wolverine-folk)   │
├──────────────────────────────────┤
│  TEMPERATE     │  NORTHERN       │
│  FOREST        │  PLAINS         │
│  (Mixed Clade) │  (Canid-heavy)  │
├────────────────┼─────────────────┤
│  EASTERN       │  CENTRAL        │  WESTERN
│  INDUSTRIAL    │  GRASSLANDS     │  MOUNTAINS
│  BELT          │  (Bovid/Cervid) │  (Mixed)
│  (Multi-Clade) │                 │  
├────────────────┼─────────────────┤
│  SOUTHEASTERN  │  SUBTROPICAL    │
│  COAST         │  LOWLANDS       │
│  (Trade ports) │  "The Tangles"  │
│                │  (Hybrid/fringe)│
└──────────────────────────────────┘
SOUTH

Each macro-cell carries:

• Biome type (tundra, boreal, temperate deciduous, grassland, mountain, subtropical, coastal, wetland)
• Dominant Clade affinity (which Clades historically settled here, influencing population ratios and architecture)
• Development level (industrial, agricultural, frontier, wilderness, urban)
• Covenant enforcement strength (strong, moderate, weak, nominal)

These macro-cells are NOT randomized. They are the authored skeleton that ensures narrative coherence. The main quest expects certain regions to exist in certain relative positions.

What Is Generated (Per Seed)

Everything inside and between those macro-cells:

• Coastline shape, island placement, bay/peninsula formation
• Mountain range contours, pass locations, elevation profiles
• River systems (source to sea, branching, confluence points)
• Forest density and treeline boundaries
• Micro-biome variation within macro-cells (a grassland cell might contain river-bottom woodlands, rocky outcrops, seasonal wetlands)

---

---

LAYER 1: TERRAIN GENERATION

Method: Constrained Multi-Octave Noise

Standard Perlin/Simplex noise terrain generation, but constrained by the macro-template.

Step 1 — Elevation Map

Generate a base elevation heightmap using multi-octave Simplex noise. Then apply the macro-template as a constraint mask:

• Cells tagged MOUNTAIN: elevation floor set high (0.7–1.0 range). Noise adds variation within that range (peaks, valleys, ridgelines) but cannot drop below the floor.
• Cells tagged GRASSLAND: elevation ceiling set low (0.1–0.3). Gently rolling terrain. Noise adds subtle hills but cannot spike.
• Cells tagged COASTAL: elevation forced to approach sea level (0.0) at the continent edge. Noise shapes the specific coastline contour.
• Cells tagged TUNDRA: elevation moderate, flatness enforced with low noise amplitude.
• Transition zones between macro-cells use gradient blending over 2–3 cell widths to prevent hard biome edges.

Step 2 — Moisture Map

Second noise layer, independent frequency. Combined with elevation to derive biome detail:

• High elevation + low moisture = alpine desert, rocky peaks
• High elevation + high moisture = alpine meadow, glacier
• Low elevation + high moisture = swamp, wetland, river floodplain
• Low elevation + low moisture = dry grassland, scrubland
• Moderate elevation + moderate moisture = temperate forest (the default)

The moisture map is also constrained: cells tagged SUBTROPICAL get a moisture floor. Cells tagged TUNDRA get a moisture ceiling (frozen, not wet).

Step 3 — Temperature Map

Derived primarily from latitude (north = cold, south = warm) with elevation modifier (higher = colder). This is mostly deterministic from the other two maps, with minor noise for local variation (cold pockets in valleys, warm microclimates on south-facing slopes).

Step 4 — Erosion Simulation (Optional, Performance Budget Permitting)

Hydraulic erosion pass over the heightmap to create natural-looking river valleys, canyon cuts, and sediment plains. This step transforms geometric noise terrain into terrain that looks like water has been flowing over it for millennia. Expensive but dramatically improves visual quality.

If performance is a concern, skip this and use the river placement algorithm in Layer 2 instead (cheaper, less realistic, still functional).

---

Biome Resolution

After the three maps are generated, each terrain cell (higher resolution now — think 512×512 or 1024×1024 for the full continent) is assigned a micro-biome based on its elevation/moisture/temperature values:

Biome	Elevation	Moisture	Temperature
Tundra	Low–Med	Low	Cold
Boreal Forest	Low–Med	Med	Cold
Temperate Deciduous	Low–Med	Med–High	Moderate
Temperate Grassland	Low	Low–Med	Moderate
Mountain (alpine)	High	Varies	Cold
Mountain (forested)	Med–High	Med–High	Moderate
Subtropical Forest	Low–Med	High	Warm
Wetland/Swamp	Very Low	Very High	Warm
Coastal	Sea Level	High	Varies
River Valley	Low (carved)	High	Varies
Scrubland	Low–Med	Low	Warm–Moderate
Desert (cold)	Med	Very Low	Cold

Each biome carries associated data: traversal cost, encounter tables, resource availability, visual tileset, ambient sound profile, and ambient scent profile (this is Theriapolis — the world smells different in a boreal forest than a swamp, and PCs with scent abilities should experience that).

---

---

LAYER 2: HYDROLOGY — RIVERS, LAKES, COASTLINE

Rivers

Rivers are the skeleton of civilization. They determine where settlements form, where trade flows, and where borders harden.

Generation Method: Drainage Simulation

1. Identify the highest points on the elevation map (mountain peaks, ridgelines).
2. Simulate water flow downhill from multiple source points using gradient descent.
3. Water accumulates: streams merge into rivers based on flow volume thresholds.
4. Rivers carve into the elevation map slightly (lowering terrain along their path) to create natural valleys.
5. Rivers terminate at the ocean (coastline), a lake basin (local elevation minimum), or a swamp/wetland (flat, high-moisture area).

Constraints:

• At least one major river must cross each of the following macro-regions: Eastern Industrial Belt, Central Grasslands, Subtropical Lowlands. The quest expects river crossings and river-based settlements.
• Millhaven (Act I starting town) is always on a river. The generation guarantees a river within the Eastern Temperate Forest macro-cell.

River Classification:

• Stream (narrow, wadeable): traversal cost low, no ferry needed
• River (moderate, bridgeable): settlements form at crossing points, bridges are infrastructure
• Major River (wide, requires ferry or bridge): trade arteries, political borders, major settlement anchors

Lakes

Lakes form at local elevation minimums where river drainage collects. Size varies by drainage basin. At least one large lake exists per playthrough (visual landmark, potential quest location). Lakes in tundra regions freeze seasonally.

Coastline

The continent's edge is generated by the elevation map meeting sea level. Noise amplitude at coastal cells determines complexity: smooth beaches, rocky cliffs, fjord-like inlets (north), mangrove swamp (south), bay harbors (east/southeast).

At least 3 natural harbor sites are guaranteed (the economy needs ports). Harbor sites are identified algorithmically: sheltered bays where depth drops off near shore. Trade cities always generate at harbors.

---

---

LAYER 3: SETTLEMENT PLACEMENT

The Rules

Settlements don't appear randomly. They form where biology, geography, and economics demand them. The placement algorithm encodes this.

Step 1 — Identify Settlement Seed Points

Score every terrain cell for habitability:

habitability = (water_proximity × 3.0)
             + (flatness × 2.0)
             + (fertility × 2.0)
             + (trade_route_potential × 1.5)
             + (resource_proximity × 1.0)
             - (elevation_extreme × 2.0)
             - (hazard_proximity × 1.5)

Where:

• water_proximity: distance to nearest river or lake (closer = higher)
• flatness: inverse of local elevation variance (flatter = higher)
• fertility: derived from moisture + temperature (good growing conditions)
• trade_route_potential: centrality score — how many other high-habitability cells are reachable without crossing mountains or deep water
• resource_proximity: distance to mineable mountains, fishable coast, timber forests
• elevation_extreme: penalty for very high or very low (swamp) elevation
• hazard_proximity: penalty for proximity to wilderness zones with high encounter rates

Step 2 — Place Settlements by Tier

Starting from the highest-scored cells, place settlements with minimum-distance constraints (settlements can't be too close together — they compete for resources).

Tier 1: Capital City (1)

• Placed in the highest-scoring cell in the Eastern Industrial Belt macro-region or at the intersection of the two highest-scoring macro-regions.
• This is Sanctum Fidelis (Act III). Its position shifts per seed but is always a major, central, accessible city.
• Population: 1.5M–2.5M (scaled for narrative, not simulated)
• Must be on or adjacent to a major river AND a rail line (rail is generated later to connect to the capital, not the other way around).

Tier 2: Major Cities (4–6)

• Placed in the next highest-scoring cells, one per macro-region minimum.
• These include: Thornfield (Eastern Industrial), Fort Dustwall (Central Plains), Heartstone (Western Mountains), plus 1–3 additional cities for economy/exploration.
• Population: 30K–200K
• Must be on a river or coast.

Tier 3: Towns (15–25)

• Mid-scoring cells. Regional hubs, market towns, garrison posts.
• Population: 2K–30K
• Must be within 2 days' travel of a Tier 2 city OR on a major trade route.
• This tier includes Millhaven (Act I). Millhaven is always in the Eastern Temperate Forest, always on a river, always at least 1 day from the nearest Tier 2 city. It's small, rural, and accessible.

Tier 4: Villages & Outposts (40–80)

• Lower-scoring cells. Farming communities, mining camps, border outposts, waystations.
• Population: 50–2K
• Minimum distance from Tier 3+ settlements, but otherwise distributed by habitability score.

Tier 5: Points of Interest (100–200)

• Ruins, caves, abandoned mines, hermit dwellings, Imperium-era structures, wild shrines.
• Placed in LOW habitability cells (the interesting stuff is in the places people don't live). Mountain caves, deep forest, swamp islands, tundra ruins.
• Each PoI is tagged with: type (dungeon, ruin, landmark, resource node, secret), level range, and loot table tier.

---

Settlement Attributes — Generated Per Settlement

Each placed settlement receives procedurally generated attributes:

Demographics:

• Clade population ratio (weighted by macro-region affinity, with noise for variety). A Central Grasslands town is 60% Bovid/Cervid ± 15%. An Eastern Industrial town is more evenly mixed ± 10%. The Tangles skews toward hybrids and fringe populations.
• Hybrid population percentage (0.5%–5% in most places, 10%–30% in The Tangles and progressive urban centers).

Economy:

• Primary industry: farming, mining, manufacturing, trade, military, fishing (derived from terrain resources within the settlement's radius).
• Wealth level: poor, modest, comfortable, wealthy (derived from trade_route_potential and resource_proximity).
• Market tier: determines what equipment is available for purchase. Tier 4 villages have basic goods. Tier 1 capital has everything.

Governance:

• Government type: council, mayor, military commandant, clan elder, corporate, anarchic (weighted by Clade demographics and development level).
• Covenant enforcement: strong, moderate, weak, absent (derived from macro-region + government type + distance from capital).

Culture:

• Dominant cultural flavor: traditional Canid (hierarchical, pack-structured), traditional Cervid (communal, cautious), industrial cosmopolitan (mixed, progressive), frontier independent (libertarian, suspicious), hybrid underground (coded, communal).
• Festival calendar: each settlement has 1–3 local festivals tied to Clade traditions and seasons. These are flavor events that provide bonuses, shopping opportunities, and ambient worldbuilding.

Architecture:

• Size-dominant architecture: whose body the buildings are built for. A Bovid-majority town has wide doors, reinforced furniture, low counters. A Mustelid quarter has narrow corridors and ladder-access upper floors. Multi-Clade cities have adaptive zones.
• This affects gameplay: a Large PC in a Mustelid-scaled building has disadvantage on DEX checks. A Small PC in an Ursid district can't reach standard counters without accommodation.

Scent Profile:

• Each settlement has a generated ambient scent: industrial (coal, metal, chemical), agricultural (grain, livestock, earth), maritime (salt, fish, tar), forest (pine, decay, woodsmoke), urban dense (bodies, food, perfume, sewage).
• PCs with scent abilities experience this on arrival — atmospheric worldbuilding delivered through a sense most games ignore.

---

---

LAYER 4: INFRASTRUCTURE — ROADS, RAIL, TRADE

Road Network

Generation Method: Minimum Spanning Tree + Noise

1. All Tier 1–3 settlements become nodes in a graph.
2. Edge weights = terrain traversal cost between settlements (mountains expensive, plains cheap, rivers require bridge infrastructure).
3. Generate a Minimum Spanning Tree to ensure all settlements are connected.
4. Add 20–40% additional edges (shortcuts, alternate routes) weighted toward high-trade-potential connections.
5. Route each edge through the terrain using A* pathfinding (cheapest traversable path), creating actual road paths that follow valleys, cross rivers at narrow points, and wind through mountain passes.

Road Types:

• Footpath: connects Tier 4–5 locations. Narrow, unpaved. No wagon access.
• Dirt road: connects Tier 3–4 locations. Single-width, seasonal mud.
• Post road: connects Tier 2–3 locations. Maintained, way-stations every day's travel.
• Highway: connects Tier 1–2 locations. Paved (cobble or macadam), wide, patrolled.

Rail Network

Rail technology exists in the Late Reconciliation Era. The rail network is sparser than the road network — it represents major capital investment.

1. Capital (Tier 1) is the rail hub.
2. Rail lines extend to each Tier 2 city via the lowest-cost terrain route.
3. One additional rail line connects the easternmost port to the westernmost Tier 2 city (the transcontinental line — essential for Act IV's journey).
4. Rail does NOT extend to Tier 3 or lower settlements. Getting off the rail means switching to road, horse, or foot.

Rail stations generate at each rail-connected settlement. Stations are travel hubs: shops, inns, information boards, and pickpocket encounters.

Trade Routes

Trade routes overlay the road/rail network with economic flow:

1. Each settlement produces goods based on its economy (grain from agricultural, ore from mining, manufactured goods from industrial, fish from coastal).
2. Each settlement demands goods it can't produce locally.
3. Trade routes are generated by matching supply to demand along the transport network, weighted by distance and transport cost.
4. Active trade routes generate: merchant caravans (mobile shops, encounter opportunities), bandit activity (proportional to route wealth), and economic modifiers (settlements on busy routes are wealthier).

---

---

LAYER 5: ENCOUNTER AND CONTENT DISTRIBUTION

Overworld Encounters

The space between settlements is not empty. Encounters are distributed using a density map layered over the terrain:

Density Factors:

• Distance from settlement: closer = safer (lower encounter rate), farther = wilder
• Terrain type: deep forest, mountain, and swamp have higher base encounter rates
• Road proximity: on-road encounters are social/economic (merchants, patrols, travelers); off-road encounters are environmental/hostile
• Macro-region hostility level: frontier and poorly-governed regions have higher rates

Encounter Types:

Type	Examples	Frequency
Wildlife	Non-sentient predators, herd animals, dangerous fauna	Common (wilderness)
Traveler	Merchants, pilgrims, other adventurers, refugees	Common (roads)
Hostile	Bandits, Clade-nationalist paramilitaries, Maw agents (post Act I)	Moderate
Environmental	Weather events, terrain hazards, river crossings, cave-ins	Moderate
Social	Stranded NPC, roadside dispute, broken-down wagon, lost kit	Common (roads)
Scent Event	Unusual scent trail, predator territorial markers, fear-scent on the wind	Uncommon (flavor)
Rare Discovery	Hidden ruin entrance, Imperium artifact, wild Howl-stone, injured hybrid	Rare

Encounter Scaling: Encounters are level-scaled to the PC's current level ± 2. Wilderness encounters in high-danger zones can exceed this by +3 (the world doesn't care what level you are — wander into the deep tundra at level 3 and face consequences).

Procedural Dungeons / Points of Interest

Tier 5 PoIs (the 100–200 scattered locations) are generated using modular room templates:

Dungeon Types:

• Imperium Ruin: stone corridors, coliseum-adjacent architecture, old traps, undead or feral non-sentient occupants. Loot: Imperium-era artifacts, historical documents.
• Abandoned Mine: tunnels, cave-ins, mineral deposits, possible Mustelid or Ursid former inhabitants. Loot: ores, gems, mining equipment, occasionally alchemical reagents.
• Cult Den: Clade-nationalist hideout, rawfang cult lair, or black-market lab. Sentient hostiles. Loot: intelligence, contraband, pheromone compounds.
• Natural Cave: wildlife dens, geological features, underground rivers. Loot: natural resources, rare herbs, fossils.
• Overgrown Settlement: abandoned village reclaimed by wilderness. Environmental storytelling — why did they leave? Loot: domestic goods, letters, cultural artifacts.

Modular Room Templates: Each dungeon type has 30–50 pre-designed room templates (authored, not generated) that are assembled procedurally:

1. Select dungeon type based on PoI's terrain and macro-region.
2. Determine dungeon size based on level range (small: 3–5 rooms, medium: 6–10, large: 11–20).
3. Select entry room template.
4. Connect rooms using a graph — linear for simple dungeons, branching for complex. Dead-ends contain loot or lore. Branches reconnect for loop options.
5. Populate rooms from encounter tables appropriate to dungeon type and level.
6. Place loot using tier-weighted random tables.
7. Assign one room as "narrative room" — contains environmental storytelling (letters, journals, scent-traces, bodies arranged to tell a story) that enriches worldbuilding even without connecting to the main quest.

Clade-Responsive Design: Dungeon architecture reflects who built it. Mustelid tunnels are tight (Large PCs squeeze). Ursid ruins are vast (Small PCs feel exposed). Cervid-built spaces have high ceilings and wide corridors. Bovid structures are reinforced, heavy, low. This isn't decoration — it affects traversal mechanics and forces PCs to engage with the body-diversity premise of the world.

---

---

LAYER 6: NARRATIVE ANCHOR SYSTEM

The Problem

The main quest (The Reckoning of Mouths) has fixed story beats that expect specific locations: Millhaven, Thornfield, Fort Dustwall, The Tangles, Sanctum Fidelis, Heartstone. But the world is procedurally generated. How do we guarantee the story works while the map changes?

The Solution: Narrative Anchors

Narrative Anchors are abstract requirements that the settlement placement system must satisfy. They are NOT fixed coordinates — they are constraints.

Anchor	Requirements	Assigned To
MILLHAVEN	Tier 3 town. Eastern Temperate Forest. On a river. 1–2 day travel from nearest Tier 2. Rural, agricultural, multi-Clade but Canid-leaning.	Act I start
THORNFIELD	Tier 2 city. Eastern Industrial Belt. On a river or rail line. Industrial economy. Dense population. Mustelid-heavy workforce.	Act II (Name 1)
FORT_DUSTWALL	Tier 2–3 settlement. Central Grasslands, near border of a Clade-majority zone. Military. On a road, not necessarily rail. Bovid/Cervid region.	Act II (Name 2)
THE_TANGLES	Macro-region (not a single settlement). Subtropical Lowlands. Low Covenant enforcement. Contains 2–4 Tier 4 settlements + Thornback Hollow (Tier 4, hybrid community).	Act II (Name 3)
SANCTUM_FIDELIS	Tier 1 capital. Central-eastern continent. Major river + rail hub. Maximum multi-Clade diversity. Contains: Fang & Claw Hall, Scent Market district, Hybrid Quarter (The Splits).	Act III
HEARTSTONE	Tier 2 city. Western Mountains. High elevation. Ancient architecture. Not on rail (must be reached by road for final leg). Neutral ground.	Act V

Placement Priority: Narrative Anchors are placed FIRST, before general settlement distribution. The algorithm:

1. Identify all terrain cells matching each Anchor's requirements.
2. Score matching cells by how well they satisfy requirements.
3. Place Anchors at highest-scoring cells, with minimum-distance constraints between Anchors (they can't cluster — the story needs continental span).
4. Generate remaining settlements around the Anchors, treating Anchor settlements as pre-placed nodes in the settlement graph.

Internal Content: Each Anchor settlement has hand-authored internal content (quest-relevant NPCs, specific buildings, story-critical locations) that generates inside the settlement regardless of the procedural exterior. The slaughterhouse in Sanctum Fidelis exists every playthrough — but its address in the city changes. The observatory above Heartstone exists every playthrough — but which peak it sits on depends on the mountain generation.

Think of it as: the rooms are authored, but the building's floor plan is generated.

---

Quest Path Generation

The main quest requires travel between Anchors. The path the PC takes is generated by the road/rail network:

1. Act I → Act II: Millhaven to Thornfield (road + possible rail).
2. Act II (open order): Thornfield ↔ Fort Dustwall ↔ The Tangles. Three-hub travel. Road and rail connections vary per seed. Some playthroughs, Fort Dustwall is a short rail trip from Thornfield. Others, it's a 4-day overland trek. This variance is a feature — different playthroughs feel different in pacing and encounter exposure.
3. Act III: Any Hub → Sanctum Fidelis. Rail is likely available for at least part of this journey.
4. Act IV: Sanctum Fidelis → Heartstone. Cross-continent. This is always a long journey because Heartstone is in the western mountains and rail doesn't reach it. The "Long Road West" is long by design — the procedural system guarantees this by placing Heartstone beyond rail terminus.
5. Act V: Already at Heartstone.

Travel Events: The content the PC encounters between Anchors is procedurally populated from the encounter system (Layer 5). Each journey segment generates: road encounters, off-road discoveries, settlement stops (for resupply, side quests, rest), and terrain challenges (river crossings, mountain passes, weather events).

---

---

LAYER 7: FACTION TERRITORY

Dynamic Faction Presence

Three factions (Inheritors, Thorn Council, Covenant Enforcers) have procedurally generated territorial influence:

Faction Influence Map: Each faction has a set of seed points (placed at appropriate settlements and PoIs) that radiate influence outward, decaying with distance. Influence maps overlay the world map, creating zones of control:

• Covenant Enforcers: Strongest near the capital, Tier 1–2 cities, and military outposts. Decays toward frontier regions.
• Inheritors: Strongest in predator-Clade-majority zones, rural regions, border territories. Anti-correlated with Covenant enforcement (strong where law is weak).
• Thorn Council: Strongest in prey-Clade-majority zones and progressive urban centers (paradoxically — they recruit from the educated and frightened). Moderate presence in The Tangles.

Gameplay Effect:

• In Enforcer zones: law is present, crimes are investigated, Covenant violations are prosecuted. Hostile encounters are rarer. Authority can be leveraged.
• In Inheritor zones: predator-Clade NPCs are more aggressive, prey-Clade NPCs are more fearful, black-market goods are available, Clade-nationalist propaganda is visible.
• In Thorn Council zones: prey-Clade NPCs are organized and suspicious of predators, hybrid NPCs face extra scrutiny, separatist rhetoric is mainstream.
• In unclaimed zones (frontier, wilderness): no faction dominates. Encounters are more random, law is self-made, and the PC's Clade identity matters more for individual interactions.

Dynamic Shift: Faction influence changes based on story progress. After Act II's Fort Dustwall events, Inheritor influence expands in the central plains (emboldened by the incident). After Act III's slaughterhouse raid, Enforcer presence tightens in the capital (crackdown). After Act IV choices, influence maps shift to reflect political outcomes. This gives the procedural world a sense of responding to the narrative.

---

---

LAYER 8: WEATHER AND SEASONAL SYSTEMS

Seasonal Cycle

The game spans approximately 3–4 months of in-world time (autumn through early winter). Seasons affect:

• Temperature: northern regions grow colder, travel becomes harder, tundra becomes impassable by late game. Southern regions remain mild. Clade-specific effects (Polar Ursid advantage, lion-folk heat lethargy becomes irrelevant in cold).
• Daylight: northern regions lose daylight hours, affecting visibility and encounter types (nocturnal predators more active). Southern regions maintain longer days.
• Precipitation: autumn rains swell rivers (crossing difficulty increases), mountain passes accumulate snow (Act IV's westward journey gets harder as the story progresses — built-in narrative pressure).
• Shedding cycles: relevant for thick-coated species. Narrative flavor, minor mechanical effects (Stealth disadvantage from shed fur trails if not groomed).
• Antler shed: Cervid characters experience the 2-month shed window during the game timeline. Mechanical impact per species rules.

Weather Generation

Daily weather generated per region using Markov chains seeded by season and biome:

Biome	Autumn Weather Probabilities
Temperate Forest	Clear 30%, Overcast 30%, Rain 25%, Storm 10%, Fog 5%
Grassland	Clear 40%, Windy 25%, Overcast 20%, Rain 10%, Storm 5%
Mountain	Clear 20%, Overcast 20%, Rain 15%, Snow 25%, Storm 15%, Fog 5%
Subtropical	Clear 25%, Humid 25%, Rain 30%, Storm 15%, Fog 5%
Tundra	Clear 15%, Overcast 20%, Snow 35%, Blizzard 20%, Fog 10%

Weather affects: visibility, travel speed, encounter rates, scent range (rain suppresses scent, dry cold amplifies it), and combat conditions (mud, wind, snow).

---

---

LAYER 9: SEED SYSTEM AND REPRODUCIBILITY

World Seed

A single integer seed generates the entire world deterministically. Same seed = same world, every time. This allows:

• Sharing seeds between players ("Try seed 47291 — the mountain pass in Act IV is brutal")
• Speedrun consistency (fixed seed category)
• Bug reproduction
• "Daily challenge" seeds

Seed → Generation Pipeline

SEED
 │
 ├─ Terrain Gen (elevation, moisture, temperature)
 │   └─ Uses seed directly for noise generation
 │
 ├─ Hydrology (rivers, lakes, coastline)
 │   └─ Derived from terrain + seed offset for drainage sources
 │
 ├─ Settlement Placement
 │   └─ Narrative Anchors first (deterministic from terrain)
 │   └─ General settlements (seed-based selection from scored candidates)
 │
 ├─ Infrastructure (roads, rail, trade)
 │   └─ Derived from settlement graph + terrain costs
 │
 ├─ Encounter Distribution
 │   └─ Seed-based density + level scaling
 │
 ├─ Dungeon Generation
 │   └─ Seed offset per PoI for room selection and population
 │
 ├─ Faction Influence
 │   └─ Derived from settlement demographics + seed-based variation
 │
 └─ Weather
     └─ Seed-based Markov chains per region per day

Performance Budget

World generation should complete in under 60 seconds on target hardware. Heaviest operations: terrain generation (noise computation), erosion simulation (if included), and road pathfinding (A* over large graph). All are parallelizable.

Streaming: The full continent does not need to be fully detailed at boot. Generate at low resolution first (macro-regions, Tier 1–2 settlements, rail network), then detail regions as the player approaches them (Tier 3–5 settlements, encounter placement, dungeon generation). This amortizes the cost across play sessions.

---

---

SUMMARY: WHAT CHANGES VS. WHAT STAYS

Always the Same (Authored)

• Continental macro-biome layout (east/west/north/south character)
• Narrative Anchor requirements (Millhaven is always rural eastern forest, etc.)
• Main quest structure (5 acts, same story beats)
• Quest-critical NPC roster and their roles
• Internal content of Anchor settlements (quest buildings, NPCs, events)
• Clade-to-biome affinity rules
• Room templates for dungeons

Always Different (Procedural)

• Exact coastline, mountain contours, river courses
• Specific placement of all settlements (including Anchors — they move within their allowed macro-region)
• Road and rail network topology
• Distance and travel time between quest locations
• Overworld encounter content between Anchors
• Dungeon layouts (assembled from templates)
• Settlement demographics (within weighted ranges)
• Weather sequences
• Faction influence boundaries
• Trade route patterns and economic modifiers
• Points of Interest placement and content

The Player Experience

First playthrough: "I traveled two days by rail from Thornfield to reach the capital, crossing a river valley full of Cervid farmland."

Second playthrough: "The rail didn't connect Thornfield to the capital this time — I had to ride overland through a mountain pass I'd never seen before, and got ambushed by Inheritor scouts in a snowstorm."

Same story. Different world. That's the goal.

---

Document Version 1.0 — Theriapolis Procedural World Generation Design Compiled by ENI for LO