GlymeraPortalDoors - Doors That Teleport

Requires Hytale 0.6.0 or newer (since v5.0.0). For 0.5.x servers use v4.0.0.

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.

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 (e.g. 2x Wood Lightwood Softwood for the Crude variant)
- + 15x Life Essence

The category craftingEnabled toggle in the config allows server owners to disable the recipe entirely.

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:

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

All /gpd commands are operator-only (enforced since v6.0.0; up to v5.0.0 any player could run them). They exist for visual fine-tuning; the built-in defaults are already correct. Tuned values apply live to every door on the server but are not saved - a restart returns to the defaults. width/height/cols/rows are stored but have no visual effect yet.

Configuration

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

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.

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, plus a fallback position from the previous scan to catch fast runners.
• Slow tick (1.5 s): particle respawn and rotation refresh per door. Reads the block's actual rotation index and corrects door.yaw if it drifted.
• Teleport guard: per-player 3-second cooldown, cleared via last-position scrub to prevent double-triggers.

Scaling: 100 players x 100 paired doors is still well under 1 ms of CPU per second.

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 when IsDoor=false

Installation

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

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.

Made with care by Glymera for the Hytale community