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/attack.yaml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

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

diff --git a/data/help/attack.yaml b/data/help/attack.yaml
index fb65ef6..1c41771 100644
--- a/data/help/attack.yaml
+++ b/data/help/attack.yaml
@@ -13,3 +13,16 @@ description: |
 
   Attacks occur at weapon speed on the 600ms tick. Use "style" to change
   combat style. Move in any direction to attempt to flee combat.
+
+  Damage formula (OSRS-standard):
+    Max hit = (EffectiveStrength * (StrBonus + 64) + 320) / 640
+    Attack roll = EffectiveAttack * (AttackBonus + 64)
+    Defense roll = (mob.Defense + 9) * (mobDefBonus + 64)
+    Hit chance: if AtkRoll > DefRoll: 1 - (Def+2)/(2*Atk), else Atk/(2*Def)
+    Damage: roll [0, MaxHit], 0 becomes 1
+
+  Effective level = base_level + style_bonus + tech_boosts + 8 (player)
+                    base_level + 9 (NPC/defense)
+                    base_level + 9 (science, no style bonus)
+
+  See 'combat', 'stats', 'style', and 'science' for details.
-- 
cgit v1.2.3