# TECHNICAL SPECIFICATION: PLAYER ASTRAL HIDEOUT & WAYGATES
## PRIVATE SANCTUM, 6-PORTAL ASTRAL MAP DEVICE & WORLD TELEPORTATION GATES
*(Copyright FreeExile Project 2026 - Path of Exile 2 Hideout & Endgame Waygate Model)*

---

### 1. SYSTEM OVERVIEW
In the **FreeExile** universe, the **Player Astral Hideout (Tiên Phủ Động Thiên)** represents each cultivator's absolute private sanctuary. It serves as the staging base where players prepare gear, craft spirit stones, unlock astral meridians, and access dimension portals to venture across the realm:
- **Server-Authoritative Private Sanctum**: Isolated instance partition with zero monster spawns, zero PvP, and zero risk of item loss.
- **Tri-Portal Dimensional Architecture**:
  1. **Astral Map Device (PoE2 6-Portal Model)**: Hexagonal altar summoning exactly 6 Void Portals for Tier 1 to 16 endgame map dungeons.
  2. **World Exploration Portal**: Direct waygate connected to the 10 Canonical Open World Zones.
  3. **Quest & Bounty Waygate**: Direct portal synchronized with active story objectives and boss hunt bounties.

---

### 2. ASTRAL MAP DEVICE (6-PORTAL ENDGAME ENGINE)
Built according to the industry-standard Map Device mechanic in *Path of Exile 2*:
- **Strict 6-Portal Invariant**:
  - Activating an Astral Map Tablet summons exactly **6 swirling purple void portals** arranged in a regular hexagon ($R = 4.2\text{m}$).
  - Each portal traversal by the player or party members consumes 1 portal ($6 \to 5 \to 4 \dots \to 0$).
  - Death inside the map respawns the character in the hideout, requiring consumption of another portal to re-enter.
  - When all 6 portals are exhausted, the map collapses permanently, preserving hardcore risk-reward balance.
- **Astral Map Tiers**:
  - **White Tier (Tier 1 - 5)**: Monster Lv. 68 - 72, $+15\%$ Spirit Stone Drop Quantity.
  - **Yellow Tier (Tier 6 - 10)**: Monster Lv. 73 - 77, $+25\%$ Spirit Stone Drop, 1 Elite Affix Monster.
  - **Purple Tier (Tier 11 - 15)**: Monster Lv. 78 - 82, $+40\%$ Drop Quantity, Divine Commander Charms.
  - **Astral Pinnacle Tier (Tier 16)**: Monster Lv. 83 - 85+, Ancient Demon Overlord, drops Void Mirrors and Gold Relics.

---

### 3. WORLD EXPLORATION PORTAL
A monumental portal emitting an azure glow (`#38bdf8`) connected to the 10 Canonical Open World zones:
1. **Sword Tomb Cliff (Lv. 1-10)**: Awakening grounds.
2. **Ancient Sword Barrow (Lv. 8-20)**: Rusting blades and poison mist.
3. **Boundless Sandstorm (Lv. 20-35)**: Arid wasteland and dust storms.
4. **Blood Scale Ruins (Lv. 30-45)**: Dragon scale ancient formations.
5. **Five Elements Altar (Lv. 40-55)**: Elemental earth leyline matrix.
6. **Abyssal Ice Pond (Lv. 50-65)**: Glacial frost and biting cold.
7. **Infinite Blood Rift (Lv. 60-75)**: Bleeding spatial rift.
8. **Purgatory Lava Cavern (Lv. 70-85)**: Boiling magma crater.
9. **Boundless Celestial Palace (Lv. 85-100)**: Mythical palace above the clouds.

---

### 4. QUEST & BOUNTY WAYGATE
A golden portal (`#fbbf24`) synchronized in real time with the [QuestEngine](file:///c:/Projects/FreeExile/server/world/quest_engine.py):
- Automatically displays the active quest title and target zone.
- Instantly teleports the player directly adjacent to the quest objective coordinates.
- Supports Story Quests, Demon Bounties, and Cryptic Secret Chambers.

---

### 5. DOMESTIC HIDEOUT FACILITIES
1. **Consignment Vault & Seasonal Stash**: Personal vault, guild storage, and Remove-Only seasonal tabs.
2. **Primal Alchemy Cauldron & Forge**: Refine Primal Stones, craft Ancient Bone Brands, and fuse relics.
3. **Meridian Meditation Mat**: Meditate to break through the 1,500 Astral Meridian acupoints.
4. **AI Agent Delegation Altar**: Station to dispatch AI Agent Orbs for autonomous progression while offline.