31 lines
2.0 KiB
Markdown
31 lines
2.0 KiB
Markdown
---
|
|
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)
|