GlymeraPortalDoors v4.0

GlymeraPortalDoors - Doors That Teleport

Portal variants of all 16 Hytale doors. Pair two doors with a Life Essence in hand, walk through an open one, and teleport to its partner. Each door still opens and closes, with an animated portal-ring effect inside its frame.

Most actual version only working for Hytale stable 5 !

What is GlymeraPortalDoors?

Adds a Portal version of every standard Hytale door (16 in total), craftable alongside the original. Every portal door is a fully functional door that also acts as a teleporter when paired with another portal door of your choice. Walk through one open portal door and you come out of the other, on the side you faced when you placed that door.

A rotating, shimmering portal-ring effect fills the door frame when the door is open, vanishes when it's closed.

How It Works

Crafting
All 16 Portal-Door variants are crafted at the Alchemy Bench, under the Misc tab: The original door's ingredients + 15x Life Essence.

Setting up a Teleport Pair
1. Place two Portal-Doors anywhere in the same world.
2. Take one Life Essence into your hand.
3. Press F (use) on the first door — "Pairing started."
4. Within 60 seconds, press F on the second door — "Portal-Doors paired!"

The doors are now bidirectionally linked. Walking through one open door teleports you to the other.

Using

• F with an empty hand on a portal door: normal open/close
• F with Life Essence on a portal door: start/finish pairing
• Walk through an open paired portal door: teleport to the partner. You arrive on the side the partner's owner was facing when placing the partner door, looking away from it
• Walking through a closed door does nothing (no teleport, no effect)

What's Included

All 16 standard Hytale door variants have a Portal version:

Crude Door, Ancient Wooden Door, Sandswept Door, Feran Door, Frozen Castle Door, Lost Civilization Wooden Door, Bamboo Door, Kweebec Door, Lumberjack Door, Tavern Door, Dark Temple Door, Earth Temple Door, Overgrown Temple Door, Light Temple Door, Wind Temple Door, Simple Wooden Door

Ownership

• The player who places a portal door becomes its owner
• Only the owner (or a server OP) can break the door or change its pairing
• When a door is broken, its partner is automatically unlinked

Commands

/gpd — Show tuning summary (OP)
/gpd pitch / yaw / roll <rad> — Adjust particle rotation in radians (OP)
/gpd scale <float> — Adjust particle scale (OP)
/gpd cy <float> — Adjust vertical centre offset (OP)
/gpd width / height <float> — Grid span, reserved for future layouts (OP)
/gpd cols / rows <int> — Grid count, reserved (OP)
/gpd orient <0-3> — Which Direction axis receives door.yaw (OP)
/gpd show — Print current tuning values (OP)

Tuning commands exist for future visual adjustments; the built-in defaults are already correct.

Configuration

File at plugins/GlymeraPortalDoors/config.json (created on first start):

- craftingEnabled (default: true) — Set to false to discourage crafting (actual recipe is embedded in the asset pack and currently always active)

Persistence

• Door positions, ownership, and pairings are stored in plugins/GlymeraPortalDoors/doors.json
• Server restart: all doors and pairings survive
• Chunk reload: door data is preserved; it is only removed from the registry when the block is confirmed replaced by another block type
• The actual facing direction is read live from the placed block's rotation — if Hytale rotates a door differently than the player's head direction, the particle and the exit position follow the real block rotation

Features

• 16 Portal-Door variants — one for every standard Hytale door
• Native-looking animated portal effect (Hytale's PlayerSpawn_Portal rings, repositioned and reoriented to fit the door frame)
• Effect and teleport only active when the door is open — closing a portal door disables the portal entirely
• Owner-only breaking / pairing — griefing protection built in
• Life Essence as pairing "key" — intuitive, reuses existing Hytale resources
• Bidirectional pairs — paired doors update each other automatically when one is broken or re-paired
• Real block rotation — particle and exit direction follow the actual placed block, not just the player's look vector
• Phantom-block cleanup on break — prevents the invisible residue that 2-block-tall doors can leave behind

Performance

• Fast scan (50 ms): iterates online players and does an O(1) hashmap lookup per player to find a matching portal door. Walk-through detection uses a 3x3x2 cell lookup + radius check
• Slow tick (1.5 s): particle respawn and rotation refresh per door
• Teleport guard: per-player 3-second cooldown to prevent double-triggers
• Scaling: 100 players x 100 paired doors is still well under 1 ms of CPU per second

Good to Know

• Portal-Doors are independent items from the original doors. Both recipes coexist; the original craft still lives at the Builders Bench, the Portal variant lives at the Alchemy Bench
• Each portal door acts as a normal door. Pairing and teleport are additive features
• Walking through a closed portal door does nothing. Players can still open and walk through normally without any teleport side-effects
• The portal-ring effect auto-rotates with the door. If you demolish an old door and place a new one in a different orientation, the effect updates itself within 1.5 seconds
• Pairings are exclusive: pairing a door to a new partner automatically breaks its previous pairing on both sides

Installation

1. Place GlymeraPortalDoors.jar in your server's mods/ folder
2. Start (or restart) the server
3. Done! Everything is embedded in the JAR — no external asset folders needed.

Made with care by Glymera for the Hytale community