---
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)