36 lines
2.5 KiB
Markdown
36 lines
2.5 KiB
Markdown
---
|
|
type: User Story
|
|
title: "US-003: Harvest connected mature crops"
|
|
description: Animate bounded harvesting across connected mature crops when a player performs a normal crop break.
|
|
status: done
|
|
---
|
|
|
|
# US-003: Harvest connected mature crops
|
|
|
|
As a **player**, I want one normal crop break to harvest a connected area at a visible pace so that unlocked farming feels powerful and satisfying without harming server performance.
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] Normally breaking a fully grown supported crop starts auto-harvest when the player has at least Level I for that crop.
|
|
- [x] Breaking while sneaking performs normal single-crop harvesting and never starts auto-harvest.
|
|
- [x] The manually broken triggering crop is included in the operation's maximum crop count, so Level I processes the trigger plus no more than three connected crops.
|
|
- [x] Auto-harvest traverses only fully grown crops of the same type as the triggering crop.
|
|
- [x] A crop is connected when its horizontal position touches the current crop in any of the eight directions and its Y coordinate differs from the current crop by no more than one block.
|
|
- [x] Connectivity is evaluated per link, allowing a connected operation to follow gradual rises and drops.
|
|
- [x] Traversal is deterministic and never processes the same block more than once in an operation.
|
|
- [x] The operation stops when it reaches the player's crop-level cap or no eligible connected crop remains.
|
|
- [x] Auto-harvest processes a configurable number of crops per server tick, defaulting to one.
|
|
- [x] A player can have no more than one active auto-harvest operation at a time.
|
|
- [x] A normal crop broken while that player already has an active operation is harvested normally and may contribute progress, but it does not start or join another operation.
|
|
- [x] Auto-harvest does not force-load chunks or continue into unloaded chunks.
|
|
- [x] A crop that is no longer mature or matching when its turn arrives is skipped safely.
|
|
- [x] Crop breaks denied by the server or another protection plugin are left unchanged, yield no drops, and contribute no progress.
|
|
- [x] An operation ends safely when exhausted, cancelled, the player disconnects, or the plugin disables.
|
|
- [x] Separate players may run independent auto-harvest operations concurrently.
|
|
|
|
## Related
|
|
|
|
- [US-002: Unlock crop auto-harvest levels](us-002-unlock-crop-auto-harvest-levels.md)
|
|
- [US-004: Replant crops and distribute drops](us-004-replant-crops-and-distribute-drops.md)
|
|
- [US-007: Configure and persist harvesting behavior](us-007-configure-and-persist-harvesting-behavior.md)
|