# GRAPHIC & TECHNICAL DESIGN SPECIFICATIONS: ITEMS & EQUIPMENT
# PROJECT FREEEXILE: DARK MARTIAL ASTRAL 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**: iOS Metal 120Hz Client, The Outcast Bazaar System.  
> **Related Document**: [Inventory, Personal Stash, Premium Merchant Tab & 2D Spatial Grid Specifications](file:///c:/Projects/FreeExile/wiki/en/INVENTORY_STASH_AND_SPATIAL_GRID_SPECS.md).

---

## 1. ITEM RARITY TIERS & EMISSIVE SHADER PROFILES

Every item and gear piece in `FreeExile` is classified into 4 distinct rarity tiers. Each tier features unique Apple Metal emissive glow shaders, world loot beams, and Apple Core Haptics impulses:

| Rarity Tier | Hex Color Code | Metal Emissive Shader | World Loot Beam Effect | Drop SFX Sound Signature | Apple Haptic Response |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **Common (Phàm Phẩm)** | `#B0BEC5` | None (Matte) | No Beam | Faint wooden/iron clatter | No vibration |
| **Magic (Linh Phẩm)** | `#29B6F6` | Cyan glow ($1.5$ intensity) | 5m subtle cyan pillar | Crisp metallic chime | Light tap ($0.30$) |
| **Rare (Cực Phẩm)** | `#FFA000` | Pulsing amber gold ($2.8$)| 15m blazing gold beam | Resonant jade bell tone | Firm impulse ($0.75$) |
| **Unique (Thần Phẩm)** | `#E91E63` / `#D500F9` | Cosmic vortex ($4.5$) | Infinite skyward magenta pillar | Map-wide celestial thunder | Heavy rumble ($1.00$) |

---

## 2. THE EIGHT SUPREME MARTIAL WEAPONS (BÁT ĐẠI THẦN BINH)

Crafted via 3D High-Poly modeling and baked into high-fidelity 2.5D isometric sprites featuring realistic PBR properties ($0.90$ Metalness, $0.15$ Roughness).

### 2.1. Azure Wind Ancient Sword (Thanh Phong Cổ Kiếm)
- **ID**: `item_wpn_azure_wind_sword` | **Element**: Metal (Attack Speed, Armor Pierce, Crit Multiplier).
- **Art Description**: Slender celestial blade forged from Nine-Heavens Meteorite Iron, shimmering like a moonlit icy lake. Hilt wrapped in white silk adorned with wind-lightning emeralds. Leaves razor-sharp silver slashes.
- **Tech Specs**: Grid size $1 \times 3$, UI Icon $256 \times 256$, Melee Range $2.2m$ ($120^\circ$ arc), Base Speed $1.45$ attacks/sec. Metal shader `Wpn_Shader_EdgeReflection`.

### 2.2. Infernal Executioner Blade (Xích Diễm Trảm Mã Đao)
- **ID**: `item_wpn_infernal_executioner_blade` | **Element**: Fire (Raw Physical Power, Area Blast).
- **Art Description**: Colossal two-handed jagged greatsword glowing molten red fresh from an infernal furnace. Black smoke and embers steadily drift from blood grooves.
- **Tech Specs**: Grid size $2 \times 4$, Melee Range $2.8m$ ($180^\circ$ sweep), Base Speed $0.95$ attacks/sec. Metal shader `Wpn_Shader_HeatEmissiveDistort`.

### 2.3. Sun-Piercing Celestial Bow (Xạ Nhật Thần Cung)
- **ID**: `item_wpn_sun_piercing_bow` | **Element**: Metal - Fire (Extreme Range, Piercing Arrows).
- **Art Description**: Elegant golden phoenix wing bow strung with ancient dragon sinew. Pulling the string manifests a brilliant fiery arrow of pure condensed astral qi.
- **Tech Specs**: Grid size $2 \times 3$, Projectile Range $14.0m$ ($28.0 m/s$), Base Speed $1.20$ attacks/sec. Metal shader `Wpn_Shader_LaserDrawTrail`.

### 2.4. Glacial Lotus Staff (Băng Phách Hàn Liên Trượng)
- **ID**: `item_wpn_glacial_frost_staff` | **Element**: Water (Glacial Spell Power, Freeze Rate).
- **Art Description**: Carved from ancient permafrost cedar, crowning a floating crystalline ice lotus emitting sub-zero frosty mist.
- **Tech Specs**: Grid size $1 \times 4$, Spell Cast Range $12.0m$, Base Speed $1.05$ attacks/sec. Metal shader `Wpn_Shader_SubsurfaceFrost`.

### 2.5. Break-Army War Spear (Phá Quân Huyền Thiết Thương)
- **ID**: `item_wpn_break_army_spear` | **Element**: Metal - Earth (Mid-range Thrust, Dash Boost).
- **Art Description**: Heavy black iron spear with dual-barbed tip and fluttering crimson war tassel.
- **Tech Specs**: Grid size $1 \times 4$, Thrust Range $3.5m$ ($30^\circ$ narrow thrust), Base Speed $1.30$ attacks/sec.

### 2.6. Nether Blood Venom Claw (U Minh Huyết Độc Trảo)
- **ID**: `item_wpn_nether_blood_claw` | **Element**: Wood (Bleed Stacks, Acid DoT, Life Leech).
- **Art Description**: Curved demon claws attached to venomous snake leather bracers, dripping acidic green venom.
- **Tech Specs**: Grid size $2 \times 2$, Melee Range $1.6m$, Base Speed $1.75$ attacks/sec (Fastest weapon archetype).

### 2.7. Vajra Bronze Spade (Hàng Ma Đồng Thiền Trượng)
- **ID**: `item_wpn_vajra_bronze_spade` | **Element**: Earth (Stagger, Qi Shield Block, Ground Shatter).
- **Art Description**: Massive antique bronze monk spade adorned with jangling bronze rings that ward off demonic spirits.
- **Tech Specs**: Grid size $2 \times 4$, Melee Range $2.6m$, Base Speed $0.85$ attacks/sec.

### 2.8. Yin-Yang Astral Chakram (Càn Khôn Âm Dương Luân)
- **ID**: `item_wpn_yin_yang_chakram` | **Element**: Water - Fire (Boomerang Trajectory, Multi-target Bounce).
- **Art Description**: Twin bladed circular chakrams spinning around the user's wrists, half ablaze in fire and half encased in ice.
- **Tech Specs**: Grid size $2 \times 2$, Effective Range $9.0m$ (Returns on throw), Base Speed $1.25$ attacks/sec.

---

## 3. ARMOR & ACCESSORIES SYSTEM (PHÒNG CỤ & TRANG SỨC)

- **Celestial Crane Crown (`item_arm_celestial_crane_helm`)**: $2 \times 2$, Physical Armor & Qi Energy Shield.
- **Eight Wilds Dragon Chestplate (`item_arm_eight_wilds_chest`)**: $2 \times 3$, Maximum Health & Damage Reduction.
- **Demon Slayer Vambraces (`item_arm_demon_slayer_gloves`)**: $2 \times 2$, Attack Speed & Block Chance.
- **Five Elements Astral Belt (`item_arm_five_elements_belt`)**: $2 \times 1$, Elixir Capacity & Elemental Resistances.
- **Cloud Strider Boots (`item_arm_cloud_strider_boots`)**: $2 \times 2$, +35% Movement Speed & Phantom Evasion CDR.
- **Twin Dragon Ring (`item_jwl_twin_dragon_ring`)**: $1 \times 1$, Elemental Damage & Life Leech.
- **Void Destiny Amulet (`item_jwl_void_destiny_amulet`)**: $1 \times 1$, +1 to All Martial Skill Cores.

---

## 4. TRUE MARTIAL CORES & AUGMENTING SIGILS (CHÂN VÕ ĐAN & THẦN BIẾN PHÙ)

> **Socketless Martial Grid Paradigm**: Gear pieces never need gem sockets. Active Skill Cores and Feral Mutator Glyphs connect into the player's internal **Martial Matrix Grid** via Qi Energy Conduits.

### 4.1. Core Active Martial Gems (Ma Võ Tàn Cốt)
- **Fire-Thunder Burst (`skill_core_fire_thunder_burst`)**: Launches an explosive thunder orb engulfed in flames.
- **Shadowless Sword Form (`skill_core_shadowless_sword`)**: 7-hit invulnerable omni-directional slash flurry.
- **Glacial Aurora (`skill_core_glacial_aurora`)**: Piercing cold laser that freezes everything along an 18m line.
- **Nether Poison Palm (`skill_core_nether_poison_palm`)**: Unleashes a ghostly demonic skull projectile leaving corrosive acid pools.
- **Vajra Shield Palm (`skill_core_vajra_shield_palm`)**: Slams the ground creating a holy golden barrier repelling foes.

### 4.2. Augmenting Support Sigils (Dị Biến Tà Ấn)
- **Multi-Projectile Sigil (`sigil_mod_multi_projectile`)**: Splits 1 projectile into 3 in a forward cone (+2 Projectiles).
- **Area Burst Sigil (`sigil_mod_area_burst`)**: Increases skill explosion radius by +45%.
- **Chain Lightning Sigil (`sigil_mod_chain_lightning`)**: Adds 4 lightning chain bounces upon target hit.
- **Cold Conversion Sigil (`sigil_mod_cold_convert`)**: Converts 100% Physical Damage to Cold, +25% Freeze Chance.
- **Blood Leech Sigil (`sigil_mod_blood_leech`)**: Converts 2.5% of total damage into immediate Health recovery.

---

## 5. BLANK SCRIPTURES (VÔ TỰ BÍ ĐIỂN)
- **ID**: `item_scripture_blank_uncut` | **Key**: `item.scripture.blank.name`
- **Art Description**: Ancient wordless parchment parchment glowing with ethereal golden Sanskrit glyphs.
- **Functional Breakthrough**: Inscribing mental intent transforms this blank scroll into **any Martial Bone Relic** matching the drop level, eliminating RNG gem-farming frustrations entirely.