36 lines
2.7 KiB
Markdown
36 lines
2.7 KiB
Markdown
---
|
|
type: User Story
|
|
title: "US-010: Administer player progression"
|
|
description: Let administrators inspect and safely modify player progression and live progression settings through commands.
|
|
status: done
|
|
---
|
|
|
|
# US-010: Administer player progression
|
|
|
|
As a **server administrator**, I want command-based progression controls so that I can inspect players, correct state, and tune requirements without an inventory UI.
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] Administrative commands require `spigotbase.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] `/baseadmin status <player>` displays the player's base, counters, earned path levels, active cooldowns, toggles, and visitor settings.
|
|
- [x] `/baseadmin setlevel <player> <path> <level>` sets an earned path level while enforcing or explicitly granting required preceding levels.
|
|
- [x] `/baseadmin setprogress <player> <path> <amount>` updates the selected counter and consistently evaluates reached tiers.
|
|
- [x] `/baseadmin reset <player> <size|flight|warmup|cooldown>` resets a selected path without silently leaving benefits that require it.
|
|
- [x] `/baseadmin reset <player> base` is rejected and directs the administrator to the confirmed complete-reset command.
|
|
- [x] `/baseadmin reset <player> all` removes the player's base, progression, active cooldowns, and plugin preferences after confirmation.
|
|
- [x] Administrators can clear personal and visitor cooldowns independently.
|
|
- [x] Administrative commands can update configured block requirements, warm-ups, and cooldowns for each level using validated values.
|
|
- [x] Runtime configuration changes are persisted for subsequent restarts.
|
|
- [x] Lowered progression requirements are evaluated for a player on their next relevant action rather than immediately updating every stored player.
|
|
- [x] Every successful mutation reports exactly what changed, and invalid requests make no partial changes.
|
|
- [x] `/homeadmin` aliases `/baseadmin` with identical permission requirements and autocomplete.
|
|
- [x] Permission-aware autocomplete offers subcommands, online and known offline players, progression paths, valid levels, progress counters, cooldown types, reset paths and confirmation, and numeric configuration keys.
|
|
- [x] Invalid and extra arguments show friendly usage without exposing implementation-specific enum errors or modifying state.
|
|
|
|
## Related
|
|
|
|
- [US-009: View progression and unlock notifications](us-009-view-progression-and-notifications.md)
|
|
- [US-011: Configure and persist progression](us-011-configure-and-persist-progression.md)
|