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
37 changes: 28 additions & 9 deletions wiki/data/npcs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -162,15 +162,34 @@ export function calculateNPCDrops(npcId: string): Array<{ itemId: string; quanti

## Available 3D Models

NPCs use rigged GLB models from `/assets/world/forge/`:

| Model Path | Used For |
|------------|----------|
| `goblin/goblin_rigged.glb` | Goblins |
| `thug/thug_rigged.glb` | Bandits, thugs |
| `human/human_rigged.glb` | Guards, knights, shopkeepers |
| `troll/troll_rigged.glb` | Hobgoblins |
| `imp/imp_rigged.glb` | Dark warriors |
### Mobs

Hostile NPCs use models from `models/mobs/`:

| Model Path | Format | Used For |
|------------|--------|----------|
| `models/mobs/goblin/goblin.vrm` | VRM | Goblins |
| `models/mobs/goblin/goblin_rigged.glb` | GLB | Goblins (legacy) |
| `models/mobs/dark-ranger/dark-ranger.vrm` | VRM | Dark rangers |
| `models/mobs/dark-wizard/dark-wizard.vrm` | VRM | Dark wizards |

**Goblin Animations**:
- `models/mobs/goblin/animations/running.glb` - Running animation
- `models/mobs/goblin/animations/walking.glb` - Walking animation

### NPCs

Service NPCs use models from `models/npcs/`:

| Model Path | NPC |
|------------|-----|
| `models/npcs/banker/banker.vrm` | Banker |
| `models/npcs/captain-rowan/captain-rowan.vrm` | Captain Rowan |
| `models/npcs/fisherman-pete/fisherman-pete.vrm` | Fisherman Pete |
| `models/npcs/forester-wilma/forester-wilma.vrm` | Forester Wilma |
| `models/npcs/shopkeeper/shopkeeper.vrm` | Shopkeeper |
| `models/npcs/tanner-ellis/tanner-ellis.vrm` | Tanner Ellis |
| `models/npcs/torvin/torvin.vrm` | Torvin |

---

Expand Down
38 changes: 31 additions & 7 deletions wiki/data/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -106,14 +106,29 @@ Each NPC has these properties (from `types/entities/npc-mob-types.ts`):

### Available 3D Models

**NPCs**:
**Mobs** (`models/mobs/`):
```
/assets/models/
├── goblin/goblin_rigged.glb → Goblins
├── thug/thug_rigged.glb → Bandits
├── human/human_rigged.glb → Guards, knights, warriors, rangers
├── troll/troll_rigged.glb → Hobgoblins
└── imp/imp_rigged.glb → Dark warriors
├── goblin/
│ ├── goblin.vrm → Goblin (VRM format)
│ ├── goblin_rigged.glb → Goblin (GLB format)
│ └── animations/
│ ├── running.glb → Running animation
│ └── walking.glb → Walking animation
├── dark-ranger/
│ └── dark-ranger.vrm → Dark ranger
└── dark-wizard/
└── dark-wizard.vrm → Dark wizard
```

**NPCs** (`models/npcs/`):
```
├── banker/banker.vrm → Banker
├── captain-rowan/captain-rowan.vrm → Captain Rowan
├── fisherman-pete/fisherman-pete.vrm → Fisherman Pete
├── forester-wilma/forester-wilma.vrm → Forester Wilma
├── shopkeeper/shopkeeper.vrm → Shopkeeper
├── tanner-ellis/tanner-ellis.vrm → Tanner Ellis
└── torvin/torvin.vrm → Torvin
```

**Stations**:
Expand Down Expand Up @@ -182,6 +197,15 @@ Each NPC has these properties (from `types/entities/npc-mob-types.ts`):
└── mushroom.glb → Giant mushroom (new)
```

**Miscellaneous Items** (`models/misc/`):
```
├── bones/bones.glb → Bones (mob drop)
├── coin-pile/coin-pile.glb → Coin pile
├── ashes/ashes.glb → Ashes
├── firemaking-fire/firemaking-fire.glb → Fire model for firemaking
└── headstone/headstone.glb → Headstone
```

### NPC Helper Functions

```typescript
Expand Down
Loading