Document March 2026 asset updates

changelog/2026-01.mdx

@@ -1,8 +1,40 @@
 ---
 title: "January 2026"
 description: "Duel Arena, Prayer, Collision, Smithing, Website, and UI Improvements"
 ---
 
+## March 2026
+
+### Tree Model Updates
+
+*Merged: March 12, 2026*
+
+Visual improvements to tree models and biome vegetation:
+
+- **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
+- **Manifest**: Updated `vegetation.json` with new wind pine tree type
+
+---
+
+### Biome Configuration Updates
+
+*Merged: March 9-10, 2026*
+
+Biome system synchronized with server configuration:
+
+- **Active Biomes**: Reduced from 8 biomes to 3 active biomes (tundra, forest, canyon)
+- **Walkability Thresholds**: Increased maxSlope values to match terrain generation
+  - Tundra: 0.8 → 1.8
+  - Forest: 0.8 → 1.5
+  - Canyon: 0.6 → 2.5
+- **Terrain Textures**: Fixed biome textures with actual source textures from `terrain_textures/`
+- **Manifest**: `biomes.json` synchronized with server version
+
+---
+
 ## Week 6: February 2-6
 
 ### Ammunition Manifest Update
@@ -11,8 +43,8 @@
 
 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
 
@@ -26,7 +58,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
 
 ---
 
@@ -45,11 +77,11 @@
 
 ---
 
 ### 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`
@@ -57,11 +89,11 @@
 
 ---
 
 ### 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)
@@ -71,18 +103,18 @@
 
 ---
 
 ### 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
 
@@ -96,9 +128,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)
 - **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
@@ -111,8 +143,8 @@
 
 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
@@ -128,9 +160,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)
 - **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`
@@ -184,9 +216,9 @@
 
 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
 
@@ -215,12 +247,12 @@
 
 ---
 
 ### 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
 
 ---
 
@@ -237,22 +269,22 @@
 
 - **#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
@@ -266,7 +298,7 @@
 
 *Merged: January 10, 2026*
 
 - **Colors**: Orange items, yellow NPCs, cyan objects
 - **Actions**: Manifest-driven inventory actions, heuristic fallback
 - Centralized InventoryActionDispatcher, item helper utilities
 
@@ -276,7 +308,7 @@
 
 *Merged: January 10, 2026*
 
 - 3-tick eat delay, combat integration (+3 ticks to attack cooldown)
 - Server-authoritative, EatDelayManager, event-driven health updates
 
 ---
@@ -294,4 +326,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

wiki/data/overview.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Data Manifests Overview"
 description: "Manifest-driven content system for NPCs, items, and world areas"
 icon: "database"
 ---
 
@@ -58,12 +58,12 @@
 │   └── misc.json         # Miscellaneous items
 ├── recipes/              # Crafting recipes by skill
 │   ├── cooking.json      # Cooking recipes
 │   ├── firemaking.json   # Firemaking recipes
 │   ├── smelting.json     # Ore smelting recipes
 │   ├── smithing.json     # Smithing recipes
 │   ├── fletching.json    # Fletching recipes (NEW)
 │   ├── crafting.json     # Crafting recipes (NEW)
 │   ├── runecrafting.json # Runecrafting recipes (NEW)
 │   └── tanning.json      # Leather tanning recipes
 ├── gathering/            # Gathering skill data
 │   ├── woodcutting.json  # Tree data
@@ -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 |
 | `modelPath` | `string` | Path to 3D model |
 | `behavior` | `"passive" \| "aggressive"` | Combat behavior |
 
@@ -259,10 +259,10 @@
 ```
 
 **Supported Tiers:**
 - **Melee**: bronze, iron, steel, black, mithril, adamant, rune, dragon
 - **Tools**: Same as melee (with different skill requirements)
 - **Ranged**: leather, studded, green_dhide, blue_dhide, red_dhide, black_dhide
 - **Magic**: wizard, mystic, infinity, ahrims
 
 ### Item Helper Functions
 
@@ -309,7 +309,7 @@
 
 ### Bank Notes
 
 The system supports bank notes for stackable versions of items:
 
 ```typescript
 // From packages/shared/src/data/items.ts
@@ -332,7 +332,7 @@
 
 ## Drop Tables
 
 NPCs have tiered drop tables:
 
 ```typescript
 interface DropTable {
@@ -396,7 +396,7 @@
 
 ## World Areas
 
 World areas define zones, biomes, and spawn points:
 
 ```
 packages/shared/src/data/
@@ -412,7 +412,7 @@
 | `name` | Display name |
 | `biome` | Biome type (forest, plains, etc.) |
 | `difficulty` | 0-3 difficulty level |
 | `mobs` | NPCs that spawn here |
 | `resources` | Trees, fishing spots, etc. |
 | `isSafe` | Whether it's a safe zone |
 
@@ -433,7 +433,7 @@
 
 ## Stations
 
 Crafting stations are interactive objects that enable processing skills like smithing, smelting, and cooking:
 
 ```typescript
 interface StationData {
@@ -544,7 +544,7 @@
 
 Stations are defined in `stations.json`:
 
 - **Anvil** - Used for smithing bars into equipment
 - **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
@@ -596,7 +596,7 @@
 
 | Station | Purpose | Model | Scale | Y Offset |
 |---------|---------|-------|-------|----------|
 | **Anvil** | Smithing bars into equipment | `models/anvil/anvil.glb` | 0.5 | 0.2 |
 | **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 |
@@ -632,7 +632,7 @@
 | Dragon | 2 |
 | Rune | 3 |
 | Adamant | 4 |
 | Mithril | 5 |
 | Steel | 6 |
 | Iron | 7 |
 | Bronze | 8 (worst) |
@@ -644,14 +644,14 @@
 | Dragon | 2 | 3 |
 | Rune | 3 | 3 |
 | Adamant | 4 | 4 |
 | Mithril | 5 | 5 |
 | Steel | 6 | 6 |
 | Iron | 7 | 7 |
 | Bronze | 8 | 8 |
 
 ---
 
 ## Vegetation & Biomes
 
 ### Vegetation Assets
 
@@ -683,9 +683,19 @@
 - `fallen_tree` - Fallen logs
 - `mushroom` - Giant mushrooms (added in recent update)
 
+### Biome Configuration
+
+Biomes in `biomes.json` define terrain properties and procedural vegetation layers. The active biome set includes:
+
+- **Tundra** - Frozen terrain with wind pines (maxSlope: 1.8)
+- **Forest** - Dense woodland areas (maxSlope: 1.5)
+- **Canyon** - Rocky terrain with steep slopes (maxSlope: 2.5)
+
+The `maxSlope` threshold determines walkability and vegetation placement, adjusted to match actual terrain generation slopes from terracing and landscape features.
+
 ### Biome Vegetation Layers
 
-Biomes in `biomes.json` define procedural vegetation layers that reference vegetation assets:
+Biomes define procedural vegetation layers that reference vegetation assets:
 
 ```typescript
 interface VegetationLayer {
@@ -704,10 +714,14 @@
 ```
 
 **Recent Updates**:
 - Mushroom vegetation added to all biomes with varying densities (2-30)
 - 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`)
+- Wind pine tree type added for tundra biome (split from dead tree variants)
+- Maple tree leaves recolored to warm vermillion red-orange (#D04838)
+- Knotwood tree leaves recolored from golden-yellow to warm amber (#C4832A)
+- Tree model scales adjusted for better visual proportions
 
 ---
 
@@ -715,7 +729,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
 
 The `recipes/fletching.json` manifest defines bow and arrow crafting:
 
@@ -739,10 +753,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
 - `longbows` - Knife + logs → unstrung longbows
 - `stringing` - Bowstring + unstrung bow → finished bow
 - `arrows` - Arrowtips + headless arrows → finished arrows
 
 ### Crafting Recipes
 
@@ -771,11 +785,11 @@
 **Recipe Categories**:
 - `leather` - Needle + thread + leather → leather armor
 - `studded` - Leather armor + steel studs → studded armor
 - `dragonhide` - Needle + thread + dragon leather → dragonhide armor
 - `jewelry` - Gold bar + gems + mould → jewelry (at furnace)
 - `gem_cutting` - Chisel + uncut gem → cut gem
 
 ### Runecrafting Recipes
 
 The `recipes/runecrafting.json` manifest defines rune crafting at altars:
 
@@ -849,14 +863,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 |
 
 ### Quest Stage Types
 
 - **dialogue** - Talk to an NPC
 - **kill** - Defeat a specific number of NPCs
 - **gather** - Collect items through skilling
 - **interact** - Use items or stations (cooking, smithing, etc.)
 
 ---
 
@@ -867,7 +881,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`
   </Step>
   <Step title="Follow existing patterns">
     Use the same structure as existing entries. For tiered equipment, specify the `tier` field.
@@ -893,12 +907,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)
 - **Crafting**: Leather armor, studded armor, dragonhide armor, jewelry, gem cutting (25+ recipes)
 - **Runecrafting**: Air, mind, water, earth, fire, chaos runes with multi-rune level thresholds
 
 **New Assets**:
 - Firemaking fire 3D model (`models/firemaking-fire/firemaking-fire.glb`)
 - Comprehensive armor manifest with 80+ armor pieces across all combat styles
 
 ### Manifest Refactor (PR #3)
@@ -907,13 +921,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
 - **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.
 
 ---