Files
spigot-base/design/user-stories/us-016-build-and-use-pocket-base-portals.md
T
dmg 4518478ea1
Release / release (push) Successful in 2m39s
CI / build (push) Successful in 1m13s
feat(pocket-base): allow return portal relocation
2026-08-24 10:06:25 -04:00

2.7 KiB

type, title, description, status
type title description status
User Story US-016: Build and use Pocket Base portals Let an owner create one public portal between their normal base and persistent Pocket Base. done

US-016: Build and use Pocket Base portals

As a Pocket Base owner, I want to connect my normal base to my Pocket Base with a public portal so that I and other players can move between them naturally.

Acceptance criteria

  • The entrance uses a standard 4-by-5 outer frame with a 2-by-3 interior and a configurable frame material that defaults to diamond blocks.
  • Only the Pocket Base owner can activate a complete entrance frame with flint and steel.
  • Every required frame block must be within the owner's current normal-base bounds when the entrance is activated.
  • Custom particles and collision provide portal-like visuals and travel without relying on vanilla Nether portal blocks.
  • Each owner has at most one active entrance portal.
  • Activating another valid entrance deactivates the previous entrance without removing its frame blocks.
  • Breaking any required frame block immediately deactivates the entrance.
  • Any player can use an active entrance without a separate visitor setting, warm-up, or cooldown.
  • Visitors can build, break blocks, open containers, and otherwise interact normally inside the Pocket Base.
  • The generated return portal sends players safely to the owner's active entrance.
  • Only the owner can activate a complete portal frame inside their own Pocket Base with flint and steel.
  • Every required return-frame block must be within the owner's unlocked Pocket Base boundary.
  • Each Pocket Base has at most one active return portal, and activating another valid frame moves the active return location without removing the old frame.
  • Relocated return portals persist through restarts, while existing Pocket Bases use the generated portal as their default.
  • Breaking the active return frame disables return travel through it.
  • Return travel falls back to the server spawn when the owner has no valid normal-world entrance.
  • Falling below Y -64 performs the same safe return without void damage.
  • Players who disconnect inside a Pocket Base remain there when they reconnect.
  • Moving the normal base deactivates its entrance while preserving the Pocket Base world and its contents.
  • Portal ownership and the active entrance location persist through restarts.