2.7 KiB
2.7 KiB
type, title, description, status
| type | title | description | status |
|---|---|---|---|
| User Story | US-002: Teleport safely to spawn | Let eligible players teleport to a safe randomized location in their current world's spawn area after a stationary warm-up. | done |
US-002: Teleport safely to spawn
As an eligible player, I want /spawn to take me safely to my current world's spawn area so that I can return without exposing myself to an unsafe destination.
Acceptance criteria
/spawnis available after at least one qualifying unique enemy kill or an administrative grant.- A player without access receives a message instructing them to defeat a Warden, Ender Dragon, or Wither and sees the colored progress checklist.
- A banned player cannot begin a spawn teleport.
- When an active cooldown prevents
/spawn, the player is explicitly told that the command is unavailable and sees the remaining wait in a friendly duration format. - Cooldowns use real elapsed time and therefore continue while the player is offline.
- An accepted teleport request starts a three-second on-screen countdown.
- The player may look around during the countdown without cancelling it.
- A change to the player's block X, Y, or Z coordinate cancels the countdown, including walking to another block, jumping, or falling.
- Teleportation or a world change during the countdown cancels it.
- The destination is sampled randomly within the circular spawn area configured for the player's current world.
- The destination provides non-hazardous solid ground, two blocks of clear headroom, and no immediate lava, fire, water, void, or other configured environmental hazard.
- Unsafe underwater, leaf-top, inaccessible Nether-roof, and void-exposed destinations are rejected.
- The safe search prefers a valid vertical position closest to the configured spawn center's elevation rather than automatically preferring the world's highest surface.
- The safe-location search uses a bounded number of attempts and reports failure clearly when no destination is found.
- Only a completed teleport starts the applicable cooldown.
- After a completed teleport, a player with unfinished boss progression is reminded that defeating each remaining unique boss permanently reduces the cooldown.
- A cancelled countdown or failed safe-location search does not consume the cooldown.