feat: update mob flee mechanics with new energy system

4 files changed, 28 insertions, 9 deletions

diff --git a/data/help/attack.yaml b/data/help/attack.yaml
index 1c41771..8ba664c 100644
--- a/data/help/attack.yaml
+++ b/data/help/attack.yaml
@@ -12,7 +12,10 @@ 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. Move in any direction to attempt to flee combat.
+  combat style. Move in any direction to wait for an opening to flee
+  combat. If the mob misses its next attack you escape; if it hits,
+  the escape fails and combat resumes. Issuing an attack or "stop"
+  command abandons a pending flee attempt.
 
   Damage formula (OSRS-standard):
     Max hit = (EffectiveStrength * (StrBonus + 64) + 320) / 640
diff --git a/data/help/combat.yaml b/data/help/combat.yaml
index 7a190f7..ac4cf65 100644
--- a/data/help/combat.yaml
+++ b/data/help/combat.yaml
@@ -40,3 +40,8 @@ description: |
 
   Use 'stats' to see your total equipment bonuses and current attack roll.
   Use 'look <item>' to see an item's combat stats.
+
+  To escape combat, move in any direction. You must wait for the mob
+  to miss an attack — on a miss the 1-2 tick run delay begins and you
+  leave the room; on a hit the escape fails ("Can't escape!") and you
+  stay in combat. See 'help movement' for details.
diff --git a/data/help/movement.yaml b/data/help/movement.yaml
index 426e667..f6d1605 100644
--- a/data/help/movement.yaml
+++ b/data/help/movement.yaml
@@ -29,14 +29,20 @@ description: |
 
   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.
+  During combat, movement becomes a flee attempt. Instead of moving
+  immediately, you must wait for the mob to miss an attack — only then
+  do you begin the normal 1-2 tick movement delay. If the mob lands a
+  hit while you are waiting to flee, the escape fails ("Can't escape!")
+  and you remain in combat. Successfully fleeing stops combat and moves
+  you to the target room.
+
+  Instant-move gear (Cape of Agility, GodMode) bypasses the miss-gate
+  and lets you leave immediately even in combat.
+
+  The "walk" command auto-attempts to escape combat when you walk
+  through a hostile room. If a walk step is hit while fleeing, the
+  entire walk sequence is cancelled. If the escape succeeds, the walk
+  continues from the next room.
 
   With "description" toggled on, moving shows the full room
   description instead of just the room name.
diff --git a/data/help/walk.yaml b/data/help/walk.yaml
index 847262c..83f0347 100644
--- a/data/help/walk.yaml
+++ b/data/help/walk.yaml
@@ -41,6 +41,11 @@ description: |
   While walking, you appear as "walking somewhere with a purpose!"
   when other players look at the room. The walk action interrupts
   any other active action you were performing.
+
+  When a walk step enters a room with an aggressive mob, the step
+  automatically becomes a flee attempt — you must wait for the mob
+  to miss before continuing. If the mob hits you while fleeing, the
+  entire walk sequence is cancelled and you remain in combat.
 related:
   - movement
   - agility
\ No newline at end of file