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!

[SYXS] Multi-Server Warp