feat: add automatic flee on third failed flee attempt

2 files changed, 13 insertions, 1 deletions

diff --git a/data/help/attack.yaml b/data/help/attack.yaml
index 8ba664c..5873aaa 100644
--- a/data/help/attack.yaml
+++ b/data/help/attack.yaml
@@ -14,9 +14,14 @@ description: |
   Attacks occur at weapon speed on the 600ms tick. Use "style" to change
   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"
+  the escape fails and combat resumes. If the mob lands three hits in
+  a row while you are trying to flee, on the third hit you power
+  through and just flee anyway. Issuing an attack or "stop"
   command abandons a pending flee attempt.
 
+  Aggressive mobs attack you on arrival and on each subsequent tick
+  with a 33% chance — even a single-tick runner risks getting caught.
+
   Damage formula (OSRS-standard):
     Max hit = (EffectiveStrength * (StrBonus + 64) + 320) / 640
     Attack roll = EffectiveAttack * (AttackBonus + 64)
diff --git a/data/help/movement.yaml b/data/help/movement.yaml
index f6d1605..c9bc792 100644
--- a/data/help/movement.yaml
+++ b/data/help/movement.yaml
@@ -36,6 +36,13 @@ description: |
   and you remain in combat. Successfully fleeing stops combat and moves
   you to the target room.
 
+  Soft-lock relief: if the mob lands THREE hits in a row while you are
+  trying to flee the same engagement, on the third hit you power
+  through its relentless attacks and just flee anyway (taking the
+  third hit's damage in the process). This ensures an accurate mob can
+  never keep you pinned forever. The count resets on every successful
+  flee (miss, mob death, or the relief) and on each fresh combat entry.
+
   Instant-move gear (Cape of Agility, GodMode) bypasses the miss-gate
   and lets you leave immediately even in combat.