From c14c2e403c75a913e1a6d962fb6fe64f013adae5 Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Wed, 1 Jul 2026 22:30:31 -0400
Subject: fix: combat formulas and mob attack types (mobs switch attack styles
 if safespotting)

---
 data/help/stats.yaml | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

(limited to 'data/help/stats.yaml')

diff --git a/data/help/stats.yaml b/data/help/stats.yaml
index 395f230..342306a 100644
--- a/data/help/stats.yaml
+++ b/data/help/stats.yaml
@@ -13,5 +13,22 @@ description: |
 
   Strength bonus increases your max melee hit.
   Ranged strength increases your max ranged hit.
-  Science damage increases your max science hit.
-  Technology bonus will affect technology abilities (future).
+  Science damage increases your max science hit as a percentage
+  multiplier on the module's base max hit.
+  Technology bonus reduces technology (prayer) drain.
+
+  Formulas used for the displayed attack roll and max hit:
+
+  Melee:
+    Attack roll = PlayerEffective(Accuracy, style_bonus) * (equip_attack + 64)
+    Max hit     = (PlayerEffective(Strength, style_bonus) * (str_bonus + 64) + 320) / 640
+    PlayerEffective(level, style) = level + style + tech_boosts + 8
+
+  Ranged:
+    Attack roll = PlayerEffective(Ranged, style_bonus) * (ranged_attack + 64)
+    Max hit     = (PlayerEffective(Ranged, style_bonus) * (ranged_str + 64) + 320) / 640
+
+  Science:
+    Attack roll = ScienceEffective(Science) * (science_attack + 64)
+    Max hit     = mod_max_hit * (1 + science_damage% / 100) + elemental_weakness_bonus
+    ScienceEffective(level) = level + tech_boosts + 9
-- 
cgit v1.2.3