---
type: User Story
title: "US-002: Unlock crop auto-harvest levels"
description: Let players earn ten independently configured auto-harvest levels for every supported crop.
status: done
---

# US-002: Unlock crop auto-harvest levels

As a **player**, I want increasingly large auto-harvest limits as I gain experience with a crop so that repeated farming becomes progressively more efficient.

## Acceptance criteria

- [x] Every supported crop has independent levels from Level 0 through Level X.
- [x] Level 0 provides normal harvesting without connected auto-harvest.
- [x] Progress toward a level is incremental and resets to zero when that level is earned.
- [x] Excess progress from a single progression update carries into the next level rather than being discarded.
- [x] The default Level 0 to I requirement is 100 mature crops and Level I permits an operation containing at most 4 crops.
- [x] The default Level I to II requirement is 400 mature crops and Level II permits at most 8 crops.
- [x] The default Level II to III requirement is 800 mature crops and Level III permits at most 16 crops.
- [x] The default Level III to IV requirement is 1,600 mature crops and Level IV permits at most 32 crops.
- [x] The default Level IV to V requirement is 3,200 mature crops and Level V permits at most 64 crops.
- [x] The default Level V to VI requirement is 12,800 mature crops and Level VI permits at most 128 crops.
- [x] The default Level VI to VII requirement is 25,600 mature crops and Level VII permits at most 256 crops.
- [x] The default Level VII to VIII requirement is 51,200 mature crops and Level VIII permits at most 512 crops.
- [x] The default Level VIII to IX requirement is 153,600 mature crops and Level IX permits at most 1,024 crops.
- [x] The default Level IX to X requirement is 409,600 mature crops and Level X permits at most 2,048 crops.
- [x] Each requirement and operation cap can be configured independently without changing another crop's earned player state.
- [x] An auto-harvest operation uses the cap held when the operation starts; unlocking a level during that operation does not enlarge the operation already in progress.
- [x] Reaching Level X stops further level progression without preventing harvesting or status display.

## Related

- [US-001: Track crop harvesting progression](us-001-track-crop-harvesting-progression.md)
- [US-003: Harvest connected mature crops](us-003-harvest-connected-mature-crops.md)
- [US-005: View crop progress and notifications](us-005-view-crop-progress-and-notifications.md)