Skip to content
Open
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
32 changes: 32 additions & 0 deletions changelog/2026-01.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,40 @@
---
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'?
---

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L15

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L16

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

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 'Biomes'?

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 'biomes'?

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 'biomes'?
- **Walkability Thresholds**: Increased maxSlope values to match terrain generation

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 'Walkability'?

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 'maxSlope'?
- 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
Expand All @@ -11,8 +43,8 @@

Updated ammunition manifest with comprehensive arrow definitions:

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L46

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L47

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

Expand All @@ -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

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

View check run for this annotation

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

changelog/2026-01.mdx#L61

Did you really mean 'NPCs'?

---

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

---

### Firemaking Fire Model

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

View check run for this annotation

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

changelog/2026-01.mdx#L80

Did you really mean 'Firemaking'?

*Merged: February 1, 2026*

Added 3D fire model for firemaking skill:

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

View check run for this annotation

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

changelog/2026-01.mdx#L84

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 @@ -57,11 +89,11 @@

---

### Runecrafting Skill Manifest

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

View check run for this annotation

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

changelog/2026-01.mdx#L92

Did you really mean 'Runecrafting'?

*Merged: January 31, 2026*

Complete runecrafting recipe system with OSRS-accurate data:

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

View check run for this annotation

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

changelog/2026-01.mdx#L96

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 @@ -71,18 +103,18 @@

---

### Fletching Skill Manifest

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

View check run for this annotation

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

changelog/2026-01.mdx#L106

Did you really mean 'Fletching'?

*Merged: January 31, 2026*

Complete fletching recipe system with OSRS-accurate data:

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

View check run for this annotation

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

changelog/2026-01.mdx#L110

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 114 in changelog/2026-01.mdx

View check run for this annotation

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

changelog/2026-01.mdx#L114

Did you really mean 'Shortbows'?

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

View check run for this annotation

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

changelog/2026-01.mdx#L114

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 117 in changelog/2026-01.mdx

View check run for this annotation

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

changelog/2026-01.mdx#L117

Did you really mean 'Arrowtips'?

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

View check run for this annotation

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

changelog/2026-01.mdx#L117

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

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 'Dragonhide'?

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 '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 133 in changelog/2026-01.mdx

View check run for this annotation

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

changelog/2026-01.mdx#L133

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 @@ -111,8 +143,8 @@

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

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L146

Did you really mean 'platebodies'?

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

View check run for this annotation

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

changelog/2026-01.mdx#L146

Did you really mean 'platelegs'?

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

View check run for this annotation

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

changelog/2026-01.mdx#L146

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L147

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L163

Did you really mean 'shortbow'?

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

View check run for this annotation

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

changelog/2026-01.mdx#L163

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 165 in changelog/2026-01.mdx

View check run for this annotation

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

changelog/2026-01.mdx#L165

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 @@ -184,9 +216,9 @@

Zone-based collision system:

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L219

Did you really mean 'Bitmask'?

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

View check run for this annotation

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

changelog/2026-01.mdx#L219

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 221 in changelog/2026-01.mdx

View check run for this annotation

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

changelog/2026-01.mdx#L221

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 @@ -215,12 +247,12 @@

---

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L250

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 255 in changelog/2026-01.mdx

View check run for this annotation

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

changelog/2026-01.mdx#L255

Did you really mean 'unequip'?

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

View check run for this annotation

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

changelog/2026-01.mdx#L255

Did you really mean 'tooltip'?

---

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

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L272

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L274

Did you really mean 'Vitest'?

---

## Week 2: January 9-10

### Smithing Skill (PR #492)

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

View check run for this annotation

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

changelog/2026-01.mdx#L280

Did you really mean 'Smithing'?

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

Complete smithing implementation:

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

View check run for this annotation

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

changelog/2026-01.mdx#L284

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 287 in changelog/2026-01.mdx

View check run for this annotation

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

changelog/2026-01.mdx#L287

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 @@ -266,7 +298,7 @@

*Merged: January 10, 2026*

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

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

View check run for this annotation

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

changelog/2026-01.mdx#L301

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

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

*Merged: January 10, 2026*

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

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 'cooldown'?
- Server-authoritative, EatDelayManager, event-driven health updates

---
Expand All @@ -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

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

View check run for this annotation

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

changelog/2026-01.mdx#L329

Did you really mean 'keybind'?
16 changes: 15 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 Down Expand Up @@ -259,10 +259,10 @@
```

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L262

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 264 in wiki/data/overview.mdx

View check run for this annotation

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

wiki/data/overview.mdx#L264

Did you really mean 'green_dhide'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L264

Did you really mean 'blue_dhide'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L264

Did you really mean 'red_dhide'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L264

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L265

Did you really mean 'ahrims'?

### Item Helper Functions

Expand Down Expand Up @@ -309,7 +309,7 @@

### Bank Notes

The system supports bank notes for stackable versions of items:

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

View check run for this annotation

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

wiki/data/overview.mdx#L312

Did you really mean 'stackable'?

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

## Drop Tables

NPCs have tiered drop tables:

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

View check run for this annotation

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

wiki/data/overview.mdx#L335

Did you really mean 'NPCs'?

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

## World Areas

World areas define zones, biomes, and spawn points:

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

View check run for this annotation

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

wiki/data/overview.mdx#L399

Did you really mean 'biomes'?

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L415

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

Expand All @@ -433,7 +433,7 @@

## Stations

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L436

Did you really mean 'smithing'?

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

Stations are defined in `stations.json`:

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L547

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 @@ -596,7 +596,7 @@

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L599

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 @@ -632,7 +632,7 @@
| Dragon | 2 |
| Rune | 3 |
| Adamant | 4 |
| Mithril | 5 |

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

View check run for this annotation

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

wiki/data/overview.mdx#L635

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L647

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

---

## Vegetation & Biomes

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 'Biomes'?

### Vegetation Assets

Expand Down Expand Up @@ -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:

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

View check run for this annotation

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

wiki/data/overview.mdx#L688

Did you really mean 'Biomes'?

- **Tundra** - Frozen terrain with wind pines (maxSlope: 1.8)

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

View check run for this annotation

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

wiki/data/overview.mdx#L690

Did you really mean 'maxSlope'?
- **Forest** - Dense woodland areas (maxSlope: 1.5)

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

View check run for this annotation

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

wiki/data/overview.mdx#L691

Did you really mean 'maxSlope'?
- **Canyon** - Rocky terrain with steep slopes (maxSlope: 2.5)

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

View check run for this annotation

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

wiki/data/overview.mdx#L692

Did you really mean 'maxSlope'?

The `maxSlope` threshold determines walkability and vegetation placement, adjusted to match actual terrain generation slopes from terracing and landscape features.

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

View check run for this annotation

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

wiki/data/overview.mdx#L694

Did you really mean 'walkability'?

### Biome Vegetation Layers

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L698

Did you really mean 'Biomes'?

```typescript
interface VegetationLayer {
Expand All @@ -704,10 +714,14 @@
```

**Recent Updates**:
- Mushroom vegetation added to all biomes with varying densities (2-30)

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

View check run for this annotation

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

wiki/data/overview.mdx#L717

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 720 in wiki/data/overview.mdx

View check run for this annotation

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

wiki/data/overview.mdx#L720

Did you really mean 'Firemaking'?
- Wind pine tree type added for tundra biome (split from dead tree variants)
- Maple tree leaves recolored to warm vermillion red-orange (#D04838)

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

View check run for this annotation

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

wiki/data/overview.mdx#L722

Did you really mean 'vermillion'?
- Knotwood tree leaves recolored from golden-yellow to warm amber (#C4832A)

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

View check run for this annotation

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

wiki/data/overview.mdx#L723

Did you really mean 'Knotwood'?
- Tree model scales adjusted for better visual proportions

---

Expand All @@ -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

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

View check run for this annotation

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

wiki/data/overview.mdx#L732

Did you really mean 'Fletching'?

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

Expand All @@ -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

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

View check run for this annotation

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

wiki/data/overview.mdx#L756

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 759 in wiki/data/overview.mdx

View check run for this annotation

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

wiki/data/overview.mdx#L759

Did you really mean 'Arrowtips'?

### Crafting Recipes

Expand Down Expand Up @@ -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

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 'dragonhide'?
- `jewelry` - Gold bar + gems + mould → jewelry (at furnace)
- `gem_cutting` - Chisel + uncut gem → cut gem

### Runecrafting Recipes

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

View check run for this annotation

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

wiki/data/overview.mdx#L792

Did you really mean 'Runecrafting'?

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

Expand Down Expand Up @@ -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 |

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

View check run for this annotation

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

wiki/data/overview.mdx#L866

Did you really mean 'Torvin's'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L866

Did you really mean 'Torvin'?

### Quest Stage Types

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L871

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L873

Did you really mean 'smithing'?

---

Expand All @@ -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`

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

View check run for this annotation

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

wiki/data/overview.mdx#L884

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L910

Did you really mean 'Fletching'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L910

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L911

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L912

Did you really mean 'Runecrafting'?

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

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

View check run for this annotation

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

wiki/data/overview.mdx#L915

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

### Manifest Refactor (PR #3)
Expand All @@ -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

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

View check run for this annotation

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

wiki/data/overview.mdx#L924

Did you really mean 'smithing'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L924

Did you really mean 'firemaking'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L924

Did you really mean 'fletching'?

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

View check run for this annotation

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

wiki/data/overview.mdx#L924

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 930 in wiki/data/overview.mdx

View check run for this annotation

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

wiki/data/overview.mdx#L930

Did you really mean 'biomes'?

---

Expand Down
Loading