Files
spigot-base/design/user-stories/us-005-unlock-base-teleportation.md
dmg 28dd5422d5
Release / release (push) Successful in 2m56s
CI / build (push) Successful in 1m35s
feat(teleport): add warmup particles and fading departure clouds
2026-09-06 21:11:24 -04:00

2.3 KiB

type, title, description, status
type title description status
User Story US-005: Unlock Base III teleportation Let players earn a safe, stationary-warm-up teleport to their personal base. done

US-005: Unlock Base III teleportation

As a player with Base II, I want to earn /base so that I can return safely to my established base.

Acceptance criteria

  • Warm-up particles float around the player, are visible nearby, and grow denser with warm-up progress.

  • Successful warmed-up teleports leave a departure cloud that thins out over two seconds.

  • Cancellation stops particle emission and failed teleports create no departure cloud.

  • Particle effects are bounded, cleaned up on shutdown, and regression-tested without changing teleport timing, safety, or cooldowns.

  • Base III requires Base II, an established base, and a configurable 200 qualifying block placements inside the base.

  • Only placements made in Survival mode and within the base's current horizontal and vertical bounds count.

  • Player-placed blocks and replacement of previously broken blocks may contribute repeatedly.

  • Base III unlocks /base with a configurable 30-second warm-up and three-hour cooldown by default.

  • /home aliases the teleport-only /base command.

  • Looking around without changing block coordinates does not cancel the warm-up.

  • Changing block X, Y, or Z, taking damage, teleporting, changing worlds, dying, disconnecting, or starting a conflicting teleport cancels the warm-up.

  • Cancellation clearly informs the player and does not consume the cooldown.

  • The destination is a safe standing location at or near the recorded base center.

  • An unavailable or unsafe destination is reported clearly and does not consume the cooldown.

  • Only a completed teleport starts the cooldown.

  • Cooldowns use real elapsed time and continue while the player is offline.