docs(design): define spawn plugin user stories

2026-08-08 13:03:11 -04:00
commit a01f36db86
11 changed files with 291 additions and 0 deletions
@@ -0,0 +1,31 @@
+---
+type: User Story
+title: "US-001: Earn progressive spawn access"
+description: Let players unlock spawn teleportation and improve its cooldown by defeating dangerous enemies.
+status: backlog
+---
+
+# US-001: Earn progressive spawn access
+
+As a **player**, I want to unlock `/spawn` by defeating major enemies so that my progression earns increasingly convenient access to spawn.
+
+## Acceptance criteria
+
+- [ ] The plugin observes player-attributed kills of the Warden, Ender Dragon, and Wither.
+- [ ] Only kills observed while the plugin is operating count; historical statistics and advancements are not imported.
+- [ ] The three enemies may be killed in any order.
+- [ ] The first unique qualifying kill unlocks `/spawn` with the configured one-kill cooldown, which defaults to 8 hours.
+- [ ] The second unique qualifying kill applies the configured two-kill cooldown, which defaults to 4 hours.
+- [ ] The third unique qualifying kill applies the configured three-kill cooldown, which defaults to 1 hour.
+- [ ] Repeated kills of an already credited enemy do not improve the player's tier.
+- [ ] Each newly credited kill displays an on-screen message stating that `/spawn` has been unlocked or updated, is immediately available, and has the shown applicable cooldown.
+- [ ] Progress is presented as a checklist in which credited enemies have a green check and uncredited enemies have a red cross.
+- [ ] Each newly credited unique kill immediately clears any active `/spawn` cooldown as a progression reward.
+- [ ] Progress is associated with the player's UUID and survives server and plugin restarts.
+
+## Related
+
+- [US-002: Teleport safely to spawn](us-002-teleport-safely-to-spawn.md)
+- [US-004: Grant and remove spawn access](us-004-manage-spawn-access.md)
+- [US-005: Ban and unban spawn access](us-005-manage-spawn-bans.md)
+- [US-008: Reward and encourage spawn progression](us-008-reward-spawn-progression.md)