---
type: User Story
title: "US-006: Administer player harvest progression"
description: Let administrators inspect, correct, and reset player crop progression safely through commands.
status: done
---

# US-006: Administer player harvest progression

As a **server administrator**, I want command-based controls for crop progression so that I can inspect players and correct their state safely.

## Acceptance criteria

- [x] Administrative commands require `spigotharvest.admin`, which server operators receive by default.
- [x] Administrative player arguments safely resolve online players and previously known offline players.
- [x] Player state remains keyed by UUID while retaining the latest known name for lookup and display.
- [x] `/harvestadmin status <player> [crop]` displays the selected player's crop levels, level-local progress, and any active operation.
- [x] `/harvestadmin setlevel <player> <crop> <0|I|II|III|IV|V|VI|VII|VIII|IX|X>` sets that crop's level and resets its level-local progress.
- [x] `/harvestadmin setprogress <player> <crop> <amount>` sets level-local progress and consistently evaluates any reached levels, carrying excess progress forward.
- [x] `/harvestadmin reset <player> <crop>` resets only the selected crop to Level 0 with zero progress.
- [x] `/harvestadmin reset <player> all confirm` resets all crop progression only after explicit confirmation.
- [x] A reset or level reduction cancels the player's active operation when that operation would exceed the resulting entitlement.
- [x] Every successful mutation reports exactly what changed.
- [x] Invalid requests make no partial changes and provide friendly usage guidance.
- [x] Permission-aware autocomplete offers subcommands, online and known offline players, supported crops, valid levels, and reset confirmation.

## Related

- [US-005: View crop progress and notifications](us-005-view-crop-progress-and-notifications.md)
- [US-007: Configure and persist harvesting behavior](us-007-configure-and-persist-harvesting-behavior.md)