Eros Server Handler is a native, BungeeCord-style alternative for Hytale, allowing secure direct server-to-server transfers without any external proxy.
Backend servers remain fully protected while all routing and referral checks are enforced.

🔹 Why Use Eros Server Handler?

Unlike proxy-based solutions (like BungeeCord in Minecraft):
Runs inside Hytale servers – fully native, no middleman.
Secure by design – trusted server validation + shared secret authentication.
Direct server-to-server routing – no forced lobby hop.
Protected backend servers – direct joins always rejected.
Simple architecture – one network, multiple servers.
Low overhead – leverages Hytale’s native referral system.

🔹 What Does It Do?

Runs a multi-server Hytale network without a proxy.
Players move directly between servers (vanilla, sb, minigames) via secure referrals.
Backend servers stay inaccessible from outside.
True BungeeCord-style functionality without proxy infrastructure.

🔹 How It Works

Player connects to main entry server (usually the lobby).
Player uses a server jump command (e.g., /vanilla).
Current server sends a referral directly to the target server, including the shared secret.

Target server validates:

Connection is a referral

Referral source is a trusted server
Shared secret is correct = Player is allowed to join.
Failed validation = immediate disconnect.

🔹 Server Roles

Lobby Server

Accepts direct connections
Main public entry point
Can redirect players to backend servers

Backend Servers

Reject all direct connections
Accept only server-to-server referrals
Validate trusted source + shared secret

All servers can register & use server jump commands.

🔹 V4 Config Overview

server:
name: lobby
secretKey: CHANGE_ME_NOW
fallbackToLobby: false

trustedSource:
host: 127.0.0.1
port: 5520

servers:
- name: lobby
host: 127.0.0.1
port: 5520
- name: vanilla
host: 127.0.0.1
port: 5521

Config Details

server.name → unique name per server (lobby / backend)
server.secretKey → shared secret for all server-to-server transfers (must match on all servers)
server.fallbackToLobby → new in V4, redirects invalid direct joins to lobby on non-lobby servers
trustedSource → main entry server, used for fallback only
servers → internal whitelist, must be identical across all servers, includes lobby + all backend

⚠ Important: Always restart server after any config change. Reloading is not supported.

🔹 Security Model

Trusted Server Validation → only known internal servers can refer players.
Shared Secret Authentication → prevents spoofed or forged referrals.
Both must pass for a player to join any backend server.

🔹 Commands

/lobby → sends player to the lobby server
server commands → connect players directly to target servers, e.g.:
/vanilla
/sb
/minigames

🔹 Philosophy

One network, trusted servers only, zero direct backend access
Designed to keep your Hytale network secure, simple, and fully native

🔹 Use Cases

Multi-server Hytale networks
Direct server-to-server routing
Secure backend servers
Proxy-less architectures
BungeeCord-style setups for Hytale

────────────────────────────

Discord for Questions / Support:

Eros Development