Files
spigot-harvest/design/user-stories/us-001-track-crop-harvesting-progression.md
dmg d35c0197f5
Release / release (push) Successful in 4m14s
CI / build (push) Successful in 53s
docs(design): complete initial harvest stories
2026-08-14 18:27:09 -04:00

28 lines
1.5 KiB
Markdown

---
type: User Story
title: "US-001: Track crop harvesting progression"
description: Track qualifying harvest activity independently for each player and supported crop.
status: done
---
# US-001: Track crop harvesting progression
As a **player**, I want my mature crop harvests tracked separately by crop so that my experience with each crop unlocks its own harvesting benefits.
## Acceptance criteria
- [x] Initial progression paths exist independently for wheat, carrots, potatoes, and beetroot.
- [x] A crop contributes progress only when it is fully grown at the time a player harvests it.
- [x] Only crops harvested by a player in Survival mode contribute progress by default.
- [x] A manually broken mature crop contributes one unit to its matching crop path.
- [x] Each mature crop collected by an auto-harvest operation contributes one unit to the player who started that operation.
- [x] Sneaking prevents a manual break from starting auto-harvest but does not prevent the mature triggering crop from contributing progress.
- [x] Immature crops, unsupported crops, and non-harvest block changes do not contribute progress.
- [x] Progress is associated with the player's UUID and survives reconnects and server restarts.
## Related
- [US-002: Unlock crop auto-harvest levels](us-002-unlock-crop-auto-harvest-levels.md)
- [US-003: Harvest connected mature crops](us-003-harvest-connected-mature-crops.md)
- [US-007: Configure and persist harvesting behavior](us-007-configure-and-persist-harvesting-behavior.md)