Files
spigot-creeper-fear/design/user-stories/us-006-configure-aura-progression.md
T
dmg 85356c5c8e
Release / release (push) Successful in 2m26s
CI / build (push) Successful in 1m12s
feat(progression): lower default rank I threshold
2026-08-11 15:15:39 -04:00

32 lines
1.7 KiB
Markdown

---
type: User Story
title: "US-006: Configure aura progression"
description: Let administrators safely configure and persist per-rank requirements, multipliers, and feedback.
status: done
---
# US-006: Configure aura progression
As a **server administrator**, I want to configure progression and aura behavior so that it fits my server's balance.
## Acceptance criteria
- [x] Configuration defaults to 25 kills for rank I, 100 kills for each subsequent rank, and the documented six unlocked-rank damage multipliers.
- [x] Rank requirements are positive integers.
- [x] Damage multipliers are finite and non-negative.
- [x] Progress boss-bar duration and player-facing rank messages are configurable.
- [x] `/creeperaura threshold <rank> <points>` validates, applies, and persists the points required to unlock that rank.
- [x] `/creeperaura reload` safely loads externally edited configuration without requiring a server restart.
- [x] Threshold-management and reload commands require documented administrative permissions.
- [x] Invalid configuration is rejected with actionable diagnostics while the last valid configuration remains active.
- [x] Changing requirements never automatically removes an unlocked rank, grants a new rank, or discards current-tier progress.
- [x] After a requirement change, the player's next qualifying kill can grant at most the next rank when its requirement is satisfied.
- [x] Rank advancement resets current-tier progress to zero rather than carrying excess progress forward.
- [x] Configuration-command changes survive plugin and server restarts.
## Related
- [Creeper Aura ranks](us-002-unlock-creeper-aura-ranks.md)
- [Administer player progression](us-005-administer-player-progression.md)
- [User-story catalog](index.md)