feat: safespot system implemented

1 files changed, 38 insertions, 0 deletions

diff --git a/data/help/safespot.yaml b/data/help/safespot.yaml
new file mode 100644
index 0000000..76e1768
--- /dev/null
+++ b/data/help/safespot.yaml
@@ -0,0 +1,38 @@
+name: "safespot"
+category: "Skills"
+description: |
+  Use environmental cover to block melee attacks from mobs while
+  attacking with ranged or science weapons.
+
+  Usage: hide <object>
+         safespot <object>
+
+  Find a safespot: look <object>
+  Leave a safespot: unhide (or unsafespot)
+
+  While in a safespot, melee mobs cannot reach you. Ranged and science
+  mobs can still attack. Attacking with melee while in a safespot forces
+  you out of cover.
+
+  Safespots degrade over time while in use. Each degrade level shows a
+  different message. When fully degraded, the safespot is destroyed.
+  Some safespots respawn after a delay; others require you to re-hide
+  to reset them.
+
+  There is a small per-tick chance of being forced out of cover
+  (unsafe_chance). You can re-hide immediately if the safespot is
+  still intact.
+
+  Hiding out of combat takes 1 tick. Hiding while fighting takes 4
+  ticks — taking a hit during the repositioning aborts the attempt.
+
+  Your effective safespot tier is unlocked by completing quests and
+  combat achievements. Higher-tier safespots require quest flags like
+  "quest_animal_magnetism" or achievement flags like
+  "achieve_medium_combat".
+
+  You can customize the alert shown when you are forced out of a
+  safespot with: option safespot_alert <message>
+  Set to "none" to disable. Uses inline color tags.
+
+  See also: help hide, help combat, help option