3.6 KiB
3.6 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.
- Non-player living mobs entering an active entrance portal are teleported into that Pocket Base.
- Portal cooldown handling prevents transported mobs from immediately bouncing back.
- Items, projectiles, vehicles, and other non-living entities are not transported.
- 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.
- Non-player living mobs entering the active, intact return portal are teleported safely outside the normal-world entrance.
- Mob return travel falls back safely to the server spawn when the owner has no valid normal-world 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.
- Portal and void-return travel clears accumulated fall distance so players do not take carried-over fall damage after landing at the destination.
- 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.
- A separate active gold-block portal inside an owner's Pocket Base can grant temporary controlled flight after raid-earned flight is unlocked.