Portals

Portals mod (Fabric 1.21.1)

• Adds server-driven portals that instantly move entities between dimensions while preserving momentum. Portals are plane-based (width/height) and teleport everything that crosses them (players, items, boats, minecarts, mobs), with chunk tickets to keep destinations loaded for smoother handoff.
• Provides admin commands under /portals to create, list, toggle, remove portals, reload config, toggle the debug overlay, and hand out a portal gun. Creation uses the executing player's facing as the source orientation and accepts target dimension/coordinates plus optional width/height/rotation and bidirectional pairing.
• Portal gun item lets players place two anchors (right-click a block or air); the second click links a paired portal set using default config sizes. The item includes a custom texture and is registered server-side.
• Debug overlay (toggled via /portals debug) shows nearby portal info in the action bar; per-dimension rendering toggles and render distance/resolution flags live in config/portals.json alongside portal gun enablement and default portal sizes.

Commands

• /portals list — show all portals with source/target dimensions.
• /portals create <name> <dim> <x y z> [width height rotation bidirectional] — create a portal (optionally paired) using the caller's location and facing as the source.
• /portals remove <name> — delete a portal.
• /portals enable <name> <true|false> — toggle a portal.
• /portals givegun — give yourself the portal gun.
• /portals reloadconfig — reload config/portals.json values.
• /portals debug — toggle the action-bar debug overlay for the caller.

Limitations & notes

• Rendering remains vanilla; there is no real-time “see-through” portal view. Travel is instant teleportation with velocity/rotation preservation and chunk preloading to minimize hitching.
• Portals are axis-aligned planes derived from the creator’s facing; irregular shapes and curved portals are not supported.
• Clients do not need extra assets beyond the included portal gun texture, but visual immersion effects (fog blending, shader tricks, multi-portal rendering) are not present.

Server Validation

✅ Server validation passed - The mod was tested on a real Minecraft server and loaded successfully.