From 1aba2bdd23aebed4032333e74aa553c40a31fcbd Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Sun, 14 Jun 2026 21:07:26 -0400
Subject: refactor: added docs, split up some components in game package

---
 internal/combat/doc.go | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 internal/combat/doc.go

(limited to 'internal/combat/doc.go')

diff --git a/internal/combat/doc.go b/internal/combat/doc.go
new file mode 100644
index 0000000..758be47
--- /dev/null
+++ b/internal/combat/doc.go
@@ -0,0 +1,11 @@
+// Package combat implements OSRS-style combat formulas and per-player
+// combat state tracking.
+//
+// Combat uses attack/defense roll formulas, style bonuses, and max-hit
+// calculations. The State type tracks active combat between a player and
+// a mob instance, with a lock timer preventing immediate disengagement.
+//
+// Combat state is managed through package-level maps protected by a mutex.
+// TickCombat decrements lock timers each tick. EnterCombat and LeaveCombat
+// manage the relationship between player names and mob instance IDs.
+package combat
-- 
cgit v1.2.3