feat: implement run energy, shorten walk time to 1-2 ticks between rooms, update graceful set

1 files changed, 22 insertions, 10 deletions

diff --git a/data/help/movement.yaml b/data/help/movement.yaml
index 0623510..426e667 100644
--- a/data/help/movement.yaml
+++ b/data/help/movement.yaml
@@ -6,19 +6,26 @@ description: |
   Usage: north, south, east, west, up, down
   Aliases: n, s, e, w, u, d
 
-  Movement takes 2 game ticks by default. Certain equipment reduces
-  this delay:
+  Movement speed is controlled by your Run Energy:
 
-    Cape of Agility    Instant movement (1 tick)
-    Graceful set       Each piece reduces movement by 0.15 ticks.
-                       Full set (6 pieces) gives an extra 0.1 bonus,
-                       for 1 tick total. Uses fractional ticks.
+    Run energy present  ........  1 tick to move, drains 1 run energy
+    No run energy        ........  2 ticks to move, drains nothing
 
-  The Cape of Agility overrides all Graceful bonuses.
+  Your maximum run energy is 3x your Agility level. Run energy regenerates
+  automatically over time:
 
-  The "walk" command (BFSPathfinding or direction sequences) takes
-  twice as long as normal movement per step (4 ticks default, 2 ticks
-  with the full Graceful set).
+    Idle   1 per 5 ticks
+    Busy   1 per 10 ticks   (any action: combat, gathering, crafting,
+                            walking, hiding, hacking, etc.)
+
+  Equipment effects on run energy:
+
+    Cape of Agility     Infinite run energy. Movement is instant and
+                        never drains energy.
+    Graceful outfit     Each piece +8% run-energy recovery rate; the
+                        complete 6-piece set adds a further +10% (so a
+                        full set regenerates energy ~1.63x faster). The
+                        Graceful outfit no longer changes movement speed.
 
   Moving interrupts any active gathering or crafting action.
 
@@ -33,3 +40,8 @@ description: |
 
   With "description" toggled on, moving shows the full room
   description instead of just the room name.
+
+  Dying refills your run energy to full (alongside your HP).
+related:
+  - walk
+  - agility
\ No newline at end of file