Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions changelog/2026-01.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,47 @@
---
title: "January 2026"
description: "Duel Arena, Prayer, Collision, Smithing, Website, and UI Improvements"

Check warning on line 3 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L3

Did you really mean 'Smithing'?
---

## Week 7: February 8-12

### New Mobs

*Merged: February 12, 2026*

Added three new hostile NPCs to expand combat variety:

Check warning on line 12 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L12

Did you really mean 'NPCs'?

- **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

Check warning on line 17 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L17

Did you really mean '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

Check warning on line 23 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L23

Did you really mean '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

Check warning on line 28 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L28

Did you really mean 'shortbow'?
- **Spawns**: Plains and forest biomes

Check warning on line 29 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L29

Did you really mean '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
Expand All @@ -12,8 +51,8 @@
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)

Check warning on line 54 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L54

Did you really mean 'vermillion'?
- **Knotwood Leaves**: Recolored from golden-yellow to warm amber (#C4832A)

Check warning on line 55 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L55

Did you really mean 'Knotwood'?
- **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)
Expand All @@ -26,11 +65,11 @@

*Merged: March 10, 2026*

Updated biome walkability thresholds to match actual terrain generation:

Check warning on line 68 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L68

Did you really mean 'walkability'?

- **Tundra**: maxSlope 0.8 → 1.8 (for terraced terrain)

Check warning on line 70 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L70

Did you really mean 'maxSlope'?
- **Forest**: maxSlope 0.8 → 1.5 (for landscape features)

Check warning on line 71 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L71

Did you really mean 'maxSlope'?
- **Canyon**: maxSlope 0.6 → 2.5 (for steep canyon walls)

Check warning on line 72 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L72

Did you really mean 'maxSlope'?
- **Biome Sync**: Replaced outdated 8-biome manifest with active 3-biome version (tundra, forest, canyon)

---
Expand All @@ -43,8 +82,8 @@

Updated ammunition manifest with comprehensive arrow definitions:

- **Arrow Types**: Bronze, iron, steel, mithril, adamant, and rune arrows

Check warning on line 85 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L85

Did you really mean 'mithril'?
- **Base Arrows**: Headless arrows and arrow shafts for fletching

Check warning on line 86 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L86

Did you really mean 'fletching'?
- **Manifest**: `manifests/ammunition.json` with complete arrow specifications
- **Integration**: Full support for ranged combat system

Expand All @@ -58,7 +97,7 @@

- **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

Check warning on line 100 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L100

Did you really mean 'NPCs'?

---

Expand All @@ -77,11 +116,11 @@

---

### Firemaking Fire Model

Check warning on line 119 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L119

Did you really mean 'Firemaking'?

*Merged: February 1, 2026*

Added 3D fire model for firemaking skill:

Check warning on line 123 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L123

Did you really mean 'firemaking'?

- **Fire Model**: New `firemaking-fire.glb` model for visual fire effects
- **Model Path**: `models/firemaking-fire/firemaking-fire.glb`
Expand All @@ -89,11 +128,11 @@

---

### Runecrafting Skill Manifest

Check warning on line 131 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L131

Did you really mean 'Runecrafting'?

*Merged: January 31, 2026*

Complete runecrafting recipe system with OSRS-accurate data:

Check warning on line 135 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L135

Did you really mean 'runecrafting'?

- **Rune Types**: Air, mind, water, earth, fire, and chaos runes
- **Essence Support**: Both rune essence and pure essence (chaos requires pure essence only)
Expand All @@ -103,18 +142,18 @@

---

### Fletching Skill Manifest

Check warning on line 145 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L145

Did you really mean 'Fletching'?

*Merged: January 31, 2026*

Complete fletching recipe system with OSRS-accurate data:

Check warning on line 149 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L149

Did you really mean 'fletching'?

- **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)

Check warning on line 153 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L153

Did you really mean 'Shortbows'?

Check warning on line 153 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L153

Did you really mean 'shortbows'?
- **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)

Check warning on line 156 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L156

Did you really mean 'Arrowtips'?

Check warning on line 156 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L156

Did you really mean 'mithril'?
- **XP Rates**: OSRS-accurate XP per action (5 - 187.5 XP)
- **Manifest**: `recipes/fletching.json` with 40+ recipes

Expand All @@ -128,9 +167,9 @@

- **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)

Check warning on line 170 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L170

Did you really mean 'Dragonhide'?

Check warning on line 170 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L170

Did you really mean 'd'hide'?
- **Jewelry**: Gold rings, amulets (accuracy, strength, power, glory, fury) at furnace
- **Gem Cutting**: Sapphire, emerald, ruby, diamond, dragonstone, onyx (requires chisel)

Check warning on line 172 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L172

Did you really mean 'dragonstone'?
- **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
Expand All @@ -143,8 +182,8 @@

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

- **Melee Armor**: Full helms, platebodies, platelegs, kiteshields (bronze → rune tiers)

Check warning on line 185 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L185

Did you really mean 'platebodies'?

Check warning on line 185 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L185

Did you really mean 'platelegs'?

Check warning on line 185 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L185

Did you really mean 'kiteshields'?
- **Ranged Armor**: Leather, studded, green dragonhide sets

Check warning on line 186 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L186

Did you really mean 'dragonhide'?
- **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
Expand All @@ -160,9 +199,9 @@

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)

Check warning on line 202 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L202

Did you really mean 'shortbow'?

Check warning on line 202 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L202

Did you really mean 'mithril'?
- **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

Check warning on line 204 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L204

Did you really mean 'NPCs'?
- **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`
Expand Down Expand Up @@ -216,9 +255,9 @@

Zone-based collision system:

- **CollisionMatrix**: Bitmask flags, 8×8 tile zones, lazy allocation, O(1) lookups

Check warning on line 258 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L258

Did you really mean 'Bitmask'?

Check warning on line 258 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L258

Did you really mean 'lookups'?
- **Flags**: BLOCKED, WATER, STEEP_SLOPE, OCCUPIED_PLAYER, OCCUPIED_NPC
- **Integration**: Resources/stations register collision, mob pathfinding, TerrainSystem

Check warning on line 260 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L260

Did you really mean 'pathfinding'?
- **Build**: Auto-detect footprints from model bounds, turbo caching
- **Multi-Tile**: Interaction from any side, center-based registration

Expand Down Expand Up @@ -247,12 +286,12 @@

---

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

Check warning on line 289 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L289

Did you really mean 'Tooltips'?

*Merged: January 15, 2026*

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

Check warning on line 294 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L294

Did you really mean 'unequip'?

Check warning on line 294 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L294

Did you really mean 'tooltip'?

---

Expand All @@ -269,22 +308,22 @@

- **#554**: Restored fishing animation
- **#553**: Store transactions wrapped with executeInventoryTransaction
- **#547**: Removed overhead nametags

Check warning on line 311 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L311

Did you really mean 'nametags'?
- **#544**: Fixed mob combat animation override
- **#560**: Fixed Vitest imports, updated stale assertions

Check warning on line 313 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L313

Did you really mean 'Vitest'?

---

## Week 2: January 9-10

### Smithing Skill (PR #492)

Check warning on line 319 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L319

Did you really mean 'Smithing'?

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

Complete smithing implementation:

Check warning on line 323 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L323

Did you really mean 'smithing'?

- **Smelting**: Furnaces, tier-specific XP, manifest-driven recipes
- **Smithing**: Anvils, Make X memory, level requirements UI

Check warning on line 326 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L326

Did you really mean 'Smithing'?
- **Timing**: OSRS-accurate tick-based processing
- **Database**: smithingLevel/smithingXp persistence
- **Performance**: Memory leak fixes, pre-allocated buffers, server-only guards
Expand All @@ -298,7 +337,7 @@

*Merged: January 10, 2026*

- **Colors**: Orange items, yellow NPCs, cyan objects

Check warning on line 340 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L340

Did you really mean 'NPCs'?
- **Actions**: Manifest-driven inventory actions, heuristic fallback
- Centralized InventoryActionDispatcher, item helper utilities

Expand All @@ -308,7 +347,7 @@

*Merged: January 10, 2026*

- 3-tick eat delay, combat integration (+3 ticks to attack cooldown)

Check warning on line 350 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L350

Did you really mean 'cooldown'?
- Server-authoritative, EatDelayManager, event-driven health updates

---
Expand All @@ -326,4 +365,4 @@
- **#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

Check warning on line 368 in changelog/2026-01.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

changelog/2026-01.mdx#L368

Did you really mean 'keybind'?
5 changes: 4 additions & 1 deletion wiki/data/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Data Manifests Overview"
description: "Manifest-driven content system for NPCs, items, and world areas"

Check warning on line 3 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L3

Did you really mean 'NPCs'?
icon: "database"
---

Expand Down Expand Up @@ -58,12 +58,12 @@
│ └── misc.json # Miscellaneous items
├── recipes/ # Crafting recipes by skill
│ ├── cooking.json # Cooking recipes
│ ├── firemaking.json # Firemaking recipes

Check warning on line 61 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L61

Did you really mean 'Firemaking'?
│ ├── smelting.json # Ore smelting recipes
│ ├── smithing.json # Smithing recipes

Check warning on line 63 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L63

Did you really mean 'Smithing'?
│ ├── fletching.json # Fletching recipes (NEW)

Check warning on line 64 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L64

Did you really mean 'Fletching'?
│ ├── crafting.json # Crafting recipes (NEW)
│ ├── runecrafting.json # Runecrafting recipes (NEW)

Check warning on line 66 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L66

Did you really mean 'Runecrafting'?
│ └── tanning.json # Leather tanning recipes
├── gathering/ # Gathering skill data
│ ├── woodcutting.json # Tree data
Expand Down Expand Up @@ -100,7 +100,7 @@
| `category` | `"mob" \| "boss" \| "quest" \| "neutral"` | NPC type |
| `stats` | `NPCStats` | Combat stats (attack, strength, defense, health, ranged, level) |
| `drops` | `DropTable` | Loot table with rarity tiers |
| `spawnBiomes` | `string[]` | Biomes where NPC spawns |

Check warning on line 103 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L103

Did you really mean 'Biomes'?
| `modelPath` | `string` | Path to 3D model |
| `behavior` | `"passive" \| "aggressive"` | Combat behavior |

Expand All @@ -113,7 +113,10 @@
├── thug/thug_rigged.glb → Bandits
├── human/human_rigged.glb → Guards, knights, warriors, rangers
├── troll/troll_rigged.glb → Hobgoblins
└── imp/imp_rigged.glb → Dark warriors
├── imp/imp_rigged.glb → Dark warriors
├── cow/cow.vrm → Cows
├── dark-wizard/dark-wizard.vrm → Dark wizards
└── dark-ranger/dark-ranger.vrm → Dark rangers
```

**Stations**:
Expand Down Expand Up @@ -275,10 +278,10 @@
```

**Supported Tiers:**
- **Melee**: bronze, iron, steel, black, mithril, adamant, rune, dragon

Check warning on line 281 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L281

Did you really mean 'mithril'?
- **Tools**: Same as melee (with different skill requirements)
- **Ranged**: leather, studded, green_dhide, blue_dhide, red_dhide, black_dhide

Check warning on line 283 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L283

Did you really mean 'green_dhide'?

Check warning on line 283 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L283

Did you really mean 'blue_dhide'?

Check warning on line 283 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L283

Did you really mean 'red_dhide'?

Check warning on line 283 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L283

Did you really mean 'black_dhide'?
- **Magic**: wizard, mystic, infinity, ahrims

Check warning on line 284 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L284

Did you really mean 'ahrims'?

### Item Helper Functions

Expand Down Expand Up @@ -325,7 +328,7 @@

### Bank Notes

The system supports bank notes for stackable versions of items:

Check warning on line 331 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L331

Did you really mean 'stackable'?

```typescript
// From packages/shared/src/data/items.ts
Expand All @@ -348,7 +351,7 @@

## Drop Tables

NPCs have tiered drop tables:

Check warning on line 354 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L354

Did you really mean 'NPCs'?

```typescript
interface DropTable {
Expand Down Expand Up @@ -412,7 +415,7 @@

## World Areas

World areas define zones, biomes, and spawn points:

Check warning on line 418 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L418

Did you really mean 'biomes'?

```
packages/shared/src/data/
Expand All @@ -428,7 +431,7 @@
| `name` | Display name |
| `biome` | Biome type (forest, plains, etc.) |
| `difficulty` | 0-3 difficulty level |
| `mobs` | NPCs that spawn here |

Check warning on line 434 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L434

Did you really mean 'NPCs'?
| `resources` | Trees, fishing spots, etc. |
| `isSafe` | Whether it's a safe zone |

Expand All @@ -449,7 +452,7 @@

## Stations

Crafting stations are interactive objects that enable processing skills like smithing, smelting, and cooking:

Check warning on line 455 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L455

Did you really mean 'smithing'?

```typescript
interface StationData {
Expand Down Expand Up @@ -560,7 +563,7 @@

Stations are defined in `stations.json`:

- **Anvil** - Used for smithing bars into equipment

Check warning on line 566 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L566

Did you really mean 'smithing'?
- **Furnace** - Used for smelting ores into bars
- **Range** - Used for cooking food (reduces burn chance compared to fires)
- **Bank Booth** - Used for accessing bank storage
Expand Down Expand Up @@ -612,7 +615,7 @@

| Station | Purpose | Model | Scale | Y Offset |
|---------|---------|-------|-------|----------|
| **Anvil** | Smithing bars into equipment | `models/anvil/anvil.glb` | 0.5 | 0.2 |

Check warning on line 618 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L618

Did you really mean 'Smithing'?
| **Furnace** | Smelting ores into bars | `models/furnace/furnace.glb` | 1.5 | 1.0 |
| **Cooking Range** | Cooking food (reduced burn chance) | `models/cooking-range/cooking-range.glb` | 1.0 | 0.5 |
| **Bank Chest** | Accessing bank storage | `models/bank-chest/bank-chest.glb` | 0.5 | 0.75 |
Expand Down Expand Up @@ -648,7 +651,7 @@
| Dragon | 2 |
| Rune | 3 |
| Adamant | 4 |
| Mithril | 5 |

Check warning on line 654 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L654

Did you really mean 'Mithril'?
| Steel | 6 |
| Iron | 7 |
| Bronze | 8 (worst) |
Expand All @@ -660,14 +663,14 @@
| Dragon | 2 | 3 |
| Rune | 3 | 3 |
| Adamant | 4 | 4 |
| Mithril | 5 | 5 |

Check warning on line 666 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L666

Did you really mean 'Mithril'?
| Steel | 6 | 6 |
| Iron | 7 | 7 |
| Bronze | 8 | 8 |

---

## Vegetation & Biomes

Check warning on line 673 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L673

Did you really mean 'Biomes'?

### Vegetation Assets

Expand All @@ -689,13 +692,13 @@
}
```

**Recent maxSlope Updates** (March 2026):

Check warning on line 695 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L695

Did you really mean 'maxSlope'?
- **Tundra**: 0.8 → 1.8 (increased for terraced terrain)
- **Forest**: 0.8 → 1.5 (increased for landscape features)
- **Canyon**: 0.6 → 2.5 (increased for steep canyon walls)

**Vegetation Categories**:
- `tree` - Large trees (oak, willow, maple, yew, magic, fir, knotwood, dead, wind_pine)

Check warning on line 701 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L701

Did you really mean 'knotwood'?

Check warning on line 701 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L701

Did you really mean 'wind_pine'?
- `bush` - Small bushes and shrubs
- `fern` - Ground ferns
- `flower` - Decorative flowers
Expand All @@ -706,10 +709,10 @@

**Tree Types**:
- **Oak, Willow, Yew, Magic** - Standard woodcutting trees with multiple model variants
- **Maple** - Autumn trees with warm vermillion red-orange leaves (#D04838)

Check warning on line 712 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L712

Did you really mean 'vermillion'?
- **Fir** - Coniferous trees for forest biomes

Check warning on line 713 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L713

Did you really mean 'biomes'?
- **Knotwood** - Trees with warm amber-colored leaves (#C4832A)

Check warning on line 714 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L714

Did you really mean 'Knotwood'?
- **Dead** - Barren trees for tundra/canyon biomes

Check warning on line 715 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L715

Did you really mean 'biomes'?
- **Wind Pine** - Specialized pine tree for tundra biome (single model variant)
### Model Bounds System

Expand Down Expand Up @@ -743,11 +746,11 @@

The model bounds system is used by the terrain flattening system to calculate station footprints and by the collision system for efficient spatial queries.

### Biomes

Check warning on line 749 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L749

Did you really mean 'Biomes'?

The `biomes.json` manifest defines terrain biomes with vegetation, mobs, and environmental properties:

Check warning on line 751 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L751

Did you really mean 'biomes'?

**Available Biomes:**

Check warning on line 753 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L753

Did you really mean 'Biomes'?
- **Plains** - Open grasslands with gentle rolling hills (difficulty 0)
- **Forest** - Dense woodland with abundant trees (difficulty 1)
- **Valley** - Low-lying areas between hills (difficulty 0)
Expand All @@ -760,7 +763,7 @@

### Biome Vegetation Layers

Biomes in `biomes.json` define procedural vegetation layers that reference vegetation assets:

Check warning on line 766 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L766

Did you really mean 'Biomes'?

```typescript
interface VegetationLayer {
Expand All @@ -779,18 +782,18 @@
```

**Recent Updates**:
- **165 tree model variants** added across 12 tree types (bamboo, birch, cactus, chinaPine, coconut, dead, fir, knotwood, maple, oak, palm, pine) with 3 LOD levels each

Check warning on line 785 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L785

Did you really mean 'chinaPine'?

Check warning on line 785 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L785

Did you really mean 'knotwood'?
- **Tree model depth normalization**: All fir variants aligned to fir_03's minY (-59.46), all maple variants aligned to maple_01's minY (-114.76) to prevent floating
- **Maple tree recoloring**: Leaves changed to warm vermillion red-orange (#D04838)

Check warning on line 787 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L787

Did you really mean 'vermillion'?
- **Knotwood tree recoloring**: Leaves changed from golden-yellow to warm amber (#C4832A)

Check warning on line 788 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L788

Did you really mean 'Knotwood'?
- **Terrain biome textures** added for TerrainShader rendering (grass, dirt, cliff, desert, snow variants)
- **Woodcutting manifest updated**: Replaced 8 generic trees with 12 new tree types using `modelVariants` arrays
- **Biomes manifest updated**: Removed stale `tree1` vegetation layers (trees now managed via TreeTypes.ts + woodcutting manifest)

Check warning on line 791 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L791

Did you really mean 'Biomes'?
- **Wind Pine tree type** added for tundra biome (split from dead tree variants)
- Mushroom vegetation added to all biomes with varying densities (2-30)

Check warning on line 793 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L793

Did you really mean 'biomes'?
- Tree density reduced in plains biome (8 → 5)
- Mushroom clustering varies by biome (cluster size 3-8)
- Firemaking fire 3D model added (`models/firemaking-fire/firemaking-fire.glb`)

Check warning on line 796 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L796

Did you really mean 'Firemaking'?
- Tree model scales adjusted for better visual proportions (March 2026)
- Fir and maple model root depths normalized to prevent floating (March 2026)
- All fir variants aligned to fir_03's minY (-59.46)
Expand All @@ -802,7 +805,7 @@

Recipe manifests define crafting, processing, and production activities for artisan skills. All recipes follow a consistent structure with inputs, outputs, tools, level requirements, and XP rewards.

### Fletching Recipes

Check warning on line 808 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L808

Did you really mean 'Fletching'?

The `recipes/fletching.json` manifest defines bow and arrow crafting:

Expand All @@ -826,10 +829,10 @@
**Recipe Categories**:
- `arrow_shafts` - Knife + logs → arrow shafts (15-90 per log)
- `headless_arrows` - Arrow shafts + feathers → headless arrows
- `shortbows` - Knife + logs → unstrung shortbows

Check warning on line 832 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L832

Did you really mean 'shortbows'?
- `longbows` - Knife + logs → unstrung longbows
- `stringing` - Bowstring + unstrung bow → finished bow
- `arrows` - Arrowtips + headless arrows → finished arrows

Check warning on line 835 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L835

Did you really mean 'Arrowtips'?

### Crafting Recipes

Expand Down Expand Up @@ -858,11 +861,11 @@
**Recipe Categories**:
- `leather` - Needle + thread + leather → leather armor
- `studded` - Leather armor + steel studs → studded armor
- `dragonhide` - Needle + thread + dragon leather → dragonhide armor

Check warning on line 864 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L864

Did you really mean 'dragonhide'?
- `jewelry` - Gold bar + gems + mould → jewelry (at furnace)
- `gem_cutting` - Chisel + uncut gem → cut gem

### Runecrafting Recipes

Check warning on line 868 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L868

Did you really mean 'Runecrafting'?

The `recipes/runecrafting.json` manifest defines rune crafting at altars:

Expand Down Expand Up @@ -936,14 +939,14 @@
| **Goblin Slayer** | Novice | 1 | Help Captain Rowan deal with the goblin threat |
| **Lumberjack's First Lesson** | Novice | 1 | Help Forester Wilma gather and burn firewood |
| **Fresh Catch** | Novice | 1 | Help Fisherman Pete catch and cook fish |
| **Torvin's Tools** | Novice | 1 | Help Torvin forge a set of bronze tools |

Check warning on line 942 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L942

Did you really mean 'Torvin's'?

Check warning on line 942 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L942

Did you really mean 'Torvin'?

### Quest Stage Types

- **dialogue** - Talk to an NPC
- **kill** - Defeat a specific number of NPCs

Check warning on line 947 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L947

Did you really mean 'NPCs'?
- **gather** - Collect items through skilling
- **interact** - Use items or stations (cooking, smithing, etc.)

Check warning on line 949 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L949

Did you really mean 'smithing'?

---

Expand All @@ -954,7 +957,7 @@
- Items: Add to appropriate file in `items/` directory
- Gathering: Add to `gathering/woodcutting.json`, `mining.json`, or `fishing.json`
- Recipes: Add to appropriate file in `recipes/` directory
- NPCs: Add to `npcs.json`

Check warning on line 960 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L960

Did you really mean 'NPCs'?
</Step>
<Step title="Follow existing patterns">
Use the same structure as existing entries. For tiered equipment, specify the `tier` field.
Expand All @@ -980,12 +983,12 @@

Three new artisan skills added with complete OSRS-accurate recipe manifests:

- **Fletching**: Arrow shafts, headless arrows, shortbows, longbows, bow stringing, arrow tipping (40+ recipes)

Check warning on line 986 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L986

Did you really mean 'Fletching'?

Check warning on line 986 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L986

Did you really mean 'shortbows'?
- **Crafting**: Leather armor, studded armor, dragonhide armor, jewelry, gem cutting (25+ recipes)

Check warning on line 987 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L987

Did you really mean 'dragonhide'?
- **Runecrafting**: Air, mind, water, earth, fire, chaos runes with multi-rune level thresholds

Check warning on line 988 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L988

Did you really mean 'Runecrafting'?

**New Assets**:
- Firemaking fire 3D model (`models/firemaking-fire/firemaking-fire.glb`)

Check warning on line 991 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L991

Did you really mean 'Firemaking'?
- Comprehensive armor manifest with 80+ armor pieces across all combat styles

### Manifest Refactor (PR #3)
Expand All @@ -994,13 +997,13 @@

- **Items split by type**: Weapons, tools, resources, food, ammunition, runes, armor, and misc are now in separate files
- **Gathering resources**: Woodcutting, mining, and fishing data moved to dedicated files
- **Recipe system**: New recipes directory for smelting, smithing, cooking, firemaking, fletching, crafting, and runecrafting

Check warning on line 1000 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L1000

Did you really mean 'smithing'?

Check warning on line 1000 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L1000

Did you really mean 'firemaking'?

Check warning on line 1000 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L1000

Did you really mean 'fletching'?

Check warning on line 1000 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L1000

Did you really mean 'runecrafting'?
- **Centralized requirements**: `tier-requirements.json` provides OSRS-accurate level requirements
- **Skill unlocks**: `skill-unlocks.json` documents progression milestones

### New Vegetation (PR #4)

Mushroom vegetation added to biomes with configurable density, clustering, and spawn parameters.

Check warning on line 1006 in wiki/data/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (hyperscape-ai) - vale-spellcheck

wiki/data/overview.mdx#L1006

Did you really mean 'biomes'?

---

Expand Down
Loading