[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

1. Stop all server instances in your network
2. Download the latest .jar file from CurseForge
3. Place the file in the mods folder of each server instance
4. Start the servers to generate configuration files
5. Check console logs for the full path to config.json
6. 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
7. Grant permissions using your permission plugin
8. 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

1. Install the plugin on all servers
2. Configure server connections
3. Grant permissions to players
4. Use /multiserver reload to apply changes
5. Players use configured commands to switch servers!

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