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.

Don't miss my other exciting projects — take a look at GlymeraCraft's Profile Discord: https://discord.gg/s5NRFWfxgy

What is GlymeraPortalDoors?

Adds a Portal version of every standard Hytale door (16 in total), craftable alongside the original. Every portaltür is a fully functional door that also acts as a teleporter when paired with another portaltür of your choice. Walk through one open portaltür 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

Place two Portal-Doors anywhere in the same world.
Take one Life Essence into your hand.
Press F (use) on the first door → "Pairing started."
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 portaltür: normal open/close.
F with Life Essence on a portaltür: start/finish pairing.
Walk through an open paired portaltür: 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:

Door Type	Portal Variant
Crude Door	Crude Door (Portal)
Ancient Wooden Door	Ancient Wooden Door (Portal)
Sandswept Door	Sandswept Door (Portal)
Feran Door	Feran Door (Portal)
Frozen Castle Door	Frozen Castle Door (Portal)
Lost Civilization Wooden Door	Lost Civilization Wooden Door (Portal)
Bamboo Door	Bamboo Door (Portal)
Kweebec Door	Kweebec Door (Portal)
Lumberjack Door	Lumberjack Door (Portal)
Tavern Door	Tavern Door (Portal)
Dark Temple Door	Dark Temple Door (Portal)
Earth Temple Door	Earth Temple Door (Portal)
Overgrown Temple Door	Overgrown Temple Door (Portal)
Light Temple Door	Light Temple Door (Portal)
Wind Temple Door	Wind Temple Door (Portal)
Simple Wooden Door	Simple Wooden Door (Portal)

Ownership

The player who places a portaltür 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

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

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

Configuration

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

Setting	Default	Description
`craftingEnabled`	`true`	Informational: 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.

Performance

Fast scan (50 ms): iterates online players and does an O(1) hashmap lookup per player to find a matching portaltür. 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 portaltür 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

Place GlymeraPortalDoors-1.0.0.jar in your server's mods/ folder.
Start (or restart) the server.
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 portaltür acts as a normal door. Pairing and teleport are additive features.
Walking through a closed portaltür 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