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,22 @@
+---
+type: Log
+title: Trigger Spawn Design Log
+description: Chronological record of significant Trigger Spawn design decisions.
+---
+
+# Trigger Spawn Design Log
+
+## 2026-08-08 — Initial user stories
+
+- Target Spigot 26.2 and Java 17 with a Gradle and Gitea Actions pipeline modeled on `spigot-event-producer`.
+- Unlock `/spawn` after the first observed Warden, Ender Dragon, or Wither kill.
+- Use real elapsed time for cooldowns, with defaults of eight, four, and one hour as unique boss kills accumulate.
+- Support administrator-defined cooldown grants, complete access resets, and bans.
+- Maintain a separate circular spawn area in each world, with a default radius of 20 blocks and safe randomized destinations.
+- Require a stationary three-second warm-up that is cancelled by walking to another block, jumping, falling, teleportation, or world changes.
+
+## 2026-08-08 — Progression reminders and rewards
+
+- Remind players with incomplete progression that remaining unique boss kills permanently reduce the `/spawn` cooldown.
+- Clear the active cooldown immediately after each newly credited unique boss kill.
+- When cooldown prevents `/spawn`, explicitly report that it is unavailable and show the remaining wait in a friendly format.