refactor: added docs, split up some components in game package

1 files changed, 11 insertions, 0 deletions

diff --git a/internal/action/doc.go b/internal/action/doc.go
new file mode 100644
index 0000000..c1a898d
--- /dev/null
+++ b/internal/action/doc.go
@@ -0,0 +1,11 @@
+// Package action defines the behavior type system, action state tracking,
+// and drop table resolution for the game world.
+//
+// Behaviors are YAML-driven and come in four types: gather, talk, use, and toggle.
+// This package provides configuration structs for each type, the Action struct
+// that tracks per-player action state (type, target, tick countdown), and the
+// Store for loading behaviors and resolving weighted drop tables.
+//
+// The SuccessChance function implements the OSRS-style skill check formula.
+// Drop table resolution supports nested sub-tables via the ResolveDrop method.
+package action