40b — Farming cultivation depth

Parent: 40 — Property plots & player farming
Related: 37 — Economic map zones, 38 — Biomes & cultivate, 09 — Crafting, 23 — Harvest.

1. Summary

The own → till → plant → grow → harvest loop uses tools, timed channels, growth-zone soil difficulty, and fallow revert:

2. Plot teardown

Any time a PropertyPlot is removed (sell to crown, upkeep reclaim, admin), the sim:

1. Removes all farm_crops / farm crop resource nodes on the plot.
2. Clears terrain_deltas for cells inside the plot rect when farming.wither_on_reclaim is true.
3. Cancels in-flight cultivate / plant channels targeting those cells.

3. Growth zone fields

On segment growth_zones (Map layout property panel):

Sampling: highest z_order growth zone covering the cell (37).

Cells outside any growth zone:

• cultivate_ticks → property_plots.cultivate_ticks
• cultivate_stamina_mult → 1.0
• fallow_revert_ticks → farming.default_fallow_revert_ticks

ticks   = zone.cultivate_ticks.unwrap_or(settings.property_plots.cultivate_ticks)
stamina = settings.vitals.action_costs.cultivate_stamina * zone.cultivate_stamina_mult

4. Tools

Must be on person (bag or worn). Reject messages are friendly (“You need a hoe to till soil.”).

Craft / vendor:

• Blueprint crude_hoe — lumber + iron ingot + leather strap; Eli teaches and sells hoe (~20 cp).
• Blueprint crude_dibber — lumber + leather strap; Eli teaches and sells dibber (~12 cp).

5. Cultivate channel

1. Player (or worker) starts cultivate on an owned / permitted cell.
2. Terrain shows dirt (tilling in progress), then tilled on complete.
3. Duration / stamina from §3; hoe required.
4. Completing till resets the fallow timer for that cell.

6. Planting channel

Crop defs (assets/crops/crops.yaml, content-admin Crops tab) include:

Player / worker flow:

1. Commit plant intent with a seed type (dibber required).
2. Server picks one nearest free tilled cell; consumes one seed at channel start.
3. On complete: spawn farm crop, keep tilled, reset fallow timer.
4. Duplicate plant while busy is rejected (same pattern as cultivate / harvest).

Example: potato planting_ticks: 150, carrot planting_ticks: 120.

7. Fallow (untilled revert)

Runtime tracks tilled-cell metadata (last_tended_tick, optional plot_id) alongside terrain_deltas.

Each tick (or batched): for each Tilled cell with no farm crop:

revert_ticks = growth_zone.fallow_revert_ticks or farming.default_fallow_revert_ticks
if tick - last_tended_tick >= revert_ticks:
  clear terrain delta; drop meta

Do not revert in-progress Dirt. Reset last_tended_tick on: cultivate complete, plant complete, harvest complete (cell stays tilled).

8. Growth & harvest

base_ticks_to_mature = crop.grow_ticks
fertility = growth_zone_at(cell).fertility or 1.0
biome_mult / weather_mult (default 1.0 until weather layers apply)

progress advances each tick toward 1.0
sprite_mode: grow_10 → grow_20 → grow_60 → grow_100

At grow_100, the crop is a harvestable resource node. Yield comes from the crop’s loot table (produce + chance of seeds). Cell remains tilled for replant.

9. Content surfaces

10. Non-goals

• Multi-cell single-ack batch plant (sequential channels are the loop)
• Sickle/scythe harvest tool gates (extend tool_kind later if needed)
• Particle growth VFX beyond sprite modes