feat: fractional ticks and server game_speed implemented. potentially insanely janky.

1 files changed, 24 insertions, 0 deletions

diff --git a/data/help/ticks.yaml b/data/help/ticks.yaml
new file mode 100644
index 0000000..fd128c2
--- /dev/null
+++ b/data/help/ticks.yaml
@@ -0,0 +1,24 @@
+name: "ticks"
+category: "General"
+description: |
+  All timed game actions use a tick-based system. Each game tick runs at a
+  configurable interval (default 600ms). Actions like gathering, combat, and
+  crafting advance on each tick.
+
+  Fractional ticks allow tool speeds and timers to be non-integer values.
+  For example, a tool with speed 4.5 has a 50% chance of taking 4 ticks
+  and a 50% chance of taking 5 ticks per action cycle. The average
+  converges to 4.5 over many actions. This applies to:
+
+    - Tool speed (gathering, firemaking)
+    - Weapon speed (combat)
+    - Production wait timers (use behaviors)
+    - Search timers
+    - Depletion and respawn timers
+
+  The game_speed config option scales ALL tick timers proportionally.
+  A game_speed of 2.0 makes everything resolve twice as fast; 0.5 makes
+  everything twice as slow.
+
+  Use the "option" command to configure tick-related display settings.
+  Use "help option" for a list of all player options.