From 0675794582724a7e09fa4bdd230b3b55ea9f90d9 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 13 Feb 2026 07:29:33 +0000
Subject: [PATCH 1/3] Update wiki/data/overview.mdx

---
 wiki/data/overview.mdx | 31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/wiki/data/overview.mdx b/wiki/data/overview.mdx
index 6d8ae1db..5b9f8d92 100644
--- a/wiki/data/overview.mdx
+++ b/wiki/data/overview.mdx
@@ -106,14 +106,29 @@ Each NPC has these properties (from `types/entities/npc-mob-types.ts`):
 
 ### Available 3D Models
 
-**NPCs**:
-```
-/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
+**Mobs** (`models/mobs/`):
+```
+├── 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**:

From 9293be19c6f295d27093971814c62d6c66955b27 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 13 Feb 2026 07:29:40 +0000
Subject: [PATCH 2/3] Update wiki/data/overview.mdx

---
 wiki/data/overview.mdx | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/wiki/data/overview.mdx b/wiki/data/overview.mdx
index 5b9f8d92..9d798f81 100644
--- a/wiki/data/overview.mdx
+++ b/wiki/data/overview.mdx
@@ -197,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

From 058da0be193a9cfcd7c0a3b819f7e33791315676 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 13 Feb 2026 07:29:57 +0000
Subject: [PATCH 3/3] Update wiki/data/npcs.mdx

---
 wiki/data/npcs.mdx | 37 ++++++++++++++++++++++++++++---------
 1 file changed, 28 insertions(+), 9 deletions(-)

diff --git a/wiki/data/npcs.mdx b/wiki/data/npcs.mdx
index 572f4182..5d2b1281 100644
--- a/wiki/data/npcs.mdx
+++ b/wiki/data/npcs.mdx
@@ -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 |
 
 ---