feat: movement overhauled. agility-enhancing items added.

15 files changed, 122 insertions, 9 deletions

diff --git a/data/help/attack.yaml b/data/help/attack.yaml
index 96a4bcd..fb65ef6 100644
--- a/data/help/attack.yaml
+++ b/data/help/attack.yaml
@@ -12,4 +12,4 @@ description: |
   name (e.g. "attack 1.man"). Plain "attack man" targets the first.
 
   Attacks occur at weapon speed on the 600ms tick. Use "style" to change
-  combat style. You are locked in place when combat starts.
+  combat style. Move in any direction to attempt to flee combat.
diff --git a/data/help/color.yaml b/data/help/color.yaml
index 5927e9a..6082183 100644
--- a/data/help/color.yaml
+++ b/data/help/color.yaml
@@ -77,6 +77,10 @@ description: |
     drop_message   Mob loot drops
     credits_pickup Currency/credit messages
 
+  Visual tick colors:
+    visual_tick      Visual tick marker text (dim blue)
+    visual_first_tick First tick in a numbered cycle (bright red)
+
   Resolution order:
     1. Account override (set via "color" command)
     2. Server default (set in config.yaml)
diff --git a/data/help/combat.yaml b/data/help/combat.yaml
index 6336fae..b02fb1a 100644
--- a/data/help/combat.yaml
+++ b/data/help/combat.yaml
@@ -5,9 +5,29 @@ description: |
 
   - 600ms tick engine with per-weapon attack speeds
   - Attack, Strength, and Defense rolls determine hit/miss
-  - Combat triangle: Melee > Ranged > Technology > Melee
+  - Combat triangle: Melee > Ranged > Science > Melee
   - 4 XP per point of damage, distributed by combat style
-  - You are locked in place for 15 ticks when combat starts
   - Damaged mobs show current HP in look (damaged listed first)
   - Mobs regenerate 1 HP every 100 ticks (60 seconds)
   - Players also regenerate 1 HP every 100 ticks
+
+  Fleeing combat:
+    Move in any direction (n/s/e/w/u/d) to attempt to flee.
+    The movement countdown begins (default 4 ticks). If the mob
+    lands a hit during the countdown, you get "Can't escape!" and
+    remain in combat. If the mob misses or doesn't attack, you
+    successfully escape after the countdown.
+
+    Equipment that reduces movement time (Cape of Agility, Graceful
+    set) also reduces the flee countdown. With the Cape of Agility,
+    fleeing is instant.
+
+    Enable "run_countdown" option to see tick-by-tick messages
+    while fleeing.
+
+  Mob level colors in room display and broadcasts:
+    Green        Mob is 5+ levels below you
+    Green-yellow Mob is 1-4 levels below you
+    White        Mob is equal level
+    Orange       Mob is 1-4 levels above you
+    Red          Mob is 5+ levels above you
diff --git a/data/help/movement.yaml b/data/help/movement.yaml
index 91aefa6..19a09b9 100644
--- a/data/help/movement.yaml
+++ b/data/help/movement.yaml
@@ -6,8 +6,26 @@ description: |
   Usage: north, south, east, west, up, down
   Aliases: n, s, e, w, u, d
 
-  You cannot move during the combat lock period after combat starts.
-  Moving interrupts combat and any active gathering or crafting action.
+  Movement takes 4 game ticks by default. Certain equipment reduces
+  this delay:
 
-  With "description" toggled on, moving shows the full room description
-  instead of just the room name. Use "toggle" to change this setting.
+    Cape of Agility    Instant movement (1 tick)
+    Graceful set       Each piece reduces movement by 0.25 ticks.
+                       Full set (6 pieces) gives an extra 0.5 bonus,
+                       for 2 ticks total. Uses fractional ticks.
+
+  The Cape of Agility overrides all Graceful bonuses.
+
+  Moving interrupts any active gathering or crafting action.
+
+  During combat, movement becomes a flee attempt. The mob continues
+  to attack during the movement countdown. If the mob lands a hit
+  before the countdown finishes, the escape fails ("Can't escape!")
+  and combat resumes. If no hit lands, the player successfully
+  escapes. See 'help combat' for details.
+
+  The "run_countdown" option shows tick-by-tick countdown messages
+  when fleeing combat.
+
+  With "description" toggled on, moving shows the full room
+  description instead of just the room name.
diff --git a/data/help/prompt.yaml b/data/help/prompt.yaml
index 9af6b01..f3c23f4 100644
--- a/data/help/prompt.yaml
+++ b/data/help/prompt.yaml
@@ -6,6 +6,7 @@ description: |
   Usage:
     prompt              Show current prompt
     prompt <value>      Set a custom prompt
+    prompt none         Set prompt to blank
     prompt reset        Restore default "> "
 
   Your prompt string can include variables and color blocks.
diff --git a/data/help/remove.yaml b/data/help/remove.yaml
index 757bb27..cce21f4 100644
--- a/data/help/remove.yaml
+++ b/data/help/remove.yaml
@@ -4,8 +4,12 @@ description: |
   Unequip an item and return it to your inventory.
 
   Usage: remove <item>, unwear <item>, unwield <item>
+         remove all, unwear all
 
   Removes the named item (or the item in the named slot) and places it
   in your inventory. If your inventory is full, you cannot remove it.
 
-  Examples: remove axe, remove main_hand
+  "remove all" removes all equipped items at once. If there is not
+  enough inventory space for everything, nothing is removed.
+
+  Examples: remove axe, remove main_hand, remove all
diff --git a/data/help/walk.yaml b/data/help/walk.yaml
index 6c34ecd..11b8338 100644
--- a/data/help/walk.yaml
+++ b/data/help/walk.yaml
@@ -8,7 +8,9 @@ description: |
 
   Direction mode:
     Provide a string of direction characters (n, s, e, w, u, d).
-    Each character queues one movement step per game tick.
+    Each character queues one movement step. Each step takes the
+    normal movement tick delay (default 4 ticks per step, reduced
+    by movement equipment like Graceful or Cape of Agility).
 
     Examples:
       walk nnewn       Walk north, north, east, west, north (5 ticks)
diff --git a/data/items/cape_of_agility.yaml b/data/items/cape_of_agility.yaml
new file mode 100644
index 0000000..5567e73
--- /dev/null
+++ b/data/items/cape_of_agility.yaml
@@ -0,0 +1,6 @@
+id: cape_of_agility
+name: cape of agility
+color: "g:223,231,223"
+description: "A lightweight cape that allows the wearer to move with extraordinary speed."
+value: 500
+equip_slot: back
diff --git a/data/items/graceful_boots.yaml b/data/items/graceful_boots.yaml
new file mode 100644
index 0000000..71e8f84
--- /dev/null
+++ b/data/items/graceful_boots.yaml
@@ -0,0 +1,6 @@
+id: graceful_boots
+name: graceful boots
+color: "230"
+description: "Lightweight boots. Part of the graceful set."
+value: 80
+equip_slot: feet
diff --git a/data/items/graceful_cape.yaml b/data/items/graceful_cape.yaml
new file mode 100644
index 0000000..1d7c8f0
--- /dev/null
+++ b/data/items/graceful_cape.yaml
@@ -0,0 +1,6 @@
+id: graceful_cape
+name: graceful cape
+color: "230"
+description: "A lightweight cape. Part of the graceful set."
+value: 100
+equip_slot: back
diff --git a/data/items/graceful_gloves.yaml b/data/items/graceful_gloves.yaml
new file mode 100644
index 0000000..311ded5
--- /dev/null
+++ b/data/items/graceful_gloves.yaml
@@ -0,0 +1,6 @@
+id: graceful_gloves
+name: graceful gloves
+color: "230"
+description: "Lightweight gloves. Part of the graceful set."
+value: 80
+equip_slot: hands
diff --git a/data/items/graceful_hat.yaml b/data/items/graceful_hat.yaml
new file mode 100644
index 0000000..faec1e3
--- /dev/null
+++ b/data/items/graceful_hat.yaml
@@ -0,0 +1,6 @@
+id: graceful_hat
+name: graceful hat
+color: "230"
+description: "A lightweight hat. Part of the graceful set."
+value: 100
+equip_slot: head
diff --git a/data/items/graceful_legs.yaml b/data/items/graceful_legs.yaml
new file mode 100644
index 0000000..31eeebf
--- /dev/null
+++ b/data/items/graceful_legs.yaml
@@ -0,0 +1,6 @@
+id: graceful_legs
+name: graceful legs
+color: "230"
+description: "Lightweight leg armour. Part of the graceful set."
+value: 150
+equip_slot: legs
diff --git a/data/items/graceful_torso.yaml b/data/items/graceful_torso.yaml
new file mode 100644
index 0000000..ec1edb7
--- /dev/null
+++ b/data/items/graceful_torso.yaml
@@ -0,0 +1,6 @@
+id: graceful_torso
+name: graceful torso
+color: "230"
+description: "A lightweight top. Part of the graceful set."
+value: 150
+equip_slot: torso
diff --git a/data/rooms/1.yaml b/data/rooms/1.yaml
index ba42be0..aaf6dda 100644
--- a/data/rooms/1.yaml
+++ b/data/rooms/1.yaml
@@ -11,3 +11,25 @@ objects:
   - id: lumby_fountain
 mobs:
   - "newbie_trainer"
+spawns:
+  - item_id: cape_of_agility
+    quantity: 1
+    respawn_ticks: 60
+  - item_id: graceful_hat
+    quantity: 1
+    respawn_ticks: 60
+  - item_id: graceful_torso
+    quantity: 1
+    respawn_ticks: 60
+  - item_id: graceful_legs
+    quantity: 1
+    respawn_ticks: 60
+  - item_id: graceful_gloves
+    quantity: 1
+    respawn_ticks: 60
+  - item_id: graceful_boots
+    quantity: 1
+    respawn_ticks: 60
+  - item_id: graceful_cape
+    quantity: 1
+    respawn_ticks: 60