Files
spigot-trigger-spawn/design/user-stories/us-001-earn-progressive-spawn-access.md
T
dmg 12d9e7af42
Release / release (push) Failing after 13s
CI / build (push) Successful in 52s
feat(progression): unlock spawn through boss kills
2026-08-08 13:25:42 -04:00

32 lines
1.9 KiB
Markdown

---
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: done
---
# 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
- [x] The plugin observes player-attributed kills of the Warden, Ender Dragon, and Wither.
- [x] Only kills observed while the plugin is operating count; historical statistics and advancements are not imported.
- [x] The three enemies may be killed in any order.
- [x] The first unique qualifying kill unlocks `/spawn` with the configured one-kill cooldown, which defaults to 8 hours.
- [x] The second unique qualifying kill applies the configured two-kill cooldown, which defaults to 4 hours.
- [x] The third unique qualifying kill applies the configured three-kill cooldown, which defaults to 1 hour.
- [x] Repeated kills of an already credited enemy do not improve the player's tier.
- [x] 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.
- [x] Progress is presented as a checklist in which credited enemies have a green check and uncredited enemies have a red cross.
- [x] Each newly credited unique kill immediately clears any active `/spawn` cooldown as a progression reward.
- [x] 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)