Zone Hierarchy

The world is organized in layers, from safe home zones to punishing endgame content:

Your Hideout (personal safe zone)
  └─ Portal to the World Hub

World Hub (central meeting point)
  ├─ Portal back to Hideout
  ├─ Starter Zone (tutorial area, no enemies)
  └─ Combat Zones (enemies present, level-scaled)
       ├─ Entry Zones (large, accessible from World Hub)
       │    ├─ Middle Zones (smaller, higher density)
       │    │    └─ Endcap Zones (smallest, maximum difficulty)
       │    └─ Direct sub-zones
       └─ Endgame Zones (level 100+, modifier-enabled)

Key rule: You can only exit your hideout through the World Hub portal. No zones connect directly to the hideout.

Zone Chain Pattern

Zones are organized in progressive difficulty chains within biomes:

World Hub → Entry Zone (10×10) → Middle Zone (5×5) → Endcap Zone (3×3)

Layer	Grid Size	What to Expect
Entry	10×10	Large area to explore, moderate difficulty
Middle	5×5	Maze-like layout, higher enemy density
Endcap	3×3	Maximum difficulty, boss encounters, best loot

Each zone has a parent zone you can return to.

Implemented Zone Chains (171 total zones)

Major zone chains with full 3-layer depth:

Chain	Entry Zone (Level)	Middle Zone	Endcap Zone
Trevmarch Castle	Trevmarch Castle (L1)	Second Floor (L3) → Third Floor (L5)	Commander Sanctum (L10)
Catacombs	Crumbling Catacombs (L6)	Ossuary (L7) → Depths (L8)	Lich Tomb (L9, BOSS_ROOM)
Blighted Marshes	Blighted Marshes (L7)	Sunken Village (L8)	Hag Lair (L10)
Scorched Borderlands	Scorched Borderlands (L10)	Corrupted Forest (L13)	Demon Encampment (L15)
Abandoned Mine	Abandoned Mine (L12)	Lower Shafts (L13) → Crystal Cavern (L14)	Deep Horror (L16)
Iron Mines	Iron Mines (L16)	Ancient Foundry (L17) → Automaton Hall (L19)	Iron Core (L20)
Shattered Keep	Shattered Keep (L18)	Haunted Armory (L19) → Keep Dungeon (L20)	Phantom Tower (L22)
Wailing Crypts	Wailing Crypts (L20)	Banshee Hall (L21) → Burial Vault (L23)	Death Throne (L24)
Frozen Wastes	Frozen Wastes (L23)	Ice Caves (L24) → Frost Citadel (L26)	Glacier Heart (L28)
Petrified Forest	Petrified Forest (L25)	Stone Grove (L26) → Gorgon Lair (L28)	Basilisk Den (L30)
Desert	Sunscorched Dunes (L28)	Bone Wastes (L30)	Buried Necropolis (L33)
Jungle	Venomous Thicket (L29)	Serpent Temple (L31)	Canopy Abyss (L34)
Screaming Hollows	Screaming Hollows (L36)	Echo Chamber (L37) → Nightmare Pit (L39)	Void Maw (L40)
Iron Sepulcher	Iron Sepulcher (L40)	Judgment Hall (L41) → Soul Forge (L43)	Death Engine (L44)
Void Cathedral	Void Cathedral (L42)	Corrupted Nave (L43) → Bell Tower (L45)	Void Sanctum (L46)
Dread Citadel	Dread Citadel (L49)	War Room (L49) → Throne Approach (L50)	Dark Lord Throne (L50)

Mid-Range Variety Branches (Levels 11-40)

Most L11-40 levels only had 2 zones each, so players saw the same one or two places at each level band. Six new single-square branch zones were added off existing same-level zones to give each band a real alternative path — distinct biome, hazard, and boss flavor, never duplicating an existing same-level zone's theme:

New Zone (Level)	Attached To	Theme	Boss
Silkweb Hollow (L14)	Abandoned Chapel (3,3)	Spider-choked woodland hollow, shrine to a spider queen	The Widow's Wail (spirit)
Sunken Shipwreck (L18)	Shattered Keep (5,5)	Beached pirate wreck in a sea cave, has an NPC (Old Salt Garrick)	Captain Merrow (undead revenant)
Crumbling Coliseum (L22)	Ashen Ruins (2,8)	Ruined gladiator arena, Champion's memorial wall	The Champion's Ghost (spirit)
Rustwind Millworks (L27)	Tower Approach (1,6)	Abandoned windmill/grain-mill farmstead	The Grain King (beast)
Drowned Sanctum (L32)	Fungal Depths (0,8)	Flooded jungle temple, blinded coral idol shrine	The Sunken Prophet (aberrant)
Gearwood Asylum (L37)	Corpse Gardens (8,8)	Abandoned clockwork sanatorium, taunting warden's plaque	Warden Ashcombe (undead)

Each is a standalone 6x6 branch zone (36 squares) reachable via a single transition from its parent zone, with its own return transition — not part of a 3-layer entry/middle/endcap chain. Zone count is now 171 total.

Standalone Zones (no children, accessible from World Hub)

• L1-L10: Starter Zone, Forest Path, Farmstead Ruins, Muddy Fens, Bandit Hideout, Gallows Hill, Moonlit Grove
• L11-L20: Flooded Barracks, Goblin Warrens, Haunted Manor, Frost-Touched Pass, Plagued Warrens, Crimson Mire
• L21-L30: Obsidian Fields, Ashen Ruins, Shadow Bazaar, Twisted Thicket, Ember Foundry, Tower Approach, Ruined Watchtower, Serpent Marsh
• L31-L50: Cursed Battlefield, Blighted Canopy, Fungal Depths, Tomb of Echoes, Void Rift, Ashen Wastes, Burning Gorge, Wailing Caverns, Corpse Gardens, Fracture Plains, Shattered Observatory, Plague Quarters, Titans Rest, Titan Graveyard, Hellforge, Crystal Labyrinth, Plague Throne, Starfall Crater, Drowned Armada, Ghost Fleet, Madness Spiral, Oblivion Gate

High-Level Zones (L51-L99)

Shadow Realm Gate (L51), Shattered Nexus (L53), Abyssal Trench (L55), Temporal Ruins (L57), Crimson Wasteland (L59), Wraithwood (L61), Dragon Boneyard (L63), Corrupted Heavens (L65), Siege of Eternity (L67), Molten Core (L69), Verdant Corruption (L71), Forsaken Colosseum (L73), Crystallized Abyss (L75), Plague Hollow (L77), Sunken Cathedral (L79), Iron Titan Foundry (L81), Void Spire (L84), Demon Nursery (L87), Soul Harvest Fields (L90), Entropy Garden (L93), Annihilation Threshold (L96), Edge of Oblivion (L99)

Endgame Zones (L100, modifier-enabled)

16 zones with modifier support for infinite scaling: Apocalypse Engine, Blood Ocean, Clockwork Purgatory, Crucible of Souls, Eternal Abyss, Flesh Nexus, Garden of Inverse Stars, Hive Overmind, Hollow Crown, Infinity Gate, Nightmare Core, Primordial Maw, Shattered Mirror Realm, The Unwritten, Weeping Archive, Worlds End

Town/Social Zones

Zone	Level	Purpose
Lonely Dog Inn	1	Social hub, meeting players
Trevmarch Market	1	Shopping district
Trevmarch Prison	2	Quest area
Trevmarch City	5	Major city hub
Hall of Records	5	Lore and history
Thieves Guild	15	Rogue-focused content
Shadow Bazaar	24	High-level shopping

Terrain / Location Types

Type	Passable	Description
Normal	Yes	Open ground — the default terrain
Wall	No	Stone walls, barriers
Underbrush	No	Dense vegetation
Water	No	Deep water
Fire	No	Active flames
Chasm	No	Bottomless void
Locked Door	No	Requires a key or skill check

Zone Modifiers (Endgame Scaling)

In endgame zones (level 100), you can activate modifiers before entering. Modifiers make enemies harder but dramatically increase loot quality. Stack multiple modifiers for greater risk and greater reward.

This is how endgame progression works: Your character caps at level 100, but modifier-scaled zones produce enemies at effective levels 110, 120, 140+ — dropping gear at those higher levels that you can equip.

8 Modifiers

Modifier	What It Does	Loot Bonus
Empowered	Enemies have +25% more HP	+15%
Frenzied	Enemies deal +20% more damage	+15%
Endless	Enemies respawn after death	+25%
Cursed	Your healing is reduced by 20%	+20%
Nightmare	Visibility is severely reduced	+10%
Bloodlust	Enemies heal 10% of damage they deal	+30%
Void Touched	Random teleportation events	+20%
Death's Door	Potions don't recharge between encounters	+40%

Modifier Stacking

You can stack multiple modifiers for additive bonuses. Each endgame zone has a pool of 4-8 available modifiers — only the zone's pool can be applied (you can't use any modifier on any zone).

Worlds End is unique: it offers all 8 modifiers, for a maximum combined loot bonus of +175%.

Risk/Reward Examples

• Death's Door alone: +40% loot, but you must manage potions carefully between fights
• Empowered + Frenzied + Bloodlust: +25% enemy HP, +20% damage, enemies self-heal, +60% loot
• All 8 on Worlds End: Maximum possible challenge, maximum possible reward

Trap System

Traps are hidden hazards placed throughout dungeons. Your Trap Detection skill gives you a chance to spot them before triggering. Your Trap Disarm skill gives you a chance to safely remove detected traps.

Physical Traps

Trap	Effect
Spike Trap	Moderate physical damage
Bear Trap	High damage, immobilizes you
Blade Trap	Very high damage
Arrow Trap	Moderate ranged damage
Net Trap	Low damage, restrains movement
Crushing Trap	Extreme damage

Elemental Traps

Trap	Effect
Fire Trap	Burns you for ongoing fire damage
Frost Trap	Cold damage and slows movement
Lightning Trap	Lightning damage, chance to stun
Poison Gas Trap	Ongoing poison damage
Acid Trap	Damage + reduces your armor

Magical/Cursed Traps

Trap	Effect
Curse Trap	Applies stat debuffs
Mana Drain Trap	Reduces Intelligence temporarily
Soul Trap	Chaos damage + reduces max HP
Teleport Trap	Random teleport within the zone
Confusion Trap	Reverses your movement controls

Alarm/Summoning Traps

Trap	Effect
Alarm Trap	Attracts nearby enemies
Summoning Trap	Spawns additional enemies

Trap Mechanics

Traps are hidden hazards placed on zone squares. When a player steps onto a trapped square, a detection-disarm-trigger sequence runs automatically. Traps are generated per-zone based on a configurable density percentage.

Trap Lifecycle (4 States)

HIDDEN → (detection check) → DETECTED → (disarm check) → DISARMED
                 ↓ fail                       ↓ fail (30% chance)
              TRIGGERED                    TRIGGERED

State	Meaning
HIDDEN	Trap is invisible — will trigger if player fails passive detection
DETECTED	Player spotted the trap — can attempt disarm or step back
DISARMED	Trap is safe — no longer dangerous
TRIGGERED	Trap has fired — damage applied, trap consumed

On-Enter Sequence

When a player moves onto a square with a trap (handleTrapOnSquare()):

1. Skip if trap is already DISARMED or TRIGGERED
2. Passive detection (if HIDDEN): (detectionChance/2 + d100) >= detectionDifficulty
   • Success: trap becomes DETECTED, player sees description, proceeds to disarm
   • Fail: trap TRIGGERS immediately, damage applied
3. Disarm attempt (if DETECTED): (disarmChance + d100) >= disarmDifficulty
   • Success: trap becomes DISARMED, player passes safely
   • Fail: 30% chance to trigger trap, 70% chance to fail safely ("you step back")

Detection Formula

baseChance = (intelligence * 0.6 + agility * 0.4) / 5
classBonus = +15 (Rogue) | +5 (Sorcerer) | 0 (others)
explorationBonus = stats.explorationTrapDetectionBonus (from gear/class)
totalDetectionChance = min(100, max(0, baseChance + classBonus + explorationBonus))

Active detection:  (totalDetectionChance + d100) >= detectionDifficulty
Passive detection: (totalDetectionChance/2 + d100) >= detectionDifficulty

Passive detection is half as effective as active detection.

Disarm Formula

baseChance = (agility * 0.7 + intelligence * 0.3) / 5
classBonus = +20 (Rogue) | -5 (Fighter) | 0 (others)
explorationBonus = stats.explorationTrapDisarmBonus (from gear/class)
totalDisarmChance = min(100, max(0, baseChance + classBonus + explorationBonus))

Disarm check: (totalDisarmChance + d100) >= disarmDifficulty
Failed disarm: 30% chance to trigger trap

Difficulty Scaling

Detection and disarm difficulties scale with zone level:

Property	Formula	Range
Detection difficulty	10 + (zoneLevel / 2)	10 - 85
Disarm difficulty	15 + (zoneLevel / 2)	15 - 90

Disarm is always harder than detection by +5 base difficulty.

Trap Damage Formula

baseDamage = (10 + zoneLevel * 5) * typeMultiplier

Damage Tier	Multiplier	Trap Types
Extreme	2.0x	Crushing Trap, Blade Trap
High	1.5x	Bear Trap, Lightning Trap
Moderate	1.0x	Spike Trap, Arrow Trap, Fire Trap, Acid Trap
Low	0.75x	Frost Trap, Poison Gas Trap, Curse Trap
Utility	0.5x	Net Trap, Mana Drain Trap
None	0.0x	Alarm Trap, Summoning Trap

Example: Zone Level 50, Blade Trap = (10 + 250) * 2.0 = 520 damage

18 Trap Types — Full Reference

Physical Traps (6)

Trap	Damage Tier	Special Effect	Description
Spike Trap	Moderate (1.0x)	None	Sharp spikes ready to spring from the ground
Bear Trap	High (1.5x)	Immobilizes	Heavy iron jaws waiting to clamp shut
Blade Trap	Extreme (2.0x)	None	Concealed blades primed to swing
Arrow Trap	Moderate (1.0x)	Ranged	Hidden mechanism loaded with arrows
Net Trap	Utility (0.5x)	Restrains movement	Weighted net ready to drop
Crushing Trap	Extreme (2.0x)	None	Suspended weight poised to fall

Elemental Traps (5)

Trap	Damage Tier	Special Effect	DoT Duration
Fire Trap	Moderate (1.0x)	Ongoing fire damage	2-4 rounds
Frost Trap	Low (0.75x)	Slows movement	None
Lightning Trap	High (1.5x)	Chance to stun	None
Poison Gas Trap	Low (0.75x)	Ongoing poison damage	2-4 rounds
Acid Trap	Moderate (1.0x)	Reduces armor, ongoing damage	2-4 rounds

Magical/Cursed Traps (5)

Trap	Damage Tier	Special Effect
Curse Trap	Low (0.75x)	Applies stat debuffs
Mana Drain Trap	Utility (0.5x)	Reduces Intelligence temporarily
Soul Trap	Moderate*	Chaos damage + reduces max HP temporarily
Teleport Trap	None	Random teleport within zone
Confusion Trap	None	Reverses movement controls

*Soul Trap uses default 1.0x multiplier per the switch statement fall-through.

Alarm/Summoning Traps (2)

Trap	Damage Tier	Special Effect
Alarm Trap	None (0.0x)	Attracts nearby enemies
Summoning Trap	None (0.0x)	Spawns additional enemies

DoT Traps

Three trap types apply damage over time: Fire Trap, Poison Gas Trap, and Acid Trap. Their DoT duration is randomized: 2 + random(0-2) = 2 to 4 rounds.

Trap Generation

Traps are generated per-zone when the zone is first created:

trapsToGenerate = ceil(totalSquares * (trapDensity / 100.0))

• Traps are randomly placed on available squares
• Squares with blocked terrain, interactions, or starting position (10,10) are excluded
• Trap type is uniformly random from all 18 types
• All traps start in HIDDEN state

Zone Difficulty Warnings

When you enter a zone significantly above your level, the game warns you:

• Zone is 5+ levels above you: "Warning: extremely dangerous!" — turn back or be prepared
• Zone is 1-4 levels above you: "Caution" — challenging but manageable
• Zone is at or below your level: No warning shown

Region Hub Pattern (Zone Growth, 2026-07-22)

As Darkness Falls grows, new zones need somewhere to plug into the world. The 12x12 World Map has a fixed number of squares, and content growth can fill it up faster than expected.

Region Hubs solve this: instead of adding every new zone directly to the World Map, related zones are grouped by level band into a themed waypoint. The World Map carries ONE portal to the hub; the hub itself has room for dozens more zones as that level band grows.

Region Hub	Level Band	Reached From World Map
Northern Waystation	1-10	(8,1)
Ashfall Crossing	11-20	(11,2)
The Sundered Waypost	21-30	(1,3)
Duskmere Concourse	31-50	(2,3)
The Hollow Convergence	51-99	(1,4)

Each hub works exactly like any other zone — walk in, explore, walk out — it just happens to be a waypoint that future zones will branch off from, the same way Trevmarch City already branches into Hall of Records and the Thieves Guild.