Files
spigot-base/design/user-stories/us-022-share-pocket-base-flight-through-a-portal.md
T
dmg ecb07d48ad
Release / release (push) Successful in 5m2s
CI / build (push) Successful in 1m28s
feat(pocket-base): start flying on flight portal entry
2026-09-06 20:52:25 -04:00

2.8 KiB

type, title, description, status
type title description status
User Story US-022: Share Pocket Base flight through a portal Let an owner build a gold-block portal that temporarily grants controlled Pocket Base flight to players who pass through it. done

US-022: Share Pocket Base flight through a portal

As a Pocket Base owner, I want an activated flight portal inside my Pocket Base so that I can temporarily share controlled flight with guests without changing my own default-flight preference.

Acceptance criteria

  • Entering the active flight portal immediately starts eligible Survival players flying without double-jumping.

  • Each portal entry sends “Pocket dimension flight enabled!” without repeated messages while standing in the portal.

  • Immediate takeoff preserves existing flight boundaries and expiry rules, with regression tests.

  • The owner must first unlock Pocket Base flight by winning a raid in their own Pocket Base.

  • Only the owner can activate a complete 4-by-5 gold-block frame with flint and steel as the active flight portal.

  • Every required frame block must be inside the owner's currently unlocked Pocket Base boundary at activation.

  • Each Pocket Base has at most one active flight portal, and activating another valid frame moves the active location without removing the old frame.

  • The active flight portal uses custom particles and collision without vanilla Nether portal blocks.

  • Breaking any required block in the active frame deactivates the flight portal.

  • Any player, including the owner or a guest, who passes through the active intact flight portal receives temporary Pocket Base flight.

  • Portal-granted flight remains independent of the owner's default Pocket Base flight preference.

  • Portal-granted flight spans the world's full build height and the current Pocket Base boundary plus 16 blocks on every side.

  • An actively flying player receives a warning inside the 16-block buffer, and flight ends beyond it.

  • Expanding the Pocket Base automatically expands the portal-granted flight area.

  • Portal-granted flight ends when the player leaves the Pocket Base, dies, disconnects, or changes out of Survival mode.

  • The active flight portal location and owner default-flight preference persist across restarts.

  • Existing saved Pocket Bases default to no flight portal while preserving raid-earned owner flight as enabled.