> ## Documentation Index
> Fetch the complete documentation index at: https://hyperscape-ai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# January 2026

> Duel Arena, Prayer, Collision, Smithing, Website, and UI Improvements

## Week 7: February 8-12

### New Mobs

*Merged: February 12, 2026*

Added three new hostile NPCs to expand combat variety:

* **Cow**: Level 2 passive mob that drops cowhide and bones
  * **Stats**: 8 HP, non-aggressive, retaliates when attacked
  * **Drops**: Cowhide (always), bones (default)
  * **Spawns**: Plains and forest biomes
  * **Model**: `models/cow/cow.vrm`
* **Dark Wizard**: Level 22 aggressive magic user
  * **Combat**: Casts Wind Strike spell, 10-tile range
  * **Stats**: 22 HP, 22 Magic, 11 Defense
  * **Drops**: Air/mind/water/earth runes, coins, wizard hat, staff
  * **Spawns**: Plains and forest biomes
  * **Model**: `models/dark-wizard/dark-wizard.vrm` with air staff
* **Dark Ranger**: Level 15 aggressive ranged attacker
  * **Combat**: Fires bronze arrows, 7-tile range
  * **Stats**: 18 HP, 15 Ranged, 8 Defense
  * **Drops**: Bronze arrows, coins, shortbow, leather armor
  * **Spawns**: Plains and forest biomes
  * **Model**: `models/dark-ranger/dark-ranger.vrm` with wooden bow

**Integration**: All mobs added to `manifests/npcs.json` with complete combat stats, drop tables, and spawn configurations

***

### Ammunition Manifest Update (Week 6)

*Merged: February 8, 2026*

Updated ammunition manifest with additional arrow tier:

* **Rune Arrows**: Added missing rune arrow tier (ranged strength: 49, level 40 requirement)
* **Arrow Progression**: Complete F2P arrow set from bronze to rune
* **Manifest**: Updated `manifests/ammunition.json` with all arrow tiers

## Week 11: March 9-12

### Tree Model Updates

*Merged: March 12, 2026*

Comprehensive tree model improvements for better visual quality and consistency:

* **Wind Pine Tree**: New tree type for tundra biome (split from dead tree variants)
* **Maple Leaves**: Recolored to warm vermillion red-orange (#D04838)
* **Knotwood Leaves**: Recolored from golden-yellow to warm amber (#C4832A)
* **Model Scales**: Adjusted tree model scales for better visual proportions
* **Root Depth Normalization**: Fixed floating tree models
  * All fir variants aligned to fir\_03's minY (-59.46)
  * All maple variants aligned to maple\_01's minY (-114.76)
  * Extra downward shift for maple\_03 trunk base alignment

***

### Biome Configuration Updates

*Merged: March 10, 2026*

Updated biome walkability thresholds to match actual terrain generation:

* **Tundra**: maxSlope 0.8 → 1.8 (for terraced terrain)
* **Forest**: maxSlope 0.8 → 1.5 (for landscape features)
* **Canyon**: maxSlope 0.6 → 2.5 (for steep canyon walls)
* **Biome Sync**: Replaced outdated 8-biome manifest with active 3-biome version (tundra, forest, canyon)

***

## Week 6: February 2-6

### Ammunition Manifest Update

*Merged: February 6, 2026*

Updated ammunition manifest with comprehensive arrow definitions:

* **Arrow Types**: Bronze, iron, steel, mithril, adamant, and rune arrows
* **Base Arrows**: Headless arrows and arrow shafts for fletching
* **Manifest**: `manifests/ammunition.json` with complete arrow specifications
* **Integration**: Full support for ranged combat system

***

### Bones and Coins Models

*Merged: February 2, 2026*

Added essential item models for prayer and economy systems:

* **Bones Model**: New `models/bones/bones.glb` for prayer training
* **Coin Pile Model**: New `models/coin-pile/coin-pile.glb` for ground loot visualization
* **Integration**: Bones drop from NPCs for prayer XP, coin piles display dropped gold

***

### Magic Staffs

*Merged: February 1, 2026*

Added elemental magic staff models with aligned versions:

* **Air Staff**: `models/magic-staffs/air-staff/air-staff.glb` and aligned version
* **Earth Staff**: `models/magic-staffs/earth-staff/earth-staff.glb` and aligned version
* **Fire Staff**: `models/magic-staffs/fire-staff/fire-staff.glb` and aligned version
* **Water Staff**: `models/magic-staffs/water-staff/water-staff.glb` and aligned version
* **Alignment**: All staffs include `-aligned.glb` versions for proper character hand positioning
* **Integration**: Complete elemental staff set for magic combat system

***

### Firemaking Fire Model

*Merged: February 1, 2026*

Added 3D fire model for firemaking skill:

* **Fire Model**: New `firemaking-fire.glb` model for visual fire effects
* **Model Path**: `models/firemaking-fire/firemaking-fire.glb`
* **Integration**: Fire entities now display animated 3D fire models when logs are burned

***

### Runecrafting Skill Manifest

*Merged: January 31, 2026*

Complete runecrafting recipe system with OSRS-accurate data:

* **Rune Types**: Air, mind, water, earth, fire, and chaos runes
* **Essence Support**: Both rune essence and pure essence (chaos requires pure essence only)
* **Multi-Rune Levels**: Progressive level thresholds for crafting multiple runes per essence
* **XP Rates**: OSRS-accurate XP per essence (5.0 - 8.5 XP)
* **Manifest**: `recipes/runecrafting.json` with full recipe definitions

***

### Fletching Skill Manifest

*Merged: January 31, 2026*

Complete fletching recipe system with OSRS-accurate data:

* **Arrow Shafts**: Knife + logs → 15-90 shafts (varies by log tier)
* **Headless Arrows**: Arrow shafts + feathers → headless arrows
* **Shortbows**: Knife + logs → unstrung shortbows (normal, oak, willow, maple, yew, magic)
* **Longbows**: Knife + logs → unstrung longbows (normal, oak, willow, maple, yew, magic)
* **Bow Stringing**: Bowstring + unstrung bow → finished bow
* **Arrow Tipping**: Arrowtips + headless arrows → finished arrows (bronze, iron, steel, mithril, adamant, rune)
* **XP Rates**: OSRS-accurate XP per action (5 - 187.5 XP)
* **Manifest**: `recipes/fletching.json` with 40+ recipes

***

### Crafting Skill Manifest

*Merged: January 31, 2026*

Complete crafting recipe system with OSRS-accurate data:

* **Leather Armor**: Gloves, boots, cowl, vambraces, body, chaps (requires needle + thread)
* **Studded Armor**: Studded body and chaps (leather armor + steel studs)
* **Dragonhide Armor**: Green d'hide vambraces, chaps, body (requires needle + thread)
* **Jewelry**: Gold rings, amulets (accuracy, strength, power, glory, fury) at furnace
* **Gem Cutting**: Sapphire, emerald, ruby, diamond, dragonstone, onyx (requires chisel)
* **XP Rates**: OSRS-accurate XP per craft (13.8 - 186 XP)
* **Consumables**: Thread system with 5 uses per thread
* **Manifest**: `recipes/crafting.json` with 25+ recipes

***

### Armor Manifest Updates

*Merged: January 31, 2026*

Comprehensive armor item definitions added to `items/armor.json`:

* **Melee Armor**: Full helms, platebodies, platelegs, kiteshields (bronze → rune tiers)
* **Ranged Armor**: Leather, studded, green dragonhide sets
* **Magic Armor**: Wizard robes, mystic robes
* **Accessories**: Boots, gloves, capes, amulets, rings for all combat styles
* **Bonuses**: Complete OSRS-accurate stat bonuses for all armor pieces
* **Requirements**: Skill requirements (defence, ranged, magic) per tier

***

## Week 4: January 26-28

### Ranged & Magic Combat (PR #13)

*Merged: January 28, 2026 | +1,251 / -2 lines | 13 files*

Complete ranged and magic combat systems:

* **Ranged Combat**: Bows (shortbow, oak, willow, maple), arrows (bronze, iron, steel, mithril, adamant), ranged prayers (Sharp Eye, Hawk Eye)
* **Magic Combat**: Staves (staff, magic staff, elemental staves), runes (air, water, earth, fire, mind, chaos), combat spells (Strike and Bolt tiers)
* **Duel Arena**: 6 combat arenas with lobby, hospital, NPCs (Nurse Sarah, Duel Master Marcus, Scoreboard), trapdoors, flat zones
* **Manifests**: `ammunition.json`, `runes.json`, `combat-spells.json`, `duel-arenas.json`
* **Items**: Ranged weapons, ammunition, magic staves, runes added to `items/weapons.json`, `items/ammunition.json`, `items/runes.json`
* **Prayers**: Ranged and magic prayers added to `prayers.json`
* **Store**: All ranged and magic items available in general store

***

### Duel Arena System (PR #685)

*Merged: January 27, 2026 | +15,066 lines | 85 files*

Complete PvP dueling system with stake wagering:

* **Challenge System**: Right-click to challenge, rules negotiation, stakes with anti-scam warnings
* **Arena System**: Procedural generation, arena pool management, lobby-only initiation
* **Combat Phase**: 3D countdown, rule enforcement, forfeit pillars, disconnect handling
* **Resolution**: Winner receives stakes, result modal, teleportation to lobby
* **Technical**: Transaction wrapping, audit logging, rate limiting, SOLID refactoring, 1,750+ test lines

**Bug Fixes**: Death animation race conditions, movement blocking, combat rotation, inventory tab isolation

***

### Website Redesign (PR #684)

*Merged: January 28, 2026 | +2,723 lines | 46 files*

* Redesigned landing page hero with responsive layout and animations
* New `/gold` token page with scroll-style design
* Reusable Background, CTA, Hero, and Button components
* Improved Header/Footer with \$GOLD link

***

### UI Improvements & Mobile (PR #656)

*Merged: January 26, 2026 | +1,972 / -907 lines | 57 files*

* **Action Bar**: RS3-style shortcuts (Ctrl/Shift/Alt), 5 bars × 14 slots
* **Mobile**: Long-press context menu, TouchSensor drag-and-drop
* **Panels**: 30% larger, responsive menu bar, chat filtering, dark fantasy status orbs
* **Edit Mode**: Extracted keyboard hook, delete zone for panels

***

## Week 3: January 14-16

### Static Tile Collision (PR #552)

*Merged: January 15, 2026 | +3,691 lines*

Zone-based collision system:

* **CollisionMatrix**: Bitmask flags, 8×8 tile zones, lazy allocation, O(1) lookups
* **Flags**: BLOCKED, WATER, STEEP\_SLOPE, OCCUPIED\_PLAYER, OCCUPIED\_NPC
* **Integration**: Resources/stations register collision, mob pathfinding, TerrainSystem
* **Build**: Auto-detect footprints from model bounds, turbo caching
* **Multi-Tile**: Interaction from any side, center-based registration

***

### Prayer System (PR #563)

*Merged: January 16, 2026 | +4,126 lines*

Complete prayer skill:

* Manifest-driven prayer types with database persistence
* Drain mechanics, conflict resolution, combat bonuses
* Bone burying (regular/big/dragon) with 2-tick delay
* Prayer altars for recharging
* Prayer panel with real-time updates, 62 unit tests

***

### Coin Pouch Withdrawal (PR #559)

*Merged: January 15, 2026*

* RS3-style money pouch with withdrawal modal
* Server-authoritative, atomic transactions, rate limiting

***

### Hover Tooltips & Click-to-Unequip (PR #558)

*Merged: January 15, 2026*

* Item stats on hover for equipment/inventory
* Direct click to unequip, smart tooltip suppression

***

### Walk Here Context Menu (PR #555)

*Merged: January 15, 2026*

* Right-click terrain shows "Walk here"
* New ContextMenuTargetType union

***

### Bug Fixes

* **#554**: Restored fishing animation
* **#553**: Store transactions wrapped with executeInventoryTransaction
* **#547**: Removed overhead nametags
* **#544**: Fixed mob combat animation override
* **#560**: Fixed Vitest imports, updated stale assertions

***

## Week 2: January 9-10

### Smithing Skill (PR #492)

*Merged: January 9, 2026 | +6,682 / -622 lines | 31 commits*

Complete smithing implementation:

* **Smelting**: Furnaces, tier-specific XP, manifest-driven recipes
* **Smithing**: Anvils, Make X memory, level requirements UI
* **Timing**: OSRS-accurate tick-based processing
* **Database**: smithingLevel/smithingXp persistence
* **Performance**: Memory leak fixes, pre-allocated buffers, server-only guards
* **Security**: Input validation, type guards, rate limiting

**Bonus**: Firemaking/cooking level requirement validation

***

### Context Menu Colors (PR #497)

*Merged: January 10, 2026*

* **Colors**: Orange items, yellow NPCs, cyan objects
* **Actions**: Manifest-driven inventory actions, heuristic fallback
* Centralized InventoryActionDispatcher, item helper utilities

***

### Food & Eating System (PR #500)

*Merged: January 10, 2026*

* 3-tick eat delay, combat integration (+3 ticks to attack cooldown)
* Server-authoritative, EatDelayManager, event-driven health updates

***

### Station 3D Models (PR #496)

*Merged: January 10, 2026*

* Manifest-driven anvil and furnace models with configurable scale/offset

***

### Bug Fixes

* **#502**: Two-phase bank slot update to prevent constraint violations
* **#494**: Prevent duplicate resource harvesting
* **#504**: 100% rock depletion, accurate mining success rates
* **#505**: F5 keybind for debug panel