# GRAPHIC & TECHNICAL DESIGN SPECIFICATIONS: MONSTERS & WORLD BOSSES
# PROJECT FREEEXILE: GRIMDARK SAVAGE PRIMAL 2.5D ARPG

> **Responsible Departments**: Art & UI/UX Director (`art_ui_director`), Lead Documentation Architect (`lead_documentation_architect`), Lead Localization Architect (`localization_lead`).  
> **Document Version**: 1.0.0-RELEASE  
> **Target Platforms**: Server-Authoritative AI, 2.5D Metal Renderer, Animation State Machine.

---

## 1. MONSTER HIERARCHY & ARCHITECTURE

The wildlife and demonic entities of the The Savage Deadlands operate under strict 20Hz Server-Authoritative simulation. Clients smoothly interpolate motion and trigger GPU-accelerated Metal shaders:

| Monster Tier | Model Scale | Encounter Density | AI & Combat Logic | Client Visual Specification |
| :--- | :--- | :--- | :--- | :--- |
| **Normal Swarm (Dã Quái)** | $100\%$ | $10 - 40$ per pack | Flocking, melee bite or ranged archer | 8-directional sprites, $60-80$ frames/set. |
| **Elite (Quái Tinh Anh)** | $130 - 140\%$ | $1 - 3$ per pack | $2 - 4$ random Affixes (Molten, Chain) | Pulsing colored aura shader, amplified roar. |
| **Golden World Boss (Boss)**| $250 - 450\%$ | $1$ per encounter | 3 distinct phases, arena telegraph hazards | 3D-on-2D 16 angles, Multipoint Hitboxes. |

---

## 2. COMMON SWARM MONSTERS (DÃ QUÁI)

### 2.1. Corrupted Bone Hound (Hoang Giới Thi Cẩu)
- **ID**: `mob_trash_bone_hound` | **Key**: `mob.trash.bone_hound.name`
- **Art Description**: Mutated scavenger hound infested with miasma. Jagged white bone spikes burst from its spine, eyes blazing bloodshot red, long jaws lined with serrated fangs.
- **Tech Specs**: 8 directions, 48 frames. Move Speed $7.2 m/s$. Hitbox Capsule `Radius: 0.35m`, `Height: 0.80m`. Lightweight Lambert shader for 50+ unit swarms.

### 2.2. Ghost Sword Thrall (U Hồn Kiếm Nô)
- **ID**: `mob_trash_ghost_sword_thrall` | **Key**: `mob.trash.ghost_sword.name`
- **Art Description**: Mummified fallen warrior bound by vengeful resentment. Shrouded in ragged burial linens, wielding a rusted blade with terrifying sudden lunges.
- **Tech Specs**: 8 directions, 56 frames. Move Speed $3.8 m/s$. Emissive death smoke particles.

---

## 3. ELITE AFFIXES & VISUAL EMISSIVE PROFILES

| Affix Name | Identifier | Visual Profile | Combat Mechanics |
| :--- | :--- | :--- | :--- |
| **Chain Lightning (Lôi Đạn)** | `affix_elite_chain_lightning` | Crackling violet electric aura | Hits unleash 3-target bouncing lightning bolts. |
| **Molten Burst (Bộc Hỏa)** | `affix_elite_molten_burst` | Glowing orange magma footprints | Explodes 1.5s after death in massive fiery AoE. |
| **Vajra Shield (Kim Cang)** | `affix_elite_vajra_shield` | Golden bell barrier envelope | Absorbs 75% incoming damage until 5 crits landed. |
| **Nether Toxin (U Minh Độc)** | `affix_elite_nether_toxin` | Spattering emerald acid bubbles | Spawns 40% slowing poison pools upon approach. |
| **Phantom Speed (Thần Tốc)** | `affix_elite_phantom_speed` | 3 blurred translucent afterimages | +50% movement velocity, 30% evasion chance. |

---

## 4. THE FOUR GOLDEN WORLD BOSSES (TỨ ĐẠI BOSS HOÀNG KIM)

### 4.1. Abyssal Bile Fiend (Xà Quái Vực Sâu)
- **ID**: `boss_world_abyssal_dragon_king` | **Location**: The Abyssal Bile Mire (`zone_abyssal_ice_pond`).
- **Element**: Water - Poison.
- **Visual Design**: Colossal 35-meter mire serpent with greasy midnight-black scales dripping toxic violet bile. Broken jagged bone horn leaking corrosive venom, milky unseeing eyes radiating piercing frost.
- **Phase Mechanics**:
  - `Phase 1 (100% - 60% HP)`: $180^\circ$ tail sweeps, lunging bite attacks, and frost-venom projectile barrages.
  - `Phase 2 (60% - 25% HP)`: Submerges beneath stagnant mire, spawning 3 roaming toxic bile vortexes across the arena.
  - `Phase 3 (<25% HP Enrage)`: Body pulses radiant purple, summoning an acidic bile rain that relentlessly erodes player life.
- **Tech Specs**: 3D-on-2D Bezier spine bone-rigging, Multipoint Hitboxes (Head $1.5m$, Body $2.2m$, Tail $1.2m$). Sub-bass $45Hz$ roar, continuous storm haptic rumble on iOS.

### 4.2. Gorging Bone-Beast (Thao Thiết Cốt Thú)
- **ID**: `boss_world_bone_glutton_taotie` | **Location**: The Gorge of the Starved (`zone_infinite_blood_rift`).
- **Element**: Earth - Void.
- **Visual Design**: Massive four-legged feral colossus armored in thousands of spliced bones from fallen exiles fused with coagulated black gore. A yawning jaw engulfs its entire head, opening into a swirling violet-black gravitational void singularity.
- **Signature Mechanics**:
  - `Void Singularity`: Generates immense gravitational pull drawing players toward its maw; players must use counter-directional Dodge Rolls to survive.
  - `Bone Spikes Burst`: Slams forelimbs into ground, erupting thousands of razor-sharp bone pillars upward.
- **Tech Specs**: 120,000 tris, Metal Gravitational Lensing shader, colossal hitbox `Radius: 3.5m`, `Height: 4.8m`.

### 4.3. Blood-Crazed Warlord: Duan the Solitary (Huyết Cuồng Lãnh Chúa: Đoạn Độc Hành)
- **ID**: `boss_world_nine_nether_sovereign` | **Location**: The Apex of Slaughter (`zone_boundless_celestial_palace`).
- **Element**: Metal - Fire (Feral Slaughter).
- **Visual Design**: The First Exile, horribly mutated into a blood-drenched brute draped in rusted iron-bone armor stained in dried gore. Wields a colossal jagged Greatblade dripping fresh blood, shrouded in a suffocating crimson killing aura.
- **Combat Mastery**:
  - `Crimson Dash`: High-speed lunging cleaves carving glowing trenches into the stone floor.
  - `Blood Storm Cleave`: Roars in savage fury, executing an 8-strike whirlwind flurry blanketing the entire battleground.
- **Tech Specs**: 16 directions, 180 animation frames @ 60fps, 4,000 crimson slash particles, player-sized hitbox `Radius: 0.65m`, `Height: 2.10m`.

### 4.4. Obsidian Magma Behemoth (Cự Thú Nham Thạch)
- **ID**: `boss_world_blazing_fire_pixiu` | **Location**: The Bloodforge Caldera (`zone_purgatory_lava_cavern`).
- **Element**: Fire - Metal.
- **Visual Design**: Titan of jagged obsidian encased in molten volcanic slabs with subterranean magma boiling at $1,200^\circ C$ through surface fissures. Reinforced stone-plated head and heavy spiked tail.
- **Signature Mechanics**:
  - `Lava Torrent`: Channels a continuous $360^\circ$ rotating torrent of molten rock, requiring timed evasive jumps through safe arcs.
  - `Meteor Rain`: Slams earth to call down incandescent meteor boulders onto highlighted circular red telegraph zones.
- **Tech Specs**: Metal lava-displacement shader, 3,200 ember particles, ground crater decals. Hitbox `Radius: 2.80m`.

---

## 5. SUMMARY SPECIFICATION MATRIX

| Entity Name | Tier | Primary Element | Hitbox Radius ($r$) | Run Speed | Metal Shader Profile | Apple Core Haptics Profile |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| **Corrupted Bone Hound** | Trash Mob | Physical | $0.35 m$ | $7.2 m/s$ | Lightweight Lambert | Sharp bite tap ($0.25$) |
| **Ghost Sword Thrall** | Trash Mob | Nether | $0.40 m$ | $3.8 m/s$ | Emissive Smoke Trail | Rusted slash ($0.50$) |
| **Elite Affix Mob** | Elite | Dynamic | $0.50 - 0.70 m$ | $5.5 - 8.0 m/s$| Pulsing Colored Aura | Variable affix rumble |
| **Abyssal Bile Fiend** | World Boss | Water / Poison | Multipoint ($1.5-2.2m$)| $6.5 m/s$ | Water Caustic + Bone Rig | Low sub-bass roar ($45Hz$) |
| **Gorging Bone-Beast** | World Boss | Earth / Void | $3.50 m$ (Giant) | $4.2 m/s$ | Gravitational Lensing | Continuous vacuum suction |
| **Blood-Crazed Warlord** | World Boss | Metal / Fire | $0.65 m$ (Humanoid)| $9.5 m/s$ | Anisotropic Blood Trail| Savage flurry blade ($0.95$) |
| **Obsidian Magma Behemoth**| World Boss | Fire / Metal | $2.80 m$ | $5.8 m/s$ | Lava Flow Displacement | Tremor meteor impact |