Update docs for Week 7 asset additions

changelog/2026-01.mdx

@@ -3,6 +3,70 @@ title: "January 2026"
 description: "Duel Arena, Prayer, Collision, Smithing, Website, and UI Improvements"
 ---
 
+## Week 7: February 13-20
+
+### New Sword Variants and Models
+
+*Merged: February 20, 2026*
+
+Comprehensive sword model expansion with all weapon tiers:
+
+- **Daggers**: Bronze, iron, steel, mithril, adamant, rune (aligned models)
+- **Shortswords**: Bronze, iron, steel, mithril, adamant, rune (aligned models)
+- **Longswords**: Bronze, iron, steel, mithril, adamant, rune (aligned models)
+- **Scimitars**: Bronze, iron, steel, mithril, adamant, rune (aligned models)
+- **2H Swords**: Bronze, iron, steel, mithril, adamant, rune (aligned models)
+- **Models**: All weapons include aligned versions for proper character hand positioning
+- **Integration**: Complete weapon progression from bronze to rune tier across all sword types
+
+---
+
+### Asset Organization and New NPC Models
+
+*Merged: February 13, 2026*
+
+Major asset reorganization and new NPC additions:
+
+- **Asset Structure**: Reorganized models into logical directories (mobs/, npcs/, swords/, etc.)
+- **New NPCs**: Added VRM models for all service NPCs and quest givers
+  - Zamorin (wizard), Lowe (bowyer), Horvik (armorer), Dommik (crafter)
+  - Captain Rowan, Forester Wilma, Fisherman Pete, Torvin, Tanner Ellis
+- **New Mobs**: Dark Wizard (magic), Dark Ranger (ranged), Barbarian, Guard
+- **Optimization**: Optimized existing assets for better performance
+- **Models**: All NPCs now use VRM format for better avatar support
+
+---
+
+### New Mobs and Starter Quests
+
+*Merged: February 19, 2026*
+
+Added new hostile mobs and expanded quest system:
+
+- **New Mobs**: Cow (passive, drops cowhide), Guard (level 21), Bandit (level 7), Barbarian (level 14)
+- **Combat Variety**: Dark Wizard uses Wind Strike magic, Dark Ranger uses bronze arrows
+- **Starter Quests**: 7 novice quests added (Goblin Slayer, Lumberjack's First Lesson, Fresh Catch, Torvin's Tools, Rune Mysteries, Crafting Basics, Fletcher's Introduction)
+- **Quest Rewards**: All quests award 1 quest point and XP lamp (100 XP)
+- **NPC Integration**: Quest NPCs provide dialogue, items, and guidance
+
+---
+
+### New Stores and NPCs
+
+*Merged: February 16, 2026*
+
+Expanded shop system with specialized vendors:
+
+- **Torvin's Weaponry**: All melee weapons (daggers, shortswords, longswords, scimitars, 2H swords) across all tiers
+- **Zamorin's Magic Emporium**: Runes, elemental staves, wizard/mystic robes, essence
+- **Archer's Armoury**: Bows, arrows, ranged armor, fletching supplies
+- **Armor Emporium**: Helms, platebodies, platelegs, shields, boots, gloves, jewelry
+- **Crafting Supplies**: Leather, gems, moulds, needles, thread, chisels
+- **Pete's Fishing Supplies**: Fishing tools, bait, raw and cooked fish
+- **Store Integration**: All stores support buyback at 50% rate with unlimited stock
+
+---
+
 ## Week 6: February 2-6
 
 ### Ammunition Manifest Update

wiki/data/npcs.mdx

@@ -162,15 +162,39 @@ 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 |
+NPCs use VRM models from `/assets/models/`:
+
+### Hostile Mobs
+
+| Model Path | Used For | Combat Type |
+|------------|----------|-------------|
+| `mobs/goblin/goblin.vrm` | Goblins (Level 2) | Melee |
+| `mobs/bandit/bandit.vrm` | Bandits (Level 7) | Melee (scimitar) |
+| `mobs/barbarian/barbarian.vrm` | Barbarians (Level 14) | Melee (scimitar) |
+| `mobs/gaurd/gaurd.vrm` | Town Guards (Level 21) | Melee (longsword) |
+| `mobs/dark-wizard/dark-wizard.vrm` | Dark Wizards (Level 42) | Magic (Wind Strike) |
+| `mobs/dark-ranger/dark-ranger.vrm` | Dark Rangers (Level 33) | Ranged (bow + bronze arrows) |
+
+### Service NPCs
+
+| Model Path | Used For | Services |
+|------------|----------|----------|
+| `npcs/banker/banker.vrm` | Bank Clerk | Bank access |
+| `npcs/shopkeeper/shopkeeper.vrm` | General Shopkeeper | General store |
+| `npcs/torvin/torvin.vrm` | Torvin (Smith) | Weapon shop, Torvin's Tools quest |
+| `npcs/Horvik/Horvik.vrm` | Horvik (Armorer) | Armor shop |
+| `npcs/Zamorin/Zamorin.vrm` | Zamorin (Wizard) | Magic shop, Rune Mysteries quest |
+| `npcs/Lowe/Lowe.vrm` | Lowe (Bowyer) | Ranged shop, Fletcher's Introduction quest |
+| `npcs/Dommik/Dommik.vrm` | Dommik (Crafter) | Crafting shop, Crafting Basics quest |
+| `npcs/fisherman-pete/fisherman-pete.vrm` | Fisherman Pete | Fishing shop, Fresh Catch quest |
+| `npcs/tanner-ellis/tanner-ellis.vrm` | Ellis (Tanner) | Tanning service |
+
+### Quest NPCs
+
+| Model Path | Used For | Quest |
+|------------|----------|-------|
+| `npcs/captain-rowan/captain-rowan.vrm` | Captain Rowan | Goblin Slayer |
+| `npcs/forester-wilma/forester-wilma.vrm` | Forester Wilma | Lumberjack's First Lesson |
 
 ---
 

wiki/data/overview.mdx

@@ -106,14 +106,28 @@ Each NPC has these properties (from `types/entities/npc-mob-types.ts`):
 
 ### Available 3D Models
 
-**NPCs**:
+**NPCs & 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
+├── mobs/
+│   ├── goblin/goblin.vrm                → Goblins
+│   ├── bandit/bandit.vrm                → Bandits
+│   ├── barbarian/barbarian.vrm          → Barbarians
+│   ├── gaurd/gaurd.vrm                  → Town guards
+│   ├── dark-wizard/dark-wizard.vrm      → Dark wizards (magic attackers)
+│   └── dark-ranger/dark-ranger.vrm      → Dark rangers (ranged attackers)
+└── npcs/
+    ├── captain-rowan/captain-rowan.vrm  → Quest giver (Goblin Slayer)
+    ├── forester-wilma/forester-wilma.vrm → Quest giver (Lumberjack's First Lesson)
+    ├── fisherman-pete/fisherman-pete.vrm → Quest giver & shop (Fresh Catch)
+    ├── torvin/torvin.vrm                → Quest giver & shop (Torvin's Tools)
+    ├── tanner-ellis/tanner-ellis.vrm    → Tanner service
+    ├── Zamorin/Zamorin.vrm              → Magic shop & quest (Rune Mysteries)
+    ├── Lowe/Lowe.vrm                    → Ranged shop & quest (Fletcher's Introduction)
+    ├── Horvik/Horvik.vrm                → Armor shop
+    ├── Dommik/Dommik.vrm                → Crafting shop & quest (Crafting Basics)
+    ├── shopkeeper/shopkeeper.vrm        → General store
+    └── banker/banker.vrm                → Bank services
 ```
 
 **Stations**:
@@ -137,16 +151,59 @@ Each NPC has these properties (from `types/entities/npc-mob-types.ts`):
 └── bait-fishing-rod/bait-fishing-rod-aligned.glb       → Bait fishing rod (aligned)
 ```
 
-**Equipment (Aligned Models)**:
+**Melee Weapons (Aligned Models)**:
+```
+/assets/models/swords/
+├── daggers/
+│   ├── dagger-bronze-aligned.glb        → Bronze dagger
+│   ├── dagger-iron-aligned.glb          → Iron dagger
+│   ├── dagger-adamant-aligned.glb       → Adamant dagger
+│   ├── dagger-mithril-aligned.glb       → Mithril dagger
+│   └── dagger-rune-aligned.glb          → Rune dagger
+├── shortswords/
+│   ├── shortsword-bronze-aligned.glb    → Bronze shortsword
+│   ├── shortsword-iron-aligned.glb      → Iron shortsword
+│   ├── shortsword-steel-aligned.glb     → Steel shortsword
+│   ├── shortsword-mithril-aligned.glb   → Mithril shortsword
+│   ├── shortsword-adamant-aligned.glb   → Adamant shortsword
+│   └── shortsword-rune-aligned.glb      → Rune shortsword
+├── long-swords/
+│   ├── longsword-bronze-aligned.glb     → Bronze longsword
+│   ├── longsword-iron-aligned.glb       → Iron longsword
+│   ├── longsword-steel-aligned.glb      → Steel longsword
+│   ├── longsword-mithril-aligned.glb    → Mithril longsword
+│   ├── longsword-adamant-aligned.glb    → Adamant longsword
+│   └── longsword-rune-aligned.glb       → Rune longsword
+├── scimitars/
+│   ├── scimitar-bronze-aligned.glb      → Bronze scimitar
+│   ├── scimitar-iron-aligned.glb        → Iron scimitar
+│   ├── scimitar-steel-aligned.glb       → Steel scimitar
+│   ├── scimitar-mithril-aligned.glb     → Mithril scimitar
+│   ├── scimitar-adamant-aligned.glb     → Adamant scimitar
+│   └── scimitar-rune-aligned.glb        → Rune scimitar
+└── 2h-swords/
+    ├── 2h-sword-bronze-aligned.glb      → Bronze 2H sword
+    ├── 2h-sword-iron-aligned.glb        → Iron 2H sword
+    ├── 2h-sword-steel-aligned.glb       → Steel 2H sword
+    ├── 2h-sword-mithril-aligned.glb     → Mithril 2H sword
+    ├── 2h-sword-adamant-aligned.glb     → Adamant 2H sword
+    └── 2h-sword-rune-aligned.glb        → Rune 2H sword
+```
+
+**Tools (Aligned Models)**:
 ```
 /assets/models/
-├── hatchet-bronze/hatchet-bronze-aligned.glb           → Bronze hatchet (aligned)
-├── pickaxe-bronze/pickaxe-bronze-aligned.glb           → Bronze pickaxe (aligned)
-├── pickaxe-steel/pickaxe-steel-aligned.glb             → Steel pickaxe (aligned)
-├── pickaxe-mithril/pickaxe-mithril-aligned.glb         → Mithril pickaxe (aligned)
-├── sword-bronze/sword-bronze-aligned.glb               → Bronze sword (aligned)
-├── sword-steel/sword-steel-aligned.glb                 → Steel sword (aligned)
-└── sword-mithril/sword-mithril-aligned.glb             → Mithril sword (aligned)
+├── hatchets/
+│   ├── hatchet-bronze/hatchet-bronze-aligned.glb  → Bronze hatchet
+│   └── hatchet-base/hatchet-base.glb              → Base hatchet
+├── pickaxes/
+│   ├── pickaxe-bronze/pickaxe-bronze-aligned.glb  → Bronze pickaxe
+│   ├── pickaxe-steel/pickaxe-steel-aligned.glb    → Steel pickaxe
+│   └── pickaxe-mithril/pickaxe-mithril-aligned.glb → Mithril pickaxe
+└── shields/
+    ├── shield-bronze/shield-bronze.glb            → Bronze shield
+    ├── shield-steel/shield-steel.glb              → Steel shield
+    └── shield-mithril/shield-mithril.glb          → Mithril shield
 ```
 
 **Magic Staffs**: