# TECHNICAL SPECIFICATION: WORLD MAPS, DUNGEONS & SECRET CHAMBERS
# FREEEXILE PROJECT: GRIMDARK SAVAGE EXILE ARPG 2.5D

> **Departments**: Art & UI/UX Director, Server Systems Architect, Lead Game Designer, Localization Lead.  
> **Document Version**: 2.0.0-RELEASE (Savage Primal Deadlands Standard)  
> **Applies to**: [ZoneEngine](file:///c:/Projects/FreeExile/server/world/zone_engine.py), [ZoneCatalog](file:///c:/Projects/FreeExile/server/world/zone_catalog.py), [Web Simulator](file:///c:/Projects/FreeExile/client/webapp/index.html), [Protobuf Protocol](file:///c:/Projects/FreeExile/proto/map_zone.proto).

---

## 1. GEOGRAPHIC ARCHITECTURE

FreeExile features a brutal 2.5D Isometric dark survival universe structured into three tiers:
1. **10 Canonical Zones**: Interlinked via boundary passages and fast-travel Wayposts.
2. **Authoritative Dungeon Instances**: `The Beast-Sealing Depths` (50 Floors) and `The Void Abattoir` (100 Floors).
3. **Cryptic Secret Chambers**: Spawning dynamically through near-death survival feats and auto-collapsing over time.

---

## 2. THE 10 CANONICAL WORLD ZONES

1. **The Outcast Encampment (`zone_boundless_sanctuary`)**: Safe Haven (Lv 1-100), combat prohibited. Houses The Outcast Bazaar, Bone-Crafting Forges, and Milestone Boards.
2. **The Bone Strand (`zone_tang_kiem_nhai`)**: Starting Shoreline (Lv 1-10). Rugged shoreline littered with shipwreck wreckage, bone hounds, and a bloodstained altar.
3. **The Putrid Fens (`zone_ancient_sword_barrow`)**: Toxic Miasma Bog (Lv 8-20). Rotting peat bogs and foul miasma haunted by reanimated corpses.
4. **The Bone Wastes (`zone_boundless_sandstorm`)**: Desert Wilderness (Lv 20-35). Violent sandstorm hazards and fossilized colossus bones concealing the Ancient Runic Stele.
5. **The Slaughter Ruins (`zone_blood_scale_ruins`)**: Void Corruption (Lv 30-45). Ancient sacrificial grounds triggering the Serpent-Step Bone Crypt upon near-death evasion.
6. **The Primal Altar (`zone_five_elements_altar`)**: Primal Totem Nexus (Lv 40-55). Five monolithic animal totems (Tiger, Viper, Bear, Wolf, Mammoth) concealing the underground core.
7. **The Abyssal Bile Mire (`zone_abyssal_ice_pond`)**: Freezing Bile Chill (Lv 50-65). Toxic marsh, lair of the [Abyssal Bile Fiend](file:///c:/Projects/FreeExile/wiki/en/MONSTERS_AND_BOSSES_SPECS.md#41-abyssal-bile-fiend).
8. **The Gorge of the Starved (`zone_infinite_blood_rift`)**: Desolate Bone Chasm (Lv 60-75). Sheer canyon walls filled with bone drifts, lair of the [Gorging Bone-Beast](file:///c:/Projects/FreeExile/wiki/en/MONSTERS_AND_BOSSES_SPECS.md#42-gorging-bone-beast).
9. **The Bloodforge Caldera (`zone_purgatory_lava_cavern`)**: Scorching Magma Caldera (Lv 70-85). Roaring lava caldera, lair of the [Obsidian Magma Behemoth](file:///c:/Projects/FreeExile/wiki/en/MONSTERS_AND_BOSSES_SPECS.md#44-obsidian-magma-behemoth).
10. **The Apex of Slaughter (`zone_boundless_celestial_palace`)**: Void Spire (Lv 85-100). Jagged pinnacle throne, lair of the First Exile: [Blood-Crazed Warlord: Duan the Solitary](file:///c:/Projects/FreeExile/wiki/en/MONSTERS_AND_BOSSES_SPECS.md#43-blood-crazed-warlord-duan-the-solitary).

---

## 3. DUNGEON INSTANCES

- **The Beast-Sealing Depths (`inst_phong_ma_co_tran`)**: 50 layers, 30 min limit, 3 revive lives. Boss at layer 50: Abyssal Bile Fiend. Rewards 40 Primal Bloodstones, 8 Ancient Bone Brands, +12 Meridian Points, title *Beast Slayer*.
- **The Void Abattoir (`inst_bi_canh_hu_khong`)**: 100 layers, 60 min limit, Hardcore (1 life). Boss at layer 100: Primordial Flame Fiend. Rewards 2 Savage Blood Mirrors, 150 Primal Bloodstones, +30 Meridian Points, title *Peerless Survivor*.
- **The Savage Pit (`inst_van_gioi_thi_luyen`)**: 3 waves, 10 min limit, 3 lives.

---

## 4. 4 CRYPTIC SECRET CHAMBERS

1. **Serpent-Step Bone Crypt (`secret_huyen_anh_to_su`)**: Triggered at The Slaughter Ruins with HP < 10% and Phantom Evasion. 10 min countdown. Awards title *Phantom Step Master*.
2. **The Fallen Warlord Tomb (`secret_tan_bi_than_tuong`)**: Triggered in the Bone Wastes by offering Bone Spikes at Stele. 15 min countdown. Awards title *Undying Battle Spirit*.
3. **The Primal Totem Core (`secret_ngu_hanh_tran_nhan`)**: Triggered by attuning all 5 primal totems in resonance. Awards title *Primal Beast Sovereign*.
4. **The Rust-Blade Sepulcher (`secret_tang_kiem_kiem_chung`)**: Triggered by cleansing rusted savage blade at midnight. Awards title *Blood Blade Immortal*.
