diff --git a/devops/configuration.mdx b/devops/configuration.mdx index edb9ee98..3743e4ff 100644 --- a/devops/configuration.mdx +++ b/devops/configuration.mdx @@ -380,16 +380,27 @@ Hyperscape fetches game manifests from the CDN at server startup instead of bund The following manifests are fetched from `PUBLIC_CDN_URL/manifests/`: - `items.json` - Item definitions -- `ammunition.json` - Ammunition definitions for ranged combat -- `npcs.json` - NPC and mob data +- `ammunition.json` - Ammunition definitions for ranged combat (updated Feb 2026) +- `npcs.json` - NPC and mob data (includes new stores and mobs) - `resources.json` - Gathering resources - `tools.json` - Tool definitions - `biomes.json` - Biome configurations - `world-areas.json` - World area definitions -- `stores.json` - Shop inventories +- `stores.json` - Shop inventories (includes Lowe, Dommik, Horvik, Zamorin) - `music.json` - Music track metadata - `vegetation.json` - Vegetation spawning - `buildings.json` - Building placements +- `quests.json` - Quest definitions with starter quests +- `stations.json` - Crafting stations including runecrafting altars + +### Recent Manifest Updates (February 2026) + +- **NPCs**: Added new store NPCs (Lowe, Dommik, Horvik, Zamorin) and mobs (Bandits, Barbarians, Dark Rangers, Dark Wizards) +- **Items**: Added magic staffs (Air, Water, Earth, Fire), bones, coin piles, and ammunition +- **Recipes**: Added runecrafting and fletching recipe manifests +- **Stations**: Added runecrafting altars and firemaking fire models +- **Quests**: Added starter quest system +- **Assets**: Optimized all 3D models and organized asset structure ### Fetch Behavior diff --git a/guides/adding-content.mdx b/guides/adding-content.mdx index 870ea6a3..4922af66 100644 --- a/guides/adding-content.mdx +++ b/guides/adding-content.mdx @@ -48,12 +48,21 @@ NPCs are defined with combat stats, drops, and spawn locations: aggroRange: 3, drops: [ { itemId: "coins", quantity: [1, 10], chance: 1.0 }, + { itemId: "bones", quantity: 1, chance: 1.0 }, { itemId: "bronze_sword", quantity: 1, chance: 0.05 } ], respawnTime: 15000 } ``` +### Recent NPC Additions + +The assets repository includes new NPCs and mobs: + +- **Stores**: New shop NPCs including Lowe (archery), Dommik (crafting), Horvik (smithing), Zamorin (magic) +- **Mobs**: Bandits, Barbarians, Dark Rangers, Dark Wizards, Guards +- **Models**: Optimized VRM models for all NPCs with proper rigging + ### Difficulty Levels | Level | Examples | @@ -89,6 +98,15 @@ Items include equipment, resources, and consumables. Add to the appropriate cate } ``` +### Recent Weapon Additions + +New weapon types and models have been added: + +- **Magic Staffs**: Air, Water, Earth, and Fire staffs with elemental bonuses +- **Bows**: Oak and Willow bows for ranged combat +- **Arrows**: Bronze arrows with proper ammunition system +- **Models**: All weapons include aligned GLB models for proper hand positioning + ### Example: Adding a Tool **File**: `packages/server/world/assets/manifests/items/tools.json` @@ -127,6 +145,15 @@ Items include equipment, resources, and consumables. Add to the appropriate cate } ``` +### Recent Resource Additions + +New resources and items have been added: + +- **Currency**: Coin pile models for dropped coins +- **Combat Drops**: Bones (universal mob drop for Prayer skill) +- **Ashes**: Firemaking byproduct +- **Ammunition**: Bronze arrows with proper manifest definitions + ### Tier-Based Requirements Items with a `tier` property automatically derive level requirements from `tier-requirements.json`: @@ -169,6 +196,15 @@ Shops define available items and prices: } ``` +### Recent Store Additions + +New specialized shops have been added: + +- **Lowe's Archery Emporium**: Bows, arrows, and ranged equipment +- **Dommik's Crafting Store**: Crafting supplies and tools +- **Horvik's Armour Shop**: Smithing equipment and armor +- **Zamorin's Magic Shop**: Magic staffs, runes, and spell components + ## Adding Stations Stations are interactive objects for crafting and processing: @@ -190,6 +226,15 @@ Stations are interactive objects for crafting and processing: - **furnace**: Smelt ores into bars - **range**: Cook food with reduced burn chance - **bank**: Store items +- **runecrafting_altar**: Craft runes from essence + +### Recent Station Updates + +New stations and models have been added: + +- **Runecrafting Altars**: Air, Water, Earth, Fire altars for rune crafting +- **Optimized Models**: All station models have been optimized for better performance +- **Firemaking Fire**: Visual model for active fires created through Firemaking skill ## Adding World Areas @@ -288,6 +333,40 @@ World areas define zones with biomes and mob spawns: } ``` +### Runecrafting Recipe + +**File**: `packages/server/world/assets/manifests/recipes/runecrafting.json` + +```json +{ + "output": "air_rune", + "inputs": [ + { "item": "rune_essence", "amount": 1 } + ], + "level": 1, + "xp": 5, + "ticks": 3, + "altar": "air_altar" +} +``` + +### Fletching Recipe + +**File**: `packages/server/world/assets/manifests/recipes/fletching.json` + +```json +{ + "output": "oak_shortbow", + "inputs": [ + { "item": "oak_logs", "amount": 1 } + ], + "level": 20, + "xp": 16.5, + "ticks": 3, + "category": "bows" +} +``` + --- ## Testing Changes diff --git a/guides/development.mdx b/guides/development.mdx index f95169ed..1c3e0130 100644 --- a/guides/development.mdx +++ b/guides/development.mdx @@ -217,6 +217,17 @@ export function MyComponent() { 2. Restart server to reload manifests 3. Documentation updates automatically via GitHub Actions +### Recent Content Updates (February 2026) + +The assets repository has received significant updates: + +- **New NPCs**: Store owners (Lowe, Dommik, Horvik, Zamorin) and combat mobs (Bandits, Barbarians, Dark Rangers, Dark Wizards, Guards) +- **New Items**: Magic staffs (Air, Water, Earth, Fire), bones, coin piles, ammunition system +- **New Skills**: Runecrafting and Fletching with full recipe manifests +- **New Stations**: Runecrafting altars and firemaking fire models +- **Quest System**: Starter quests added to quest manifest +- **Asset Optimization**: All 3D models optimized and reorganized for better performance + ### Debugging Server 1. Check terminal output for errors