Server Teleporters

Cross-Server Teleporter Plugin

A Hytale plugin that enables seamless cross-server teleportation using the game's native teleporter and warp systems.

Features

Cross-Server Teleportation

Transfer players between multiple Hytale servers using in-game teleporters

Works with Hytale's native teleporter blocks and warp system

Automatic player spawning at designated locations on the target server

Simple Command Interface

Short, easy-to-remember commands

List, create, and remove warps and spawn locations

Persistent Storage

Cross-server warp data stored in crossserver_warps.json

Survives server restarts

Separate from Hytale's warps.json to avoid conflicts

Native Integration

Uses Hytale's built-in teleporter blocks

Configure destinations through the normal teleporter UI

No custom blocks or complex setup required

Commands

Cross-Server Warps

Register a cross-server warp

/csw <warpName> <targetServer> <teleporterId> Remove a cross-server warp

/delcsw <warpName> List all cross-server warps

/listcsw Teleporter Spawn Locations

Set spawn location at current position

/settp <teleporterId> Remove a spawn location

/deltp <teleporterId> List all spawn locations

/listtp How It Works

Step 1: Register a Cross-Server Warp

On the source server, create a warp that will redirect players:

/csw hubWarp localhost:25565 spawn1 This creates a warp named hubWarp that transfers players to localhost:25565 and spawns them at teleporter ID spawn1.

Step 2: Set Spawn Location

On the target server, stand where you want players to spawn and run:

/settp spawn1 Step 3: Configure Teleporter

Place a teleporter block in-game, right-click to configure it, and select the hubWarp warp from the list.

Step 4: Use the Teleporter

When a player walks through the configured teleporter, they will:

Be transferred to the target server

Spawn at the registered teleporter location

Technical Details

Position-Based Warp Matching

Current implementation is very hacky due to not being able to access a portals destination warp name when the player walks through (working on this)

Each cross-server warp is assigned unique coordinates (e.g., 10000, 100, 10000)

The system intercepts teleport events and matches destination coordinates

If a match is found in the cross-server registry, the transfer is triggered

ECS System Integration

CrossServerTeleportInterceptor - RefChangeSystem that intercepts Teleport component additions

Modifies teleport destination to prevent unwanted movement

Calls PlayerRef.referToServer() to initiate cross-server transfer

Data Storage

The plugin stores cross-server warp data in universe/crossserver_warps.json:

{ "warps": { "hubwarp": { "targetServer": "localhost:25565", "teleporterId": "spawn1" } } }

Copy jar file to your Hytale server's mods/ folder

Restart the server

Configure cross-server warps using the commands above

Use Cases

Server Networks Connect multiple game servers (lobby to minigames to survival)

Instance-Based Content Transfer players to dedicated servers for dungeons/raids

Load Balancing Distribute players across multiple servers

Regional Servers Connect servers in different geographic locations

Security Considerations

Important: This plugin is currently in development and has no built-in security features. Most of these are currently being worked on

Any server can send players to any other server

No authentication between servers

Referral data is not encrypted or validated

Commands are not permission based