feat: scavenge/scrap system started

2 files changed, 65 insertions, 0 deletions

diff --git a/data/help/id.yaml b/data/help/id.yaml
new file mode 100644
index 0000000..6605711
--- /dev/null
+++ b/data/help/id.yaml
@@ -0,0 +1,26 @@
+name: "id"
+category: "Commands"
+description: |
+  Identify scrap metal at an altar to produce junk.
+
+  Usage: id
+         identify
+
+  Stand at an altar with the matching identifier tool in
+  your inventory and scrap metal. Type 'id' to convert all
+  your scrap metal into junk on the next game tick.
+
+  Each altar type requires a specific identifier:
+    Solar Altar  → solar identifier → solarjunk  (level 1)
+    Hydro Altar  → hydro identifier → hydrojunk  (level 14)
+    Cosmic Altar → cosmic identifier → cosmicjunk (level 27)
+    Eco Altar    → eco identifier   → ecojunk    (level 28)
+    Chaos Altar  → chaos identifier → chaosjunk  (level 35)
+    Bio Altar    → bio identifier   → biojunk    (level 44)
+    Nature Altar → nature identifier → naturejunk (level 44)
+    Law Altar    → law identifier   → lawjunk    (level 54)
+    Death Altar  → death identifier → deathjunk  (level 65)
+    Blood Altar  → blood identifier → bloodjunk  (level 77)
+
+  At higher scavenging levels, each scrap produces multiple junk.
+  See 'help scavenging' for the full multiplier table.
diff --git a/data/help/scavenging.yaml b/data/help/scavenging.yaml
new file mode 100644
index 0000000..d91c6ed
--- /dev/null
+++ b/data/help/scavenging.yaml
@@ -0,0 +1,39 @@
+name: "scavenging"
+category: "Skills"
+description: |
+  Scavenging is the art of reclaiming useful circuitry from
+  salvaged scrap metal.
+
+  Step 1: Mine scrap metal from scrap piles (requires a pickaxe,
+          uses the Mining skill).
+  Step 2: Take scrap metal to an altar with the matching
+          identifier tool.
+  Step 3: Type 'id' to convert all scrap metal into junk.
+
+  Junk types and requirements:
+    Solarjunk  — level 1,  solar identifier (5 XP/scrap)
+    Hydrojunk  — level 14, hydro identifier (8 XP/scrap)
+    Cosmicjunk — level 27, cosmic identifier (10 XP/scrap)
+    Ecojunk    — level 28, eco identifier (12 XP/scrap)
+    Chaosjunk  — level 35, chaos identifier (11 XP/scrap)
+    Biojunk    — level 44, bio identifier (16 XP/scrap)
+    Naturejunk — level 44, nature identifier (16 XP/scrap)
+    Lawjunk    — level 54, law identifier (18 XP/scrap)
+    Deathjunk  — level 65, death identifier (22 XP/scrap)
+    Bloodjunk  — level 77, blood identifier (28 XP/scrap)
+
+  Higher scavenging levels produce more junk per scrap:
+    Solarjunk:  2x at 22, 3x at 44, 4x at 66, 5x at 88, 6x at 99
+    Hydrojunk:  2x at 36, 3x at 66, 4x at 88
+    Cosmicjunk: 2x at 56, 3x at 78
+    Ecojunk:    2x at 56, 3x at 78
+    Chaosjunk:  2x at 66, 3x at 88
+    Biojunk:    2x at 78, 3x at 99
+    Naturejunk: 2x at 78, 3x at 99
+    Lawjunk:    2x at 88
+    Deathjunk:  2x at 99
+    Bloodjunk:  2x at 99
+
+  Scrap metal is not stackable — you can carry 28 per trip
+  (one per inventory slot). Each trip converts all scrap in
+  one tick.