feat: farming roughly implemented

7 files changed, 130 insertions, 0 deletions

diff --git a/data/help/cure.yaml b/data/help/cure.yaml
new file mode 100644
index 0000000..3bb7bc3
--- /dev/null
+++ b/data/help/cure.yaml
@@ -0,0 +1,15 @@
+name: "cure"
+category: "Skills"
+description: |
+  Cure a diseased farming patch.
+
+  Usage: cure [patch]
+
+  Requires a plant cure item in your inventory (consumed on use).
+  Diseased plants must be cured before the next growth tick or
+  they will die.
+
+  If no patch is specified, the first diseased patch in the
+  room is targeted.
+
+  See also: help farming, help water, help inspect
diff --git a/data/help/farming.yaml b/data/help/farming.yaml
new file mode 100644
index 0000000..2dd2ff2
--- /dev/null
+++ b/data/help/farming.yaml
@@ -0,0 +1,31 @@
+name: "farming"
+category: "Skills"
+description: |
+  Farming lets you grow herbs and vegetables in patches.
+
+  The basic cycle:
+    1. Rake the patch to clear weeds (requires rake)
+    2. Plant a seed (requires spade, seed in inventory)
+    3. Water the patch to prevent disease (requires watering can)
+    4. Wait for the plant to grow through stages
+    5. Water again at each growth stage for protection
+    6. Harvest the fully grown crop (requires spade)
+
+  Growth happens every ~5 minutes while you are online.
+  Crops do not grow while you are logged off.
+
+  Disease: Each growth stage has a 10% chance of disease unless
+  the patch was watered. Diseased plants can be cured with plant
+  cure. If not cured before the next growth tick, the plant dies
+  and must be raked away.
+
+  Tool shed: Store farming tools to free inventory space.
+  Use 'talk shed' to store or retrieve tools.
+
+  Patches: Herb patches grow herb seeds. Allotment patches grow
+  vegetable seeds. Check 'inspect' for patch status.
+
+  Commands: plant, harvest, rake, water, cure, inspect
+
+  See also: help plant, help harvest, help rake, help water,
+            help cure, help inspect
diff --git a/data/help/harvest.yaml b/data/help/harvest.yaml
new file mode 100644
index 0000000..88fa19e
--- /dev/null
+++ b/data/help/harvest.yaml
@@ -0,0 +1,18 @@
+name: "harvest"
+category: "Skills"
+description: |
+  Harvest a fully grown crop from a farming patch.
+
+  Usage: harvest [patch]
+
+  Requires a spade in your inventory. The crop must be fully
+  grown (check with 'inspect'). Yields a random amount of the
+  crop based on your farming level.
+
+  If no patch is specified, the first harvestable patch in the
+  room is targeted.
+
+  After harvesting, the patch grows weeds and must be raked
+  before replanting.
+
+  See also: help farming, help plant, help inspect
diff --git a/data/help/inspect.yaml b/data/help/inspect.yaml
new file mode 100644
index 0000000..f81dc6b
--- /dev/null
+++ b/data/help/inspect.yaml
@@ -0,0 +1,17 @@
+name: "inspect"
+category: "Skills"
+description: |
+  Check the status of farming patches in the current room.
+
+  Usage: inspect [patch]
+
+  Shows the current state of each farming patch including:
+  - What is planted
+  - Growth stage
+  - Whether it has been watered
+  - Disease status
+  - Whether it is ready to harvest
+
+  If no patch is specified, all patches in the room are shown.
+
+  See also: help farming, help plant, help harvest
diff --git a/data/help/plant.yaml b/data/help/plant.yaml
new file mode 100644
index 0000000..4b807ea
--- /dev/null
+++ b/data/help/plant.yaml
@@ -0,0 +1,16 @@
+name: "plant"
+category: "Skills"
+description: |
+  Plant a seed in a farming patch.
+
+  Usage: plant <seed>
+
+  Requires a spade in your inventory. The seed must match the
+  patch type in the current room (herb seeds go in herb patches,
+  vegetable seeds go in allotment patches).
+
+  The patch must be clear of weeds (use 'rake' first) and empty.
+
+  Planting awards a small amount of farming XP.
+
+  See also: help farming, help harvest, help rake, help water
diff --git a/data/help/rake.yaml b/data/help/rake.yaml
new file mode 100644
index 0000000..bf58da7
--- /dev/null
+++ b/data/help/rake.yaml
@@ -0,0 +1,17 @@
+name: "rake"
+category: "Skills"
+description: |
+  Clear weeds or dead plants from a farming patch.
+
+  Usage: rake [patch]
+
+  Requires a rake in your inventory. Patches start with weeds
+  and regrow weeds after harvesting. Dead plants from disease
+  also need to be raked before replanting.
+
+  Raking awards no farming XP.
+
+  If no patch is specified, the first patch needing raking
+  in the room is targeted.
+
+  See also: help farming, help plant, help water
diff --git a/data/help/water.yaml b/data/help/water.yaml
new file mode 100644
index 0000000..e778eb2
--- /dev/null
+++ b/data/help/water.yaml
@@ -0,0 +1,16 @@
+name: "water"
+category: "Skills"
+description: |
+  Water a farming patch to prevent disease.
+
+  Usage: water [patch]
+
+  Requires a watering can in your inventory. Watering a patch
+  eliminates the disease chance for the current growth stage.
+  You must water each stage separately as the watering resets
+  when the plant grows.
+
+  If no patch is specified, the first unwatered patch with a
+  growing plant is targeted.
+
+  See also: help farming, help plant, help cure