Files
spigot-base/design/user-stories/us-021-unlock-pocket-base-flight.md
T

38 lines
2.4 KiB
Markdown

---
type: User Story
title: "US-021: Unlock Pocket Base flight"
description: Let a Pocket Base owner permanently earn controlled flight by winning a raid in their own pocket world.
status: done
---
# US-021: Unlock Pocket Base flight
As a **Pocket Base owner**, I want to earn flight by completing a raid in my Pocket Base so that I can build and travel safely throughout my expanding pocket world.
## Acceptance criteria
- [x] Pocket Base flight begins locked for new owners and existing saved Pocket Bases.
- [x] A successful raid completed in a Pocket Base permanently unlocks flight only when that Pocket Base's owner is listed among the raid winners.
- [x] Raids completed outside the owner's Pocket Base and raids the owner does not win do not unlock flight.
- [x] Defeated, stopped, expired, and abandoned raids do not unlock flight.
- [x] Unlocking Pocket Base flight is free and does not consume blocks or other currency.
- [x] The owner receives a prominent one-time unlock notification after the qualifying raid.
- [x] In Survival mode, an owner with the unlock receives plugin-granted flight while inside their own Pocket Base.
- [x] Pocket Base flight spans the world's full build height and the current unlocked horizontal boundary plus 16 blocks on every side.
- [x] An actively flying owner receives a warning after leaving the unlocked Pocket Base boundary while remaining inside the 16-block buffer.
- [x] Moving beyond the 16-block buffer removes only flight granted by this plugin.
- [x] Pocket Base expansion automatically expands the corresponding flight area.
- [x] Visitors do not receive the owner's Pocket Base flight privilege.
- [x] Teleportation, world changes, game-mode changes, death, logout, and plugin shutdown do not leave unintended flight enabled.
- [x] The unlock persists across reconnects and restarts.
- [x] Chat status and the native settings dialog show whether Pocket Base flight is locked behind a successful raid or unlocked.
## Related
- [US-004: Unlock and control base flight](us-004-unlock-and-control-base-flight.md)
- [US-009: View progression and unlock notifications](us-009-view-progression-and-notifications.md)
- [US-011: Configure and persist progression](us-011-configure-and-persist-progression.md)
- [US-015: Unlock a Pocket Base](us-015-unlock-a-pocket-base.md)
- [US-017: Expand a Pocket Base](us-017-expand-a-pocket-base.md)
- [US-020: Control a base through a dialog UI](us-020-control-base-through-dialog-ui.md)