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
17 changes: 14 additions & 3 deletions devops/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
79 changes: 79 additions & 0 deletions guides/adding-content.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down Expand Up @@ -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`
Expand Down Expand Up @@ -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`:
Expand Down Expand Up @@ -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:
Expand All @@ -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

Expand Down Expand Up @@ -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
Expand Down
11 changes: 11 additions & 0 deletions guides/development.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading