Eros Server Handler

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?

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

🔹 What Does It Do?

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

🔹 How It Works

1. Player connects to main entry server (usually the lobby).

2. Player uses a server jump command (e.g., /vanilla).

3. Current server sends a referral directly to the target server, including the shared secret.

Target server validates:

1. 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

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