fix: help topics (newplayer, title/body files), help aliases, and table width rebalancing

23 files changed, 143 insertions, 1 deletions

diff --git a/data/help/alias.yaml b/data/help/alias.yaml
index 4be2f98..2caf8ed 100644
--- a/data/help/alias.yaml
+++ b/data/help/alias.yaml
@@ -13,3 +13,6 @@ description: |
 
   Aliases resolve before built-in commands. An alias can shadow an
   existing command name.
+
+aliases:
+  - "unalias"
diff --git a/data/help/attack.yaml b/data/help/attack.yaml
index 5873aaa..9cf32ff 100644
--- a/data/help/attack.yaml
+++ b/data/help/attack.yaml
@@ -34,3 +34,6 @@ description: |
                     base_level + 9 (science, no style bonus)
 
   See 'combat', 'stats', 'style', and 'science' for details.
+
+aliases:
+  - "kill"
diff --git a/data/help/autotrigger.yaml b/data/help/autotrigger.yaml
index 08ca57e..25582aa 100644
--- a/data/help/autotrigger.yaml
+++ b/data/help/autotrigger.yaml
@@ -28,3 +28,6 @@ description: |
   autotrigger none        - Disable autotrigger
 
   See also: trigger, mods, science
+
+aliases:
+  - "auto"
diff --git a/data/help/color.yaml b/data/help/color.yaml
index 82e8fed..87148c3 100644
--- a/data/help/color.yaml
+++ b/data/help/color.yaml
@@ -104,3 +104,6 @@ description: |
   You can use color blocks in your prompt:
     prompt {02 bold}Ready>{/} %h/%Hhp
   See 'help prompt' for full prompt customization.
+
+aliases:
+  - "colors"
diff --git a/data/help/description.yaml b/data/help/description.yaml
index 3436c5b..d527307 100644
--- a/data/help/description.yaml
+++ b/data/help/description.yaml
@@ -10,3 +10,6 @@ description: |
   room look output including description, mobs, objects,
   items, and exits.
   When disabled, only the room name is shown on move.
+
+aliases:
+  - "desc"
diff --git a/data/help/equipment.yaml b/data/help/equipment.yaml
index 3c0d70c..14bcb67 100644
--- a/data/help/equipment.yaml
+++ b/data/help/equipment.yaml
@@ -11,3 +11,6 @@ description: |
 
   Shows what you have in each slot (main hand, head, torso, etc.).
   Use "remove <item>" to unequip.
+
+aliases:
+  - "eq"
diff --git a/data/help/farming.yaml b/data/help/farming.yaml
index 2dd2ff2..ca281a8 100644
--- a/data/help/farming.yaml
+++ b/data/help/farming.yaml
@@ -29,3 +29,6 @@ description: |
 
   See also: help plant, help harvest, help rake, help water,
             help cure, help inspect
+
+aliases:
+  - "farm"
diff --git a/data/help/fishing.yaml b/data/help/fishing.yaml
index 61d7309..7f47756 100644
--- a/data/help/fishing.yaml
+++ b/data/help/fishing.yaml
@@ -20,3 +20,6 @@ description: |
   Look at a spot to see what equipment it needs.
 
   Enable the "xpdrops" toggle to see XP gains with each catch.
+
+aliases:
+  - "fish"
diff --git a/data/help/fletching.yaml b/data/help/fletching.yaml
index b2fe254..c347954 100644
--- a/data/help/fletching.yaml
+++ b/data/help/fletching.yaml
@@ -25,3 +25,6 @@ description: |
     wear arrows, wear 100 arrows, remove arrows, remove 100 arrows
 
   See also: fletch, use, wear, remove
+
+aliases:
+  - "fletch"
diff --git a/data/help/get.yaml b/data/help/get.yaml
index 777541b..a40affa 100644
--- a/data/help/get.yaml
+++ b/data/help/get.yaml
@@ -10,3 +10,7 @@ description: |
   added to your credit balance and never take inventory space.
 
   Picking up an item cancels any active gathering or crafting action.
+
+aliases:
+  - "take"
+  - "grab"
diff --git a/data/help/inventory.yaml b/data/help/inventory.yaml
index 7a60650..73a9999 100644
--- a/data/help/inventory.yaml
+++ b/data/help/inventory.yaml
@@ -6,3 +6,7 @@ description: |
   Usage: inventory, i, inv
 
   Shows all 28 inventory slots and any equipped items.
+
+aliases:
+  - "i"
+  - "inv"
diff --git a/data/help/look.yaml b/data/help/look.yaml
index d547bb6..2ce3d5f 100644
--- a/data/help/look.yaml
+++ b/data/help/look.yaml
@@ -28,3 +28,6 @@ description: |
   - Directions: shows the adjacent room as if you were there
 
   Use "toggle depletion" to show depletion and despawn timers on objects.
+
+aliases:
+  - "l"
diff --git a/data/help/mining.yaml b/data/help/mining.yaml
index 231027f..7eecfd6 100644
--- a/data/help/mining.yaml
+++ b/data/help/mining.yaml
@@ -19,3 +19,6 @@ description: |
   Use numbered targeting (e.g. "mine 2.rock") when multiple rocks of the
   same type are present. "look rock" shows which rocks are depleted.
   Use "toggle depletion" to see exact respawn timers.
+
+aliases:
+  - "mine"
diff --git a/data/help/mods.yaml b/data/help/mods.yaml
index d545b54..71b8abc 100644
--- a/data/help/mods.yaml
+++ b/data/help/mods.yaml
@@ -20,3 +20,6 @@ description: |
   Aliases: mods, mod, module, modules
 
   See also: trigger, autotrigger, science
+
+aliases:
+  - "modlist"
diff --git a/data/help/movement.yaml b/data/help/movement.yaml
index c9bc792..1b684dc 100644
--- a/data/help/movement.yaml
+++ b/data/help/movement.yaml
@@ -57,4 +57,21 @@ description: |
   Dying refills your run energy to full (alongside your HP).
 related:
   - walk
-  - agility
\ No newline at end of file
+  - agility
+aliases:
+  - "north"
+  - "south"
+  - "east"
+  - "west"
+  - "up"
+  - "down"
+  - "ne"
+  - "nw"
+  - "se"
+  - "sw"
+  - "n"
+  - "s"
+  - "e"
+  - "w"
+  - "u"
+  - "d"
diff --git a/data/help/newplayer.yaml b/data/help/newplayer.yaml
new file mode 100644
index 0000000..5f0eb17
--- /dev/null
+++ b/data/help/newplayer.yaml
@@ -0,0 +1,56 @@
+name: "newplayer"
+aliases:
+  - "new player"
+  - "getting started"
+  - "guide"
+  - "basics"
+category: "Getting Started"
+description: |
+  Welcome to The House of Icarus! This guide covers the basics.
+
+  Getting around
+    Move with north, south, east, west, up, down (or the shortcuts
+    n, s, e, w, u, d). "exits" lists the ways out of a room, "map"
+    draws a local map, and "walk <room>" auto-pathfinds for you.
+    Movement uses run energy; see 'help movement' for the details.
+
+  Looking around
+    "look" describes the room, "look <thing>" examines an item,
+    object, or mob. Use numbers to pick between identical targets,
+    e.g. "look 2.rock".
+
+  Your character
+    "score" shows your stats, skills, and combat level. "inventory"
+    (i) shows your 28-slot pack, and "equipment" (eq) shows what
+    you're wearing and wielding. "stats" lists your combat bonuses.
+
+  Items
+    "get <item>" picks things up ("get all" grabs everything),
+    "drop <item>" puts them down, "wear <item>" and "wield <item>"
+    equip gear, "remove <item>" unequips it. "eat <food>" and
+    "drink <potion>" restore hitpoints. "use <item> on <object>"
+    interacts with the world.
+
+  Skills
+    Gathering:  mine (Mining), fish (Fishing), chop (Woodcutting),
+                farm (Farming), search (Scavenging)
+    Crafting:   cook, smelt, smith, craft, fletch, mix, construct
+    Most skills need the right tool, either wielded or in your pack.
+    Many actions take a few ticks, so you can queue several commands.
+
+  Combat
+    "attack <mob>" starts a fight (e.g. "attack man" or "attack 1.man").
+    Combat runs automatically on the tick; "style" changes whether you
+    train accuracy, strength, or defense. To flee, move in any
+    direction - see 'help combat' for the rules.
+
+  Talking
+    "talk <mob>" starts an NPC conversation (pick numbered options;
+    type "bye" to leave). "say <msg>" chats to your room and
+    "global <msg>" to everyone online.
+
+  Tips
+    "help <command>" shows detailed usage of any command.
+    "options" tweaks display settings (width, colors, unicode, map).
+    "help <topic>" pages include a "related:" list of nearby topics -
+    follow them as you explore.
diff --git a/data/help/option.yaml b/data/help/option.yaml
index 75b1794..0eb871a 100644
--- a/data/help/option.yaml
+++ b/data/help/option.yaml
@@ -19,3 +19,6 @@ description: |
 
   Use help <option> for details on a specific option.
   Use 'prompt' to set a custom per-character prompt.
+
+aliases:
+  - "options"
diff --git a/data/help/remove.yaml b/data/help/remove.yaml
index cce21f4..b44630d 100644
--- a/data/help/remove.yaml
+++ b/data/help/remove.yaml
@@ -13,3 +13,7 @@ description: |
   enough inventory space for everything, nothing is removed.
 
   Examples: remove axe, remove main_hand, remove all
+
+aliases:
+  - "unwear"
+  - "unwield"
diff --git a/data/help/score.yaml b/data/help/score.yaml
index cacf0ba..df8040d 100644
--- a/data/help/score.yaml
+++ b/data/help/score.yaml
@@ -10,3 +10,6 @@ description: |
   The vitals block includes three bars: HP (red/green/yellow), BAT
   (battery, blue), and ENG (run energy, green). Run energy maximum
   is 3x your Agility level; see 'help movement' for run energy rules.
+
+aliases:
+  - "sc"
diff --git a/data/help/talk.yaml b/data/help/talk.yaml
index 4a59f68..3ac60ef 100644
--- a/data/help/talk.yaml
+++ b/data/help/talk.yaml
@@ -9,3 +9,7 @@ description: |
   choices. Type the number to select an option.
 
   Type "bye", "exit", or "end" to leave the conversation at any time.
+
+aliases:
+  - "speak"
+  - "ask"
diff --git a/data/help/use.yaml b/data/help/use.yaml
index d9bcfd4..34f5a4b 100644
--- a/data/help/use.yaml
+++ b/data/help/use.yaml
@@ -36,3 +36,7 @@ description: |
     push gate                    Push a gate open (shortcut for use)
 
   See also: cook, smelt, smith, recipe
+
+aliases:
+  - "pull"
+  - "push"
diff --git a/data/help/wear.yaml b/data/help/wear.yaml
index 2a92fbd..72d7e64 100644
--- a/data/help/wear.yaml
+++ b/data/help/wear.yaml
@@ -6,3 +6,6 @@ description: |
   Usage: wear <item>       Equip an item from inventory
          wear all          Auto-equip best items per slot
          wear              View equipped items
+
+aliases:
+  - "wield"
diff --git a/data/help/woodcutting.yaml b/data/help/woodcutting.yaml
index 80179a9..2ce502f 100644
--- a/data/help/woodcutting.yaml
+++ b/data/help/woodcutting.yaml
@@ -20,3 +20,7 @@ description: |
   nest alongside the logs. Use "search nest" to open a nest for loot.
 
   Use the "depletion" toggle to see timers on trees and rocks.
+
+aliases:
+  - "chop"
+  - "cut"