feat: firemaking skill implemented. overhauled how ground items and despawn are handled.

1 files changed, 59 insertions, 0 deletions

diff --git a/data/help/firemaking.yaml b/data/help/firemaking.yaml
new file mode 100644
index 0000000..081e10e
--- /dev/null
+++ b/data/help/firemaking.yaml
@@ -0,0 +1,59 @@
+name: "firemaking"
+category: "Skills"
+description: |
+  Start fires from logs and add fuel to keep them burning.
+
+  Usage: burn [item]   - Start a fire from logs
+         stoke [item]  - Add logs to an existing fire
+
+  Firemaking requires a fire starter — matches, a firesteel, or a
+  lighter — either wielded or in your inventory. Matches are consumed
+  on each use, while a firesteel lasts forever. Lighters use butane
+  (quality) that depletes per use; when empty, they stop working.
+
+  BURN — Starting a Fire
+  ----------------------
+  The burn command checks for burnable logs on the ground first, then
+  in your inventory. If the logs are in your inventory, you drop one
+  to the ground and begin making a fire. After a wait (reduced by
+  tool_speed), the game checks your firemaking level against the
+  log's difficulty:
+
+    Success → You start a fire! The fire object appears in the room
+              with a burn time based on the log used. You gain XP.
+
+    Failure → You can't seem to get the fire going. You may try again
+              (the log stays on the ground).
+
+  Only one fire can burn in a room at a time. Other players are
+  notified when a fire is started.
+
+  STOKE — Adding Fuel
+  -------------------
+  Stoke adds more logs from your inventory to an existing fire. Each
+  log extends the fire's burn time by half its burn_ticks and awards
+  firemaking XP. No skill check is needed to stoke — the XP is
+  guaranteed. Stoking continues automatically until you're out of
+  the item or the fire dies out.
+
+  SMART DEFAULTS
+  --------------
+  Running "burn" or "stoke" without specifying an item auto-selects
+  the target if only one type of burnable is available. If multiple
+  log types are present, you'll be asked "Burn what?" or "Stoke what?"
+
+  LOG TYPES
+  ---------
+  Level  Log          XP   Burn Ticks
+  1      Normal       40   24
+  15     Oak          60   28
+  30     Willow       90   32
+  35     Teak         105  36
+  45     Maple        135  40
+  50     Mahogany     158  44
+  60     Yew          202  48
+  75     Magic        303  52
+  90     Redwood      350  60
+
+  Enable the "depletion" toggle to see how long a fire will burn.
+  Enable the "xpdrops" toggle to see XP gains with each log.