MUME · adhocmedia · Sep 21, 2026 · Sep 22, 2026
diff --git a/docs/.vitepress/theme/components/MumeCommandGuide.vue b/docs/.vitepress/theme/components/MumeCommandGuide.vue
@@ -8,44 +8,44 @@ const categories = ['All', 'Basics', 'Gear & Inventory', 'Vitals & Stats', 'Comb
 
 const commands = [
   // Basics
-  { category: 'Basics', command: 'look / l', syntax: 'look [object/room]', desc: 'Examine your surroundings, a room, player, or item.', chapter: '2-look-exits', chNum: 2 },
-  { category: 'Basics', command: 'examine', syntax: 'examine <item/container>', desc: 'Inspect containers or items in detail.', chapter: '3-examining-containers', chNum: 3 },
-  { category: 'Basics', command: 'exits', syntax: 'exits', desc: 'Display all obvious room exit directions.', chapter: '2-look-exits', chNum: 2 },
-  { category: 'Basics', command: 'n / s / e / w', syntax: 'north / south / east / west', desc: 'Navigate across Middle-earth rooms and paths.', chapter: '7-movement-doors', chNum: 7 },
-  { category: 'Basics', command: 'where', syntax: 'where', desc: 'Locate players currently in your zone.', chapter: '5-vitals-stats', chNum: 5 },
-  { category: 'Basics', command: 'time', syntax: 'time', desc: 'Check current Middle-earth time and calendar date.', chapter: '5-vitals-stats', chNum: 5 },
+  { category: 'Basics', command: 'look / l', syntax: 'look [object/room]', desc: 'Examine your surroundings, a room, player, or item.', chapter: '3-look-exits', chNum: 3 },
+  { category: 'Basics', command: 'examine', syntax: 'examine <item/container>', desc: 'Inspect containers or items in detail.', chapter: '5-examining-containers', chNum: 5 },
+  { category: 'Basics', command: 'exits', syntax: 'exits', desc: 'Display all obvious room exit directions.', chapter: '3-look-exits', chNum: 3 },
+  { category: 'Basics', command: 'n / s / e / w', syntax: 'north / south / east / west', desc: 'Navigate across Middle-earth rooms and paths.', chapter: '4-movement-doors', chNum: 4 },
+  { category: 'Basics', command: 'where', syntax: 'where', desc: 'Locate players currently in your zone.', chapter: '7-vitals-stats', chNum: 7 },
+  { category: 'Basics', command: 'time', syntax: 'time', desc: 'Check current Middle-earth time and calendar date.', chapter: '7-vitals-stats', chNum: 7 },
 
   // Gear & Inventory
-  { category: 'Gear & Inventory', command: 'inventory / inv', syntax: 'inventory', desc: 'List items carried in your hands and pack.', chapter: '6-equipment-wielding', chNum: 6 },
-  { category: 'Gear & Inventory', command: 'equipment / eq', syntax: 'equipment', desc: 'Display all currently worn gear, armor, and weapons.', chapter: '6-equipment-wielding', chNum: 6 },
-  { category: 'Gear & Inventory', command: 'wield', syntax: 'wield <weapon>', desc: 'Equip your main weapon into your primary hand.', chapter: '6-equipment-wielding', chNum: 6 },
-  { category: 'Gear & Inventory', command: 'wear', syntax: 'wear <item> [location]', desc: 'Wear armor or attach lanterns/knives to your belt.', chapter: '6-equipment-wielding', chNum: 6 },
-  { category: 'Gear & Inventory', command: 'put / get', syntax: 'put item sack / get item sack', desc: 'Stow or retrieve supplies from containers.', chapter: '3-examining-containers', chNum: 3 },
+  { category: 'Gear & Inventory', command: 'inventory / inv', syntax: 'inventory', desc: 'List items carried in your hands and pack.', chapter: '8-equipment-wielding', chNum: 8 },
+  { category: 'Gear & Inventory', command: 'equipment / eq', syntax: 'equipment', desc: 'Display all currently worn gear, armor, and weapons.', chapter: '8-equipment-wielding', chNum: 8 },
+  { category: 'Gear & Inventory', command: 'wield', syntax: 'wield <weapon>', desc: 'Equip your main weapon into your primary hand.', chapter: '8-equipment-wielding', chNum: 8 },
+  { category: 'Gear & Inventory', command: 'wear', syntax: 'wear <item> [location]', desc: 'Wear armor or attach lanterns/knives to your belt.', chapter: '8-equipment-wielding', chNum: 8 },
+  { category: 'Gear & Inventory', command: 'put / get', syntax: 'put item sack / get item sack', desc: 'Stow or retrieve supplies from containers.', chapter: '5-examining-containers', chNum: 5 },
 
   // Vitals & Stats
-  { category: 'Vitals & Stats', command: 'score / sc', syntax: 'score', desc: 'Quick check of Hit Points, Mana, and Movement Points.', chapter: '5-vitals-stats', chNum: 5 },
-  { category: 'Vitals & Stats', command: 'stat', syntax: 'stat', desc: 'Display OB, DB, PB combat bonuses and experience needed.', chapter: '5-vitals-stats', chNum: 5 },
-  { category: 'Vitals & Stats', command: 'info', syntax: 'info', desc: 'Full character sheet including age, attributes, alignment.', chapter: '5-vitals-stats', chNum: 5 },
-  { category: 'Vitals & Stats', command: 'eat / drink', syntax: 'eat <food> / drink <container>', desc: 'Satisfy hunger and thirst to maintain rapid recovery.', chapter: '12-recovery-rest', chNum: 12 },
-  { category: 'Vitals & Stats', command: 'change wimpy', syntax: 'change wimpy 15', desc: 'Set automatic flee threshold when HP drops.', chapter: '4-safety-wimpy', chNum: 4 },
+  { category: 'Vitals & Stats', command: 'score / sc', syntax: 'score', desc: 'Quick check of Hit Points, Mana, and Movement Points.', chapter: '7-vitals-stats', chNum: 7 },
+  { category: 'Vitals & Stats', command: 'stat', syntax: 'stat', desc: 'Display OB, DB, PB combat bonuses and experience needed.', chapter: '7-vitals-stats', chNum: 7 },
+  { category: 'Vitals & Stats', command: 'info', syntax: 'info', desc: 'Full character sheet including age, attributes, alignment.', chapter: '7-vitals-stats', chNum: 7 },
+  { category: 'Vitals & Stats', command: 'eat / drink', syntax: 'eat <food> / drink <container>', desc: 'Satisfy hunger and thirst to maintain rapid recovery.', chapter: '13-recovery-rest', chNum: 13 },
+  { category: 'Vitals & Stats', command: 'change wimpy', syntax: 'change wimpy 15', desc: 'Set automatic flee threshold when HP drops.', chapter: '6-safety-wimpy', chNum: 6 },
 
   // Combat & Tactics
-  { category: 'Combat & Tactics', command: 'consider', syntax: 'consider <target>', desc: 'Assess target difficulty before attacking.', chapter: '10-combat-stances', chNum: 10 },
-  { category: 'Combat & Tactics', command: 'hit / kill', syntax: 'hit <target>', desc: 'Engage an enemy target in combat.', chapter: '10-combat-stances', chNum: 10 },
-  { category: 'Combat & Tactics', command: 'change mood', syntax: 'cha m <aggressive/wimpy>', desc: 'Adjust combat stance to boost OB or DB.', chapter: '10-combat-stances', chNum: 10 },
-  { category: 'Combat & Tactics', command: 'flee', syntax: 'flee', desc: 'Attempt emergency escape from dangerous combat.', chapter: '11-emergency-fleeing', chNum: 11 },
+  { category: 'Combat & Tactics', command: 'consider', syntax: 'consider <target>', desc: 'Assess target difficulty before attacking.', chapter: '11-combat-stances', chNum: 11 },
+  { category: 'Combat & Tactics', command: 'hit / kill', syntax: 'hit <target>', desc: 'Engage an enemy target in combat.', chapter: '11-combat-stances', chNum: 11 },
+  { category: 'Combat & Tactics', command: 'change mood', syntax: 'cha m <aggressive/wimpy>', desc: 'Adjust combat stance to boost OB or DB.', chapter: '11-combat-stances', chNum: 11 },
+  { category: 'Combat & Tactics', command: 'flee', syntax: 'flee', desc: 'Attempt emergency escape from dangerous combat.', chapter: '12-emergency-fleeing', chNum: 12 },
 
   // Guild & Rest
-  { category: 'Guild & Rest', command: 'practice / prac', syntax: 'prac <skill>', desc: 'Train weapon proficiencies and skills at a guildmaster.', chapter: '13-guilds-training', chNum: 13 },
-  { category: 'Guild & Rest', command: 'rest / sleep', syntax: 'rest / sleep', desc: 'Sit or sleep to accelerate hit point and move recovery.', chapter: '12-recovery-rest', chNum: 12 },
-  { category: 'Guild & Rest', command: 'wake / stand', syntax: 'wake / stand', desc: 'Awaken and stand up to prepare for movement or combat.', chapter: '12-recovery-rest', chNum: 12 },
+  { category: 'Guild & Rest', command: 'practice / prac', syntax: 'prac <skill>', desc: 'Train weapon proficiencies and skills at a guildmaster.', chapter: '14-guilds-training', chNum: 14 },
+  { category: 'Guild & Rest', command: 'rest / sleep', syntax: 'rest / sleep', desc: 'Sit or sleep to accelerate hit point and move recovery.', chapter: '13-recovery-rest', chNum: 13 },
+  { category: 'Guild & Rest', command: 'wake / stand', syntax: 'wake / stand', desc: 'Awaken and stand up to prepare for movement or combat.', chapter: '13-recovery-rest', chNum: 13 },
 
   // Social & Rent
-  { category: 'Social & Rent', command: 'say / tell', syntax: 'say <text> / tell <name> <text>', desc: 'Speak aloud locally or send private direct messages.', chapter: '8-npc-communication', chNum: 8 },
-  { category: 'Social & Rent', command: 'follow / fol', syntax: 'follow <player>', desc: 'Follow an experienced player or ranger and join their party.', chapter: '8-npc-communication', chNum: 8 },
-  { category: 'Social & Rent', command: 'give', syntax: 'give <item> <person>', desc: 'Give an item to an NPC or player.', chapter: '9-shopping-trading', chNum: 9 },
-  { category: 'Social & Rent', command: 'list / buy', syntax: 'list / buy <item>', desc: 'Browse merchant wares and buy provisions.', chapter: '9-shopping-trading', chNum: 9 },
-  { category: 'Social & Rent', command: 'offer / rent', syntax: 'offer / rent', desc: 'Check inn room rates and safely save character equipment.', chapter: '14-safe-haven-rent', chNum: 14 }
+  { category: 'Social & Rent', command: 'say / tell', syntax: 'say <text> / tell <name> <text>', desc: 'Speak aloud locally or send private direct messages.', chapter: '9-npc-communication', chNum: 9 },
+  { category: 'Social & Rent', command: 'follow / fol', syntax: 'follow <player>', desc: 'Follow an experienced player or ranger and join their party.', chapter: '9-npc-communication', chNum: 9 },
+  { category: 'Social & Rent', command: 'give', syntax: 'give <item> <person>', desc: 'Give an item to an NPC or player.', chapter: '10-shopping-trading', chNum: 10 },
+  { category: 'Social & Rent', command: 'list / buy', syntax: 'list / buy <item>', desc: 'Browse merchant wares and buy provisions.', chapter: '10-shopping-trading', chNum: 10 },
+  { category: 'Social & Rent', command: 'offer / rent', syntax: 'offer / rent', desc: 'Check inn room rates and safely save character equipment.', chapter: '15-safe-haven-rent', chNum: 15 }
 ]
 
 const filteredCommands = computed(() => {

diff --git a/docs/index.md b/docs/index.md
@@ -30,7 +30,7 @@ You can trust us to stick to you through thick and thin&mdash;to the bitter end.
   <div class="readytoexplore">Ready to explore Middle-earth?</div>
   <div class="playnow-buttons">
     <a href="./play/"><i class="fa fa-gamepad" aria-hidden="true"></i> Play Now</a>
-    <a href="./play/tutorial/1-orientation" class="btn-secondary-playnow"><i class="fa fa-compass" aria-hidden="true"></i> Interactive Tutorial</a>
+    <a href="./play/tutorial/1-welcome" class="btn-secondary-playnow"><i class="fa fa-compass" aria-hidden="true"></i> Interactive Tutorial</a>
   </div>
 </div>
 

diff --git a/docs/play/index.md b/docs/play/index.md
@@ -24,7 +24,7 @@ MUME is a rich, immersive text-based multiplayer RPG set in Tolkien's Middle-ear
   newTitle="I'm New to MUME"
   newDesc="New to text MUDs or MUME? Take our interactive walkthrough to learn movement, map navigation, combat basics, and survival tips."
   newActionText="Start Interactive Tutorial"
-  newHref="/play/tutorial/1-orientation"
+  newHref="/play/tutorial/1-welcome"
   expTitle="I'm an Experienced Player"
   expDesc="Skip straight to client connections below: MMapper Web (browser), MMapper Desktop, or Mudlet."
   expActionText="Choose Client & Play"

diff --git a/docs/play/tutorial/1-welcome.md b/docs/play/tutorial/1-welcome.md
@@ -0,0 +1,13 @@
+---
+title: "What is MUME?"
+description: "A quick description of what a MUD is, and what MUME is, before you begin."
+steps:
+  - story: |
+      You will steer a ready-made hero named Fuor to try each command. When you play for real, you will make your own character. Your first hour in Middle-earth begins now.
+---
+
+# Welcome to MUME
+
+MUME - Multi-Users in Middle-earth - is a **MUD**: a world made of text, set in Tolkien's Middle-earth, played by hundreds of people at once and running since 1991.
+
+You pick a side, create a character, and live in the world - explore, talk, trade, fight and take on quests, all by typing what you want to do (`look`, `north`, `say hello`). No install needed; you play in your browser.
diff --git a/docs/play/tutorial/10-combat-stances.md b/docs/play/tutorial/10-combat-stances.md
diff --git a/docs/play/tutorial/10-shopping-trading.md b/docs/play/tutorial/10-shopping-trading.md
@@ -0,0 +1,80 @@
+---
+title: "Shopping & Trading"
+description: "Browse a shop, buy provisions for your travels, and give items to players or NPCs."
+teach:
+  - command: "south"
+    desc: "head south into the Cluttered Traveller's Shop"
+  - command: "list"
+    desc: "browse the shopkeeper's available stock and prices"
+  - command: "buy bread"
+    desc: "buy travel rations"
+  - command: "give bread irelm"
+    desc: "give an item to someone in the room (item name comes first)"
+steps:
+  - story: |
+      ![Cluttered Traveller's Shop](/assets/images/tutorial-maps/travellers-shop.jpg)
+  - ask: "south"
+    note: "Head `south` from Market Square into the Cluttered Traveller's Shop."
+    accept:
+      - "south"
+      - "s"
+    hint: "Type: south (or s)"
+  - story: "Bells jingle as Irelm and Fuor enter the shop, surrounded by dusty boxes of dried fruit and fresh baked bread."
+  - ask: "list"
+    note: "Type `list` to browse the grocer's wares and prices."
+    accept:
+      - "list"
+    hint: "Type: list"
+  - ask: "buy bread"
+    note: "Purchase a loaf of travel bread using `buy bread`."
+    accept:
+      - "buy bread"
+    hint: "Type: buy bread"
+  - ask: "give bread irelm"
+    note: "Share your bread with Irelm, who is here with you. Remember MUME syntax: `give <item> <person>`!"
+    accept:
+      - "give bread irelm"
+      - "give bread to irelm"
+    hint: "Type: give bread irelm"
+responses:
+  south: |
+    Cluttered Traveller's Shop
+    A large grocer is here, waiting to buy or sell some goods.
+    Irelm the Dúnadan is here.
+    Exits: north.
+
+    *[>
+  s: |
+    Cluttered Traveller's Shop
+    A large grocer is here, waiting to buy or sell some goods.
+    Irelm the Dúnadan is here.
+    Exits: north.
+
+    *[>
+  list: |
+    You can buy:
+       1. five large yellow apples up to thirteen copper.
+       7. five large biscuits up to seven copper.
+      71. ten loaves of bread up to thirteen copper.
+     124. ten pieces of cheese up to seven copper.
+
+    *[>
+  buy bread: |
+    You buy a loaf of bread for thirteen copper pennies.
+
+    *[>
+  give bread irelm: |
+    You give a loaf of bread to Irelm the Dúnadan.
+    Irelm says 'Thank you, Fuor - good to share provisions on the road!'
+
+    !+*>
+  give bread to irelm: |
+    You give a loaf of bread to Irelm the Dúnadan.
+    Irelm says 'Thank you, Fuor - good to share provisions on the road!'
+
+    !+*>
+---
+
+# Provisioning for your Adventures
+
+Irelm takes Fuor to the **Cluttered Traveller's Shop** for food. Use `list` to see the stock, `buy <item>` to purchase, and `give <item> <person>` to hand something over (item name first).