docs(design): define creeper aura plugin

2026-08-08 13:44:14 -04:00
commit f9ad2d9461
10 changed files with 250 additions and 0 deletions
@@ -0,0 +1,25 @@
+---
+type: User Story
+title: "US-001: Track creeper defeats"
+description: Record persistent player progress from creeper kills attributable to the player.
+status: backlog
+---
+
+# US-001: Track creeper defeats
+
+As a **player**, I want my qualifying creeper kills recorded so that my Creeper Aura progression persists.
+
+## Acceptance criteria
+
+- [ ] A creeper kill attributable to a player adds one kill to that player's lifetime progress.
+- [ ] Direct melee kills and indirect kills attributable to the player, including projectiles and the player's tamed wolves, count.
+- [ ] A single creeper death cannot award progress more than once.
+- [ ] Progress is stored using the player's UUID rather than their mutable name.
+- [ ] Progress survives logout, server restarts, and player-name changes.
+- [ ] Progress updates are persisted without blocking the Minecraft server thread on slow storage work.
+- [ ] Missing or invalid persisted data is handled safely and reported to server administrators.
+
+## Related
+
+- [Creeper Aura ranks](us-002-unlock-creeper-aura-ranks.md)
+- [User-story catalog](index.md)