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,27 @@
+---
+type: User Story
+title: "US-005: Ban and unban spawn access"
+description: Let administrators prevent selected players from using or reacquiring spawn teleportation until unbanned.
+status: backlog
+---
+
+# US-005: Ban and unban spawn access
+
+As a **server administrator**, I want to ban and unban players from spawn teleportation so that access can be withheld regardless of progression or grants.
+
+## Acceptance criteria
+
+- [ ] `/spawnadmin ban <player>` immediately prevents the player from using `/spawn`.
+- [ ] Banning a player clears their administrative grant, enemy progress, and active cooldown.
+- [ ] Qualifying kills made while banned are not recorded.
+- [ ] A banned player cannot receive an administrative grant until unbanned.
+- [ ] `/spawnadmin bans [page]` displays a paginated list of banned players, including offline players.
+- [ ] `/spawnadmin unban <player>` removes the ban without restoring any prior grant, enemy progress, or cooldown.
+- [ ] An unbanned player begins with no access and can earn access again by defeating a qualifying enemy or receiving a new grant.
+- [ ] Ban and unban commands support online players and previously known offline players when they can be resolved safely.
+- [ ] Ban state is associated with player UUIDs and survives server and plugin restarts.
+
+## Related
+
+- [US-001: Earn progressive spawn access](us-001-earn-progressive-spawn-access.md)
+- [US-004: Grant and remove spawn access](us-004-manage-spawn-access.md)