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

3 files changed, 110 insertions, 0 deletions

diff --git a/data/help/burn.yaml b/data/help/burn.yaml
new file mode 100644
index 0000000..63b6623
--- /dev/null
+++ b/data/help/burn.yaml
@@ -0,0 +1,25 @@
+name: "burn"
+category: "Skills"
+description: |
+  Start a fire from logs.
+
+  Usage: burn [item]
+
+  Attempts to light a fire using burnable logs. Checks for logs on the
+  ground first, then in your inventory.
+
+  Requires a fire starter tool (matches, firesteel, or lighter).
+
+  From inventory:
+    You drop a log to the ground, then try to light it.
+
+  From ground:
+    You attempt to light the log already on the ground.
+
+  After a short wait, your firemaking level is checked against the
+  log's difficulty. On success, a fire object appears in the room
+  that burns for a number of ticks based on the log type. On failure,
+  you may try again.
+
+  Only one fire can burn in a room at a time.
+  See also: help firemaking, help stoke
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.
diff --git a/data/help/stoke.yaml b/data/help/stoke.yaml
new file mode 100644
index 0000000..96e53e3
--- /dev/null
+++ b/data/help/stoke.yaml
@@ -0,0 +1,26 @@
+name: "stoke"
+category: "Skills"
+description: |
+  Add logs to an existing fire.
+
+  Usage: stoke [item]
+
+  Adds burnable logs from your inventory to a fire already burning in
+  the current room. No tool is needed to stoke.
+
+  Each log extends the fire's remaining burn time and awards guaranteed
+  firemaking XP (no skill check). Stoking continues automatically until
+  you run out of the item or the fire dies out.
+
+  Fire Type      Quality Gained
+  Normal         +12 ticks
+  Oak            +14 ticks
+  Willow         +16 ticks
+  Teak           +18 ticks
+  Maple          +20 ticks
+  Mahogany       +22 ticks
+  Yew            +24 ticks
+  Magic          +26 ticks
+  Redwood        +30 ticks
+
+  See also: help firemaking, help burn