spigot-trigger-spawn/design/user-stories/us-001-earn-progressive-spawn-access.md

type, title, description, status

type	title	description	status
User Story	US-001: Earn progressive spawn access	Let players unlock spawn teleportation and improve its cooldown by defeating dangerous enemies.	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

• 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-004: Grant and remove spawn access
• US-005: Ban and unban spawn access
• US-008: Reward and encourage spawn progression