[SYXS] Multi-Server Warp

SYXS Multi-Server

Seamlessly connect multiple Hytale server instances with simple in-game commands

📖 Overview

SYXS Multi-Server is a lightweight infrastructure plugin for Hytale server networks. It enables players to navigate between different server instances (Hub, Factions, PvP, Minigames, etc.) using simple chat commands, without requiring complex proxy solutions like BungeeCord or Velocity.

Perfect for server administrators running multiple game modes on the same host or network, this plugin provides instant server switching with a professional, customizable player experience.

✨ Key Features

🌐 Multi-Server Navigation

Instant Server Switching: Players move between servers without disconnecting or manually entering IPs

Customizable Commands: Define unlimited custom commands (e.g., /hub, /factions, /pvp) in the configuration

Configurable Countdown: Set teleport delays per command for dramatic effect or instant transfers

Permission-Based Access: Control which players can access specific servers using your permission plugin

🎨 Professional User Experience

Customizable Messages: Full control over teleport titles and subtitles with placeholder support

Modern Hex Colors: Beautiful, professional message formatting with custom color schemes

Smooth Transitions: Visual countdown displays during server transfers

Clear Feedback: Players receive informative messages about transfer status

🔧 Easy Configuration

JSON-Based Config: Simple, human-readable configuration file

Hot Reload: Apply configuration changes instantly with /multiserver reload - no server restart required

Placeholder System: Dynamic message content with {server}, {countdown}, {host}, {port}

Auto-Generation: Configuration file created automatically on first launch

🛡️ Robust & Reliable

Native Protocol: Uses Hytale's official QUIC/UDP server transfer API

No External Dependencies: Works standalone without proxy software

Network-Wide Consistency: Compatible with permission managers like EtherealPerms

Fail-Safe Design: Graceful error handling with clear admin feedback

🎮 Commands

Command Description Permission

/multiserver reload Reload plugin configuration syxs.multiserver.admin

/ms reload Short alias for reload syxs.multiserver.admin

Custom Commands Defined in config.json Configurable per command

Default Server Commands (Customizable):

/hub - Redirects to Hub server

/factions - Redirects to Factions server

/pvp - Redirects to PvP server

⚙️ Configuration

The plugin generates mods/syxs-multiserver/config.json on first launch. The console will display the full path to your configuration file.

Example Configuration:

{ "teleportTitle": "Transferring to {server}", "teleportSubtitle": "Please wait {countdown} seconds", "servers": [ { "host": "play.yourserver.com", "port": 25565, "command": "hub", "description": "Redirects you to the Hub server", "permission": "syxs.multiserver.hub", "countdown": 3 }, { "host": "play.yourserver.com", "port": 25566, "command": "factions", "description": "Redirects you to the Factions server", "permission": "syxs.multiserver.factions", "countdown": 5 }, { "host": "play.yourserver.com", "port": 25567, "command": "pvp", "description": "Redirects you to the PvP server", "permission": "syxs.multiserver.pvp", "countdown": 5 } ] } Configuration Options:

Field Type Description

teleportTitle String Main title shown during transfer (supports placeholders)

teleportSubtitle String Subtitle shown during transfer (supports placeholders)

servers Array List of server configurations

host String Target server hostname or IP

port Integer Target server port

command String In-game command name (without /)

description String Command description shown in help

permission String Required permission node

countdown Integer Transfer delay in seconds

Supported Placeholders:

{server} - Server command name

{countdown} - Countdown duration in seconds

{host} - Target server host

{port} - Target server port

📥 Installation

Stop all server instances in your network

Download the latest .jar file from CurseForge

Place the file in the mods folder of each server instance

Start the servers to generate configuration files

Check console logs for the full path to config.json

Edit configuration to match your server setup: Update host to your server address

Set correct port numbers for each instance

Customize commands, descriptions, and messages

Grant permissions using your permission plugin

Reload configuration in-game with /multiserver reload or /ms reload

Network Setup Example:

Hub Server (Port 5520) ├── mods/syxs-multiserver-1.0.1.jar └── mods/syxs-multiserver/config.json

Factions Server (Port 5521) ├── mods/syxs-multiserver-1.0.1.jar └── mods/syxs-multiserver/config.json

PvP Server (Port 5522) ├── mods/syxs-multiserver-1.0.1.jar └── mods/syxs-multiserver/config.json Important: Each server needs its own configuration file pointing to the other servers in your network.

🔐 Permissions

Grant admin permissions for configuration management:

syxs.multiserver.admin - Allows using /multiserver reload command Configure per-server access permissions in your config file (e.g., syxs.multiserver.hub, syxs.multiserver.pvp).

💡 Use Cases

Multi-Mode Networks: Hub + multiple game modes on one host

Test Environments: Quickly switch between production and testing servers

Event Servers: Temporary event servers accessible via custom commands

Ranked Systems: Different servers for different player ranks

Regional Servers: Geographic server distribution with unified access

🤝 Compatibility

Hytale Version: Latest release (check version compatibility in Files tab)

Permission Plugins: Compatible with EtherealPerms and other permission managers

Server Types: Supports any Hytale server configuration

Network Size: Unlimited servers supported

📜 License

Disclaimer: This project is not affiliated with or endorsed by Hypixel Studios.

🚀 Getting Started

Install the plugin on all servers

Configure server connections

Grant permissions to players

Use /multiserver reload to apply changes

Players use configured commands to switch servers!

Ready to connect your network? Download now and create a seamless multi-server experience!