Update docs for tree models and biome changes

concepts/manifests.mdx

@@ -6,7 +6,7 @@
 
 ## Overview
 
 Hyperscape uses manifest-driven design where game content is defined in TypeScript data files rather than hardcoded in logic. This enables content creation without modifying game systems.
 
 ## Design Philosophy
 
@@ -20,10 +20,10 @@
 
 ### Benefits
 
 - **Content creators** can add items, NPCs, areas without deep coding
 - **Designers** iterate quickly on balance
 - **Developers** focus on systems, not data
 - **Modders** can extend content easily
 
 ## Manifest Files
 
@@ -40,7 +40,7 @@
 **Production (Railway + Cloudflare):**
 - Manifests fetched from CDN at server startup: `PUBLIC_CDN_URL/manifests/`
 - Cached locally in `packages/server/world/assets/manifests/`
 - Only re-fetched if content changes (HTTP ETag validation)
 - Assets served directly from Cloudflare R2 CDN (no local clone)
 - Frontend served from Cloudflare Pages (separate from game server)
 
@@ -91,7 +91,7 @@
 
 | File | Content |
 |------|---------|
 | `npcs.json` | Mobs and NPCs |
 | `items/` | Equipment, resources, consumables (split by category) |
 | `banks-stores.json` | Shop inventories |
 | `world-areas.json` | Zones and regions |
@@ -100,7 +100,7 @@
 | `tier-requirements.json` | Equipment level requirements by tier |
 | `skill-unlocks.json` | What unlocks at each skill level (served via `/api/data/skill-unlocks`) |
 | `gathering/` | Resource gathering data (woodcutting, mining, fishing) |
 | `recipes/` | Processing recipes (cooking, firemaking, smelting, smithing, fletching, crafting, runecrafting) |
 | `stations.json` | World station configurations (anvils, furnaces, ranges, banks, altars) |
 | `prayers.json` | Prayer definitions with bonuses and drain rates |
 | `quests.json` | Quest definitions with stages, requirements, and rewards |
@@ -116,7 +116,7 @@
 
 ## Manifest Structure
 
 ### NPCs (`npcs.json`)
 
 NPC data is loaded from JSON manifests at runtime by DataManager:
 
@@ -148,13 +148,13 @@
       "defaultDrop": { "enabled": true, "itemId": "bones", "quantity": 1 },
       "common": [{ "itemId": "coins", "minQuantity": 5, "maxQuantity": 15, "chance": 1.0, "rarity": "common" }]
     },
     "appearance": { "modelPath": "asset://models/goblin/goblin.vrm", "scale": 0.75 }
   }
 ]
 ```
 
 <Info>
   NPC definitions are in `world/assets/manifests/npcs.json`, not hardcoded in TypeScript.
 </Info>
 
 ### Items Directory
@@ -201,8 +201,8 @@
 
 ```json
 {
   "id": "dragon_pickaxe",
   "name": "Dragon Pickaxe",
   "type": "tool",
   "tier": "dragon",
   "tool": {
@@ -212,14 +212,14 @@
     "bonusTickChance": 0.167,
     "bonusRollTicks": 2
   },
   "equipSlot": "weapon",
   "weaponType": "PICKAXE",
   "attackType": "MELEE",
   "value": 50000,
   "weight": 2.2,
   "description": "A powerful pickaxe with a chance for bonus mining speed",
   "examine": "A pickaxe with a dragon metal head.",
   "tradeable": true,
   "rarity": "rare",
   "modelPath": "asset://models/pickaxe-dragon/pickaxe-dragon.glb"
 }
@@ -238,18 +238,18 @@
 }
 ```
 
 **Mining Pickaxe Bonus Speed:**
 
 Dragon and crystal pickaxes have a chance to mine faster:
 
 | Pickaxe | Roll Ticks | Bonus Chance | Bonus Ticks | Avg Speed |
 |---------|------------|--------------|-------------|-----------|
 | Bronze | 8 | - | - | 8 ticks |
 | Rune | 3 | - | - | 3 ticks |
 | Dragon | 3 | 1/6 (0.167) | 2 | 2.83 ticks |
 | Crystal | 3 | 1/4 (0.25) | 2 | 2.75 ticks |
 
 The bonus roll is determined **server-side** to maintain determinism and prevent client/server desyncs.
 
 <Info>
 Tools with `equipSlot: "weapon"` can be equipped and used for combat. The tier system automatically derives level requirements from `tier-requirements.json`.
@@ -275,7 +275,7 @@
 | **Eat** | Food items | Shrimp, Lobster, Shark |
 | **Drink** | Potions | Strength potion, Attack potion |
 | **Wield** | Weapons, shields | Bronze sword, Wooden shield |
 | **Wear** | Armor | Bronze platebody, Leather body |
 | **Bury** | Bones | Bones, Big bones, Dragon bones |
 | **Use** | Tools, misc | Tinderbox, Hammer, Logs |
 | **Drop** | Any item | (always available) |
@@ -290,23 +290,37 @@
 {
   "trees": [
     {
-      "id": "tree_normal",
-      "name": "Tree",
+      "id": "oak",
+      "name": "Oak",
       "type": "tree",
       "harvestSkill": "woodcutting",
-      "toolRequired": "bronze_hatchet",
-      "levelRequired": 1,
+      "levelRequired": 15,
       "baseCycleTicks": 4,
       "depleteChance": 0.125,
       "respawnTicks": 80,
+      "modelPath": "asset://trees/oak/oak_01.glb",
+      "modelVariants": [
+        "asset://trees/oak/oak_01.glb",
+        "asset://trees/oak/oak_02.glb",
+        "asset://trees/oak/oak_03.glb"
+      ],
+      "modelScale": 1.2,
       "harvestYield": [
-        { "itemId": "logs", "quantity": 1, "chance": 1.0, "xpAmount": 25 }
+        { "itemId": "oak_logs", "quantity": 1, "chance": 1.0, "xpAmount": 37.5 }
       ]
     }
   ]
 }
 ```
 
+**Tree Model System**:
+- **modelPath**: Primary model for the tree type
+- **modelVariants**: Array of model variants for visual diversity (optional)
+- **modelScale**: Scale multiplier for tree models
+- **LOD support**: Models include LOD levels (_lod1.glb, _lod2.glb) for performance
+- **12 tree types**: bamboo, birch, cactus, chinaPine, coconut, dead, fir, knotwood, maple, oak, palm, pine
+- **Wind pine**: Single-model tree type for tundra biome (uses modelPath only)
+
 **gathering/mining.json** - Ore rocks with OSRS-accurate success rates:
 ```json
 {
@@ -414,7 +428,7 @@
       "model": "asset://models/anvil/anvil.glb",
       "modelScale": 0.5,
       "modelYOffset": 0.2,
       "examine": "An anvil for smithing metal bars into weapons and tools."
     },
     {
       "type": "furnace",
@@ -487,7 +501,7 @@
 
 ## DataManager
 
 The `DataManager` class loads all manifests and populates runtime data structures. Smithing, cooking, and other processing skills use recipe manifests:
 
 **Smelting Recipe** (`recipes/smelting.json`):
 ```json
@@ -508,7 +522,7 @@
 }
 ```
 
 **Smithing Recipe** (`recipes/smithing.json`):
 ```json
 {
   "recipes": [
@@ -587,12 +601,12 @@
 **Prayer Fields:**
 - `id` — Unique prayer ID (lowercase, underscores, max 64 chars)
 - `name` — Display name
 - `description` — Effect description for tooltip
 - `icon` — Emoji icon for UI
 - `level` — Required Prayer level (1-99)
 - `category` — "offensive", "defensive", or "utility"
 - `drainEffect` — Drain rate (higher = faster drain)
 - `bonuses` — Combat stat multipliers (attackMultiplier, strengthMultiplier, defenseMultiplier)
 - `conflicts` — Array of prayer IDs that conflict with this prayer
 
 <Info>
@@ -632,12 +646,12 @@
 
 ### Development vs Production
 
 Hyperscape uses different manifest loading strategies for development and production:
 
 **Development (Local):**
 - Manifests loaded from `packages/server/world/assets/manifests/`
 - Assets cloned via Git LFS during `bun install`
 - CDN serves from local Docker nginx container
 
 **Production (Railway/Cloudflare):**
 - Manifests fetched from CDN at server startup
@@ -680,7 +694,7 @@
 ```
 
 <Info>
 This architecture allows content updates (new items, NPCs, balance changes) to be deployed by updating manifests on the CDN, without requiring server redeployment or downtime.
 </Info>
 
 ## DataManager
@@ -837,16 +851,16 @@
 - **Atomic loading**: Items directory loads all files or falls back to legacy format
 
 <Warning>
   Invalid JSON syntax will cause server startup to fail. Use a JSON validator before committing changes.
 </Warning>
 
 ## Data Providers
 
 The manifest system uses specialized data providers for efficient lookups:
 
 | Provider | Purpose | Manifest Source |
 |----------|---------|-----------------|
 | `ProcessingDataProvider` | Cooking, firemaking, smelting, smithing recipes | `recipes/*.json` |
 | `TierDataProvider` | Equipment level requirements by tier | `tier-requirements.json` |
 | `StationDataProvider` | Station models and configurations | `stations.json` |
 | `DataManager` | Central loader for all manifests | All manifests |
@@ -910,7 +924,7 @@
 - Models loaded via `ModelCache` with transform baking
 - `modelYOffset` raises model so base sits on ground
 - Graceful fallback to blue box placeholder if model fails
 - Shadows and raycasting layers configured automatically
 
 ### Quests (`quests.json`)
 
@@ -1031,7 +1045,7 @@
 **Properties**:
 - `id` — Unique prayer identifier
 - `name` — Display name shown in prayer book
 - `description` — Effect description for tooltip
 - `icon` — Icon asset path for prayer book UI
 - `level` — Prayer level required to unlock
 - `category` — Prayer type: `offensive`, `defensive`, or `utility`
@@ -1105,7 +1119,7 @@
 ```
 
 **Quest Properties**:
 - `id` — Unique quest identifier (snake_case)
 - `name` — Display name shown in quest journal
 - `description` — Quest summary
 - `difficulty` — `novice`, `intermediate`, `experienced`, `master`
@@ -1134,7 +1148,7 @@
 
 ## Overview
 
 Hyperscape uses manifest-driven design where game content is defined in TypeScript data files rather than hardcoded in logic. This enables content creation without modifying game systems.
 
 ## Design Philosophy
 
@@ -1148,10 +1162,10 @@
 
 ### Benefits
 
 - **Content creators** can add items, NPCs, areas without deep coding
 - **Designers** iterate quickly on balance
 - **Developers** focus on systems, not data
 - **Modders** can extend content easily
 
 ## Manifest Files
 
@@ -1159,7 +1173,7 @@
 
 | File | Content |
 |------|---------|
 | `npcs.json` | Mobs and NPCs |
 | `items/` | Equipment, resources, consumables (split by category) |
 | `banks-stores.json` | Shop inventories |
 | `world-areas.json` | Zones and regions |
@@ -1167,7 +1181,7 @@
 | `tier-requirements.json` | Equipment level requirements by tier |
 | `skill-unlocks.json` | What unlocks at each skill level |
 | `gathering/` | Resource gathering data (woodcutting, mining, fishing) |
 | `recipes/` | Processing recipes (cooking, firemaking, smelting, smithing) |
 | `stations.json` | World station configurations (anvils, furnaces, ranges) |
 | `prayers.json` | Prayer definitions with bonuses and drain rates |
 | `quests.json` | Quest definitions with stages, requirements, and rewards |
@@ -1175,7 +1189,7 @@
 
 ## Manifest Structure
 
 ### NPCs (`npcs.json`)
 
 NPC data is loaded from JSON manifests at runtime by DataManager:
 
@@ -1213,7 +1227,7 @@
 ```
 
 <Info>
   NPC definitions are in `world/assets/manifests/npcs.json`, not hardcoded in TypeScript.
 </Info>
 
 ### Items Directory
@@ -1297,7 +1311,7 @@
 }
 ```
 
 **Mining Pickaxe Bonus Speed:**
 
 Dragon and crystal pickaxes have a chance to mine faster:
 
@@ -1308,7 +1322,7 @@
 | Dragon | 3 | 1/6 (0.167) | 2 | 2.83 ticks |
 | Crystal | 3 | 1/4 (0.25) | 2 | 2.75 ticks |
 
 The bonus roll is determined **server-side** to maintain determinism and prevent client/server desyncs.
 
 <Info>
 Tools with `equipSlot: "weapon"` can be equipped and used for combat. The tier system automatically derives level requirements from `tier-requirements.json`.
@@ -1334,7 +1348,7 @@
 | **Eat** | Food items | Shrimp, Lobster, Shark |
 | **Drink** | Potions | Strength potion, Attack potion |
 | **Wield** | Weapons, shields | Bronze sword, Wooden shield |
 | **Wear** | Armor | Bronze platebody, Leather body |
 | **Bury** | Bones | Bones, Big bones, Dragon bones |
 | **Use** | Tools, misc | Tinderbox, Hammer, Logs |
 | **Drop** | Any item | (always available) |
@@ -1476,7 +1490,7 @@
 - Station footprint calculated from model bounds × scale
 - Flat zone created with dimensions: `(footprint + padding × 2)`
 - Terrain height sampled at station center position
 - Smoothstep blending (t² × (3 - 2t)) creates natural transitions
 - Spatial indexing using terrain tiles (100m) for O(1) lookup
 
 <Info>
@@ -1569,7 +1583,7 @@
 
 ## DataManager
 
 Smithing, cooking, and other processing skills use recipe manifests:
 
 **Smelting Recipe** (`recipes/smelting.json`):
 ```json
@@ -1590,7 +1604,7 @@
 }
 ```
 
 **Smithing Recipe** (`recipes/smithing.json`):
 ```json
 {
   "recipes": [
@@ -1735,7 +1749,7 @@
 **StationSpawnerSystem:**
 - Reads `stations` field from WorldArea definitions
 - Spawns station entities at configured positions
 - Replaces hardcoded station spawning in EntityManager
 - Uses `getStationsInArea()` helper for querying
 
 ### Step 1: Choose the Right Manifest
@@ -1787,16 +1801,16 @@
 - **Atomic loading**: Items directory loads all files or falls back to legacy format
 
 <Warning>
   Invalid JSON syntax will cause server startup to fail. Use a JSON validator before committing changes.
 </Warning>
 
 ## Data Providers
 
 The manifest system uses specialized data providers for efficient lookups:
 
 | Provider | Purpose | Manifest Source |
 |----------|---------|-----------------|
 | `ProcessingDataProvider` | Cooking, firemaking, smelting, smithing recipes | `recipes/*.json` |
 | `TierDataProvider` | Equipment level requirements by tier | `tier-requirements.json` |
 | `StationDataProvider` | Station models and configurations | `stations.json` |
 | `DataManager` | Central loader for all manifests | All manifests |
@@ -1828,7 +1842,7 @@
 - Models loaded via `ModelCache` with transform baking
 - `modelYOffset` raises model so base sits on ground
 - Graceful fallback to blue box placeholder if model fails
 - Shadows and raycasting layers configured automatically
 
 ### Quests (`quests.json`)
 
@@ -1911,9 +1925,9 @@
 
 **Available Quests:**
 - **Goblin Slayer** — Combat tutorial (kill 15 goblins)
 - **Lumberjack's First Lesson** — Woodcutting and firemaking tutorial
 - **Fresh Catch** — Fishing and cooking tutorial
 - **Torvin's Tools** — Mining, smelting, and smithing tutorial
 
 <Info>
 Quest progress is tracked server-side. Each stage must be completed in order before advancing to the next stage.
@@ -1948,7 +1962,7 @@
 **Properties**:
 - `id` — Unique prayer identifier
 - `name` — Display name shown in prayer book
 - `description` — Effect description for tooltip
 - `icon` — Icon asset path for prayer book UI
 - `level` — Prayer level required to unlock
 - `category` — Prayer type: `offensive`, `defensive`, or `utility`
@@ -2014,19 +2028,19 @@
 - **Placement Validation** — Ensure entities fit within available space
 - **Collision Detection** — Fast AABB checks for physics and interactions
 - **Tile Occupancy** — Calculate which tiles an entity occupies
 - **Spatial Queries** — Optimize raycasting and proximity checks
 
 The bounds are automatically generated from the actual 3D model geometry and updated when models change.
 
 ## Best Practices
 
 1. **Use descriptive IDs**: `bronze_sword` not `sword1`
 2. **Follow naming conventions**: snake_case for IDs
 3. **Organize by category**: Use the directory structure (items/, recipes/, gathering/)
 4. **Test after changes**: Verify in-game before committing
 5. **Keep data flat**: Avoid deep nesting in manifest structures
 6. **Use tier system**: Leverage TierDataProvider for equipment requirements instead of hardcoding
 7. **Validate JSON**: Use a JSON validator before committing to catch syntax errors
 
 ## Manifest Loading Order
 
@@ -2035,7 +2049,7 @@
 1. **Tier requirements** (`tier-requirements.json`) - Needed for item normalization
 2. **Model bounds** (`model-bounds.json`) - Needed for station footprint calculation
 3. **Items** (`items/` directory or `items.json` fallback)
 4. **NPCs** (`npcs.json`)
 5. **Gathering resources** (`gathering/*.json`)
 6. **Recipe manifests** (`recipes/*.json`)
 7. **Skill unlocks** (`skill-unlocks.json`)
@@ -2060,7 +2074,7 @@
 
 **Process:**
 1. Scans `world/assets/models/**/*.glb` files
 2. Parses glTF position accessor min/max values
 3. Calculates bounding boxes and footprints at scale 1.0
 4. Writes to `world/assets/manifests/model-bounds.json`
 

concepts/skills.mdx

@@ -6,11 +6,11 @@
 
 ## Overview
 
 Hyperscape features a RuneScape-inspired skill system with leveling, XP gain, and level requirements for equipment and activities.
 
 ## Available Skills
 
 Hyperscape has **14 skills** total:
 
 ### Combat Skills
 
@@ -36,12 +36,12 @@
 
 | Skill | Activity |
 |-------|----------|
 | **Firemaking** | Create fires from logs |
 | **Cooking** | Prepare food from raw fish |
 | **Smithing** | Smelt ores into bars and smith equipment |
 | **Fletching** | Craft bows and arrows from logs |
 | **Crafting** | Create leather armor, jewelry, and cut gems |
 | **Runecrafting** | Craft elemental and combat runes at altars |
 
 ### Support Skills
 
@@ -57,13 +57,13 @@
 
 - **Combat** — Damage dealt grants Attack/Strength/Defense/Constitution XP
 - **Gathering** — Woodcutting, Mining, Fishing grant XP per resource
 - **Artisan** — Firemaking, Cooking, Smithing grant XP per action
 - **Quest Rewards** — Quests award XP to specific skills
 - **XP Lamps** — Quest rewards that grant XP to chosen skill
 
 ### XP Formula
 
 Hyperscape uses RuneScape's XP curve:
 
 ```
 XP for Level N = floor(sum(floor(L + 300 * 2^(L/7))) / 4) for L = 1 to N-1
@@ -95,18 +95,34 @@
 | Normal | 1 | 25 |
 | Oak | 15 | 37.5 |
 | Willow | 30 | 67.5 |
+| Maple | 45 | 100 |
 | Yew | 60 | 175 |
 | Magic | 75 | 250 |
 
+**Available Tree Types** (12 types with visual variants):
+- **Bamboo** - Fast-growing tropical tree
+- **Birch** - Light-colored deciduous tree
+- **Cactus** - Desert vegetation
+- **China Pine** - Asian conifer variant
+- **Coconut** - Tropical palm with coconuts
+- **Dead** - Withered tree variants
+- **Fir** - Evergreen conifer
+- **Knotwood** - Gnarled tree with amber leaves (#C4832A)
+- **Maple** - Deciduous hardwood
+- **Oak** - Classic hardwood tree
+- **Palm** - Tropical palm tree
+- **Pine** - Standard conifer
+- **Wind Pine** - Tundra-specific wind-swept pine (single model)
+
 ### Mining
 
 Requirements:
 - Pickaxe in inventory or equipped
 - Click ore rock to mine
 
 **OSRS-Accurate Mechanics:**
 - Pickaxe tier affects **roll frequency** (not success rate)
 - Success rate is **level-only** (pickaxe doesn't affect it)
 - Rocks have **100% depletion** on successful mine (1/8 chance)
 - Dragon/Crystal pickaxes have **bonus speed rolls**
 
@@ -115,18 +131,18 @@
 | Copper/Tin | 1 | 17.5 | 1/8 chance |
 | Iron | 15 | 35 | 1/8 chance |
 | Coal | 30 | 50 | 1/8 chance |
 | Mithril | 55 | 80 | 1/8 chance |
 | Adamantite | 70 | 95 | 1/8 chance |
 | Runite | 85 | 125 | 1/8 chance |
 
 **Pickaxe Tiers:**
 
 | Pickaxe | Level | Roll Ticks | Bonus Speed |
 |---------|-------|------------|-------------|
 | Bronze | 1 | 8 ticks | None |
 | Iron | 1 | 7 ticks | None |
 | Steel | 6 | 6 ticks | None |
 | Mithril | 21 | 5 ticks | None |
 | Adamant | 31 | 4 ticks | None |
 | Rune | 41 | 3 ticks | None |
 | Dragon | 61 | 3 ticks | 1/6 chance for 2 ticks |
@@ -152,7 +168,7 @@
 
 ### Agility
 
 Agility is trained passively by moving through the world. Unlike traditional RuneScape agility courses, Hyperscape's Agility system rewards exploration and travel.
 
 **Training Method:**
 - Gain 1 XP per 2 tiles traveled (walking or running)
@@ -160,7 +176,7 @@
 - XP drops appear every ~15 seconds while running, ~30 seconds while walking
 
 **Benefits:**
 - **Stamina Regeneration**: +1% stamina regen per Agility level
   - Level 1: 1% bonus (4.04/sec idle, 2.02/sec walking)
   - Level 50: 50% bonus (6.0/sec idle, 3.0/sec walking)
   - Level 99: 99% bonus (7.96/sec idle, 3.98/sec walking)
@@ -175,7 +191,7 @@
 
 ## Artisan Skills
 
 ### Firemaking
 
 Use tinderbox on logs in inventory to create a fire.
 
@@ -200,14 +216,14 @@
 | Shark | 80 | 210 | 20 HP |
 
 **Cooking Sources:**
 - **Fires**: Created via Firemaking skill (temporary)
 - **Ranges**: Permanent cooking stations found in towns
 
 <Warning>
   Cooking can fail at low levels, burning the food. Ranges reduce burn chance compared to fires.
 </Warning>
 
 ### Fletching
 
 Craft bows and arrows from logs using a knife.
 
@@ -224,26 +240,26 @@
 **Bows** (Knife + Logs, then String):
 | Bow | Level | XP (Cut) | XP (String) |
 |-----|-------|----------|-------------|
 | Shortbow | 5 | 5 | 5 |
 | Longbow | 10 | 10 | 10 |
 | Oak Shortbow | 20 | 16.5 | 16.5 |
 | Oak Longbow | 25 | 25 | 25 |
 | Willow Shortbow | 35 | 33.3 | 33.3 |
 | Willow Longbow | 40 | 41.5 | 41.5 |
 | Maple Shortbow | 50 | 50 | 50 |
 | Maple Longbow | 55 | 58.3 | 58.3 |
 | Yew Shortbow | 65 | 67.5 | 67.5 |
 | Yew Longbow | 70 | 75 | 75 |
 | Magic Shortbow | 80 | 83.3 | 83.3 |
 | Magic Longbow | 85 | 91.5 | 91.5 |
 
 **Arrows** (Arrowtips + Headless Arrows):
 | Arrow | Level | XP (per 15) |
 |-------|-------|-------------|
 | Bronze | 1 | 19.5 |
 | Iron | 15 | 37.5 |
 | Steel | 30 | 75 |
 | Mithril | 45 | 112.5 |
 | Adamant | 60 | 150 |
 | Rune | 75 | 187.5 |
 
@@ -262,12 +278,12 @@
 | Leather Chaps | 18 | 27 |
 | Coif | 38 | 37 |
 
 **Dragonhide Armor** (Needle + Thread + Dragon Leather):
 | Item | Level | Leather | XP |
 |------|-------|---------|-----|
 | Green D'hide Vambraces | 57 | 1 | 62 |
 | Green D'hide Chaps | 60 | 2 | 124 |
 | Green D'hide Body | 63 | 3 | 186 |
 
 **Jewelry** (Gold Bar + Gem at Furnace):
 | Item | Level | XP |
@@ -286,12 +302,12 @@
 | Emerald | 27 | 67.5 |
 | Ruby | 34 | 85 |
 | Diamond | 43 | 107.5 |
 | Dragonstone | 55 | 137.5 |
 | Onyx | 67 | 167.5 |
 
 ### Runecrafting
 
 Craft elemental and combat runes at runecrafting altars using essence.
 
 | Rune | Level | XP per Essence | Multi-Rune Levels |
 |------|-------|----------------|-------------------|
@@ -303,10 +319,10 @@
 | Chaos | 35 | 8.5 | 74 |
 
 <Info>
   Multi-rune levels allow you to craft multiple runes per essence. For example, at level 11 Runecrafting, you craft 2 air runes per essence instead of 1.
 </Info>
 
 ### Smithing
 
 Smelt ores into bars at furnaces, then smith bars into equipment at anvils.
 
@@ -317,9 +333,9 @@
 | Bronze | 1 | 1 Copper + 1 Tin | 6.25 | 100% |
 | Iron | 15 | 1 Iron Ore | 12.5 | 50% |
 | Steel | 30 | 1 Iron Ore + 2 Coal | 17.5 | 100% |
 | Mithril | 50 | 1 Mithril Ore + 4 Coal | 30 | 100% |
 | Adamant | 70 | 1 Adamantite Ore + 6 Coal | 37.5 | 100% |
 | Rune | 85 | 1 Runite Ore + 8 Coal | 50 | 100% |
 
 <Info>
   Iron ore has a 50% failure rate when smelting, matching OSRS mechanics.
@@ -327,7 +343,7 @@
 
 ### Agility
 
 Agility is a unique skill that rewards players for traversing the game world. Unlike traditional RuneScape agility courses, Hyperscape's agility system is integrated with movement and stamina mechanics.
 
 #### Training Agility
 
@@ -346,9 +362,9 @@
 
 #### Agility Benefits
 
 **Stamina Regeneration Bonus**: +1% stamina regen per agility level
 
 | Agility Level | Regen Multiplier | Idle Regen/Sec | Walk Regen/Sec |
 |---------------|------------------|----------------|----------------|
 | 1 | 1.01x | 4.04 | 2.02 |
 | 25 | 1.25x | 5.00 | 2.50 |
@@ -377,9 +393,9 @@
   Heavy loads significantly increase stamina drain. Manage your inventory weight for optimal running efficiency.
 </Warning>
 
 #### Smithing (at Anvil)
 
 Click an anvil to open the smithing interface. **Requires a hammer in your inventory** (not consumed). Select the item to smith and quantity.
 
 **Weapons:**
 
@@ -389,23 +405,23 @@
 | Bronze Scimitar | 5 | 2 Bronze | 25 | 4 |
 | Iron Sword | 19 | 1 Iron | 25 | 4 |
 | Steel Sword | 34 | 1 Steel | 37.5 | 4 |
 | Mithril Sword | 54 | 1 Mithril | 50 | 4 |
 
 **Armor:**
 
 | Item | Level | Bars Required | XP | Ticks |
 |------|-------|---------------|-----|-------|
 | Bronze Platebody | 18 | 5 Bronze | 62.5 | 4 |
 | Iron Platebody | 33 | 5 Iron | 125 | 4 |
 | Steel Platebody | 48 | 5 Steel | 187.5 | 4 |
 | Mithril Platebody | 68 | 5 Mithril | 250 | 4 |
 
 **Tools:**
 
 | Item | Level | Bars Required | XP | Ticks |
 |------|-------|---------------|-----|-------|
 | Bronze Hatchet | 1 | 1 Bronze | 12.5 | 4 |
 | Bronze Pickaxe | 1 | 1 Bronze | 12.5 | 4 |
 | Iron Hatchet | 16 | 1 Iron | 25 | 4 |
 | Steel Hatchet | 31 | 1 Steel | 37.5 | 4 |
 
@@ -414,7 +430,7 @@
 </Warning>
 
 <Info>
   Smithing supports "Make X" functionality - you can smith multiple items in one session. The system auto-smiths until you run out of bars or reach the target quantity.
 </Info>
 
 ## Equipment Level Requirements
@@ -426,7 +442,7 @@
 | Bronze | 1 | 1 |
 | Iron | 5 | - |
 | Steel | 10 | 10 |
 | Mithril | 20 | 20 |
 | Adamant | 30 | - |
 | Rune | 40 | - |
 | Dragon | 60 | - |
@@ -447,7 +463,7 @@
 **Features**:
 - Visual distinction between unlocked (green) and locked (gray) items
 - Next unlock highlighted with progress indicator
 - Scrollable list for skills with many unlocks
 - Type indicators (item vs ability)
 - Shows levels needed to reach next unlock
 
@@ -481,7 +497,7 @@
 ```
 
 <Info>
   Constitution starts at level 10 (1,154 XP) like RuneScape's Hitpoints.
   Player health equals their Constitution level.
 </Info>
 
@@ -514,8 +530,8 @@
 **Available Skills:**
 - Attack, Strength, Defense, Constitution
 - Ranged, Prayer
 - Mining, Smithing, Fishing, Cooking, Firemaking, Woodcutting
 - Agility, Fletching, Runecrafting
 
 <Info>
   XP lamps are commonly awarded as quest rewards, allowing you to boost the skill of your choice.

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 |
 
@@ -179,8 +179,55 @@
 **Vegetation**:
 ```
 /assets/trees/
-└── mushroom.glb                 → Giant mushroom (new)
-```
+├── bamboo/
+│   ├── bamboo_01.glb            → Bamboo variant 1 (LOD 0)
+│   ├── bamboo_01_lod1.glb       → Bamboo variant 1 (LOD 1)
+│   ├── bamboo_01_lod2.glb       → Bamboo variant 1 (LOD 2)
+│   └── ... (55 variants × 3 LOD levels)
+├── birch/
+│   ├── birch_01.glb             → Birch variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── cactus/
+│   ├── cactus_01.glb            → Cactus variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── chinaPine/
+│   ├── chinaPine_01.glb         → China Pine variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── coconut/
+│   ├── coconut_01.glb           → Coconut palm variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── dead/
+│   ├── dead_01.glb              → Dead tree variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── fir/
+│   ├── fir_01.glb               → Fir tree variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── knotwood/
+│   ├── knotwood_01.glb          → Knotwood variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── maple/
+│   ├── maple_01.glb             → Maple variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── oak/
+│   ├── oak_01.glb               → Oak variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── palm/
+│   ├── palm_01.glb              → Palm tree variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── pine/
+│   ├── pine_01.glb              → Pine tree variant 1 (LOD 0)
+│   └── ... (variants with LOD levels)
+├── windPine/
+│   └── windPine.glb             → Wind-swept pine (single model)
+└── mushroom.glb                 → Giant mushroom
+```
+
+**Tree Model System**:
+- **165 tree models** total (55 variants × 3 LOD levels)
+- **12 tree types**: bamboo, birch, cactus, chinaPine, coconut, dead, fir, knotwood, maple, oak, palm, pine
+- **13th type**: windPine (single model for tundra biome)
+- **LOD levels**: LOD 0 (high detail), LOD 1 (medium), LOD 2 (low)
+- **Model variants**: Each tree type has multiple visual variants for diversity
 
 ### NPC Helper Functions
 
@@ -259,10 +306,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 +356,7 @@
 
 ### Bank Notes
 
 The system supports bank notes for stackable versions of items:
 
 ```typescript
 // From packages/shared/src/data/items.ts
@@ -332,7 +379,7 @@
 
 ## Drop Tables
 
 NPCs have tiered drop tables:
 
 ```typescript
 interface DropTable {
@@ -396,7 +443,7 @@
 
 ## World Areas
 
 World areas define zones, biomes, and spawn points:
 
 ```
 packages/shared/src/data/
@@ -412,7 +459,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 +480,7 @@
 
 ## Stations
 
 Crafting stations are interactive objects that enable processing skills like smithing, smelting, and cooking:
 
 ```typescript
 interface StationData {
@@ -544,7 +591,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 +643,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 +679,7 @@
 | Dragon | 2 |
 | Rune | 3 |
 | Adamant | 4 |
 | Mithril | 5 |
 | Steel | 6 |
 | Iron | 7 |
 | Bronze | 8 (worst) |
@@ -644,14 +691,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 +730,31 @@
 - `fallen_tree` - Fallen logs
 - `mushroom` - Giant mushrooms (added in recent update)
 
+### Biome Configuration
+
+**Active Biomes** (3 biomes):
+- **Tundra** - Cold, snowy terrain with wind pines
+- **Forest** - Temperate woodland with varied tree types
+- **Canyon** - Rocky, arid terrain with steep slopes
+
+**Biome Terrain Textures**:
+Biomes now use dedicated terrain textures for realistic ground rendering:
+- **Grass textures**: Biome-specific grass variants
+- **Dirt textures**: Soil and earth textures
+- **Cliff textures**: Rocky cliff faces
+- **Desert textures**: Sandy terrain
+- **Snow textures**: Snowy ground for tundra
+
+**Walkability Thresholds** (maxSlope adjustments):
+- **Tundra**: 0.8 → 1.8 (allows steeper terrain navigation)
+- **Forest**: 0.8 → 1.5 (moderate slope tolerance)
+- **Canyon**: 0.6 → 2.5 (very steep terrain allowed)
+
+These adjustments 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:
 
 ```typescript
 interface VegetationLayer {
@@ -704,10 +773,15 @@
 ```
 
 **Recent Updates**:
+- **Tree system overhaul**: 165 tree models added (12 types × variants × 3 LOD levels)
+- **Terrain textures**: Biome-specific textures added for grass, dirt, cliff, desert, and snow
+- **Biome configuration**: Reduced to 3 active biomes (tundra, forest, canyon)
+- **Walkability adjustments**: maxSlope thresholds increased (tundra: 0.8→1.8, forest: 0.8→1.5, canyon: 0.6→2.5)
+- **Tree management**: Trees now managed via TreeTypes.ts + woodcutting.json (removed from vegetation layers)
+- **Wind pine**: New tundra-specific tree type (single model)
+- **Knotwood recolor**: Leaves changed from golden-yellow to warm amber (#C4832A)
 - 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`)
 
 ---
 
@@ -715,7 +789,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 +813,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 +845,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 +923,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 +941,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 +967,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 +981,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.
 
 ---