ServerRouter — Multi-Server Network Suite for Hytale
ServerRouter connects multiple Hytale servers into one unified network.
Move players using commands or portals, synchronize chat, events and inventories, display live server status, expose network data through API and scoreboard placeholders, and show players from every connected server in the native network-wide player list.
Create any network structure you need: hubs, survival worlds, dungeons, PvP servers, minigames, creative servers, event servers or custom game modes.
Routes, commands, server names, permissions, messages and optional modules are fully configurable.
Main Features
See ServerRouter in Action
ServerRouter is used on HyTari for commands, portals, live status, network chat, network events, scoreboard data, the network player list and shared inventories.
Server IP: play.HyTari.it
Server Routing
Create custom routes such as:
Every route can define its own:
Before transferring a player, ServerRouter checks whether the destination is:
If the destination is unavailable, the player remains safely on the current server.
Portal Routing & Automatic Portal Generation
Routes can be connected to portal items placed directly in the game world.
ServerRouter can automatically generate a matching portal item for every configured route, making it easy to create hub selectors, dungeon entrances, PvP portals, minigame portals and other travel areas.
Generated assets are stored externally inside:
This provides several advantages:
Note: Newly generated portal items may require one additional server restart before appearing in the creative inventory.
Secure Transfers & Portal Safety
ServerRouter includes built-in protection for smooth and reliable transfers:
If an old portal still exists after its route has been removed, it will not crash the server. The player receives a configurable missing-destination message instead.
Network Player List
The optional
It supports:
Example:
Server abbreviations and the displayed format can be customized independently for each network.
Shared Inventory
ServerRouter includes an optional built-in inventory synchronization module.
When enabled, players can keep the same inventory while moving between connected servers.
The module includes:
The module uses ServerRouter’s existing database and
Important: Do not enable the integrated inventory module while running another standalone inventory synchronization plugin.
Network Chat
The optional NetworkChat module relays player chat between connected servers through the shared database.
It supports:
Players can remain on different servers while communicating through one shared network chat.
Network Events
ServerRouter can synchronize network-wide:
Instead of displaying a separate quit and join every time someone changes server, ServerRouter can show a single cleaner switch event:
Network events support custom formats, server display names, switch-spam suppression and vanish protection.
Live Status, API & Scoreboard Support
Each connected server publishes its current state through a shared MariaDB heartbeat.
Available network information includes:
ServerRouter provides:
Scoreboard integration is optional. ServerRouter’s routing system works without a scoreboard plugin.
Configuration & Localization
ServerRouter automatically updates existing configuration files when new options are introduced while preserving current values whenever possible.
Generated language files are available for:
Default player-facing messages use language keys, but normal text can also be written directly in the configuration.
Generated language and portal files are stored outside the JAR and can be customized safely.
Database Requirements
ServerRouter uses MariaDB to synchronize network information and optional modules.
Servers belonging to the same network should use:
Every server must have its own unique
The shared database can synchronize:
Fully Modular
ServerRouter’s additional systems can be enabled or disabled depending on your network.
Optional modules include:
This makes ServerRouter suitable for both small two-server setups and larger networks with many different destinations.
Summary
ServerRouter provides everything needed to build a connected Hytale network:
One network. Every server.
ServerRouter connects multiple Hytale servers into one unified network.
Move players using commands or portals, synchronize chat, events and inventories, display live server status, expose network data through API and scoreboard placeholders, and show players from every connected server in the native network-wide player list.
Create any network structure you need: hubs, survival worlds, dungeons, PvP servers, minigames, creative servers, event servers or custom game modes.
Routes, commands, server names, permissions, messages and optional modules are fully configurable.
Main Features
- Portals & Commands — Move players between servers using configurable commands, aliases and in-game portals.
- Cross-Server Chat — Let players communicate across every connected server.
- Live Status, API & Scoreboards — Display player counts and online, full or closed server states.
- Network Player List — Show players from all servers inside the native player list.
- Shared Inventory — Optionally synchronize player inventories across routed servers.
See ServerRouter in Action
ServerRouter is used on HyTari for commands, portals, live status, network chat, network events, scoreboard data, the network player list and shared inventories.
Server IP: play.HyTari.it
Server Routing
Create custom routes such as:
Code:
/hub
/survival
/dungeon
/pvp
/games
/creativeEvery route can define its own:
- Command and aliases
- Destination host and port
- Server ID and display name
- Permission
- Messages
- Availability rules
- Portal item
- Safety options
Before transferring a player, ServerRouter checks whether the destination is:
- Online
- Accepting players
- Not full
If the destination is unavailable, the player remains safely on the current server.
Portal Routing & Automatic Portal Generation
Routes can be connected to portal items placed directly in the game world.
ServerRouter can automatically generate a matching portal item for every configured route, making it easy to create hub selectors, dungeon entrances, PvP portals, minigame portals and other travel areas.
Generated assets are stored externally inside:
Code:
mods/ServerRouter/This provides several advantages:
- No JAR editing required
- New portals can be generated from configured routes
- Portal items can be customized externally
- Generated files remain available after plugin updates
- Existing custom files are not overwritten automatically
Note: Newly generated portal items may require one additional server restart before appearing in the creative inventory.
Secure Transfers & Portal Safety
ServerRouter includes built-in protection for smooth and reliable transfers:
- Destination availability checks
- Short-lived transfer authorization tokens
- Direct-access protection
- Portal anti-loop protection
- Login portal safety
- Arrival cooldown protection
- Same-server rejoin protection
- Pre-ready player protection
- Safe handling of missing or removed routes
If an old portal still exists after its route has been removed, it will not crash the server. The player receives a configurable missing-destination message instead.
Network Player List
The optional
networkPlayerList module adds players from every connected server to the native Hytale player list.It supports:
- Network-wide online players
- Custom player-name formatting
- Configurable server abbreviations
- Optional local-player inclusion
- Automatic presence refresh and timeout
- Vanish support
Example:
Code:
[D] Newt_Scamander
[S] PlayerTwo
[G] PlayerThreeServer abbreviations and the displayed format can be customized independently for each network.
Shared Inventory
ServerRouter includes an optional built-in inventory synchronization module.
When enabled, players can keep the same inventory while moving between connected servers.
The module includes:
- Shared inventory storage
- Automatic inventory saving
- Configurable save intervals
- Inventory lock protection
- Protection against simultaneous access and duplication
- Localized loading and locked messages
The module uses ServerRouter’s existing database and
serverId configuration, so a second database block is not required.Important: Do not enable the integrated inventory module while running another standalone inventory synchronization plugin.
Network Chat
The optional NetworkChat module relays player chat between connected servers through the shared database.
It supports:
- Custom cross-server formats
- Custom server display names
- Server prefixes
- EliteEssentials chat-format capture
- Fallback formatting
- Message length and lifetime controls
Players can remain on different servers while communicating through one shared network chat.
Network Events
ServerRouter can synchronize network-wide:
- Player join messages
- Player quit messages
- Server-switch messages
Instead of displaying a separate quit and join every time someone changes server, ServerRouter can show a single cleaner switch event:
Code:
[Dungeon → Hub] PlayerNameNetwork events support custom formats, server display names, switch-spam suppression and vanish protection.
Live Status, API & Scoreboard Support
Each connected server publishes its current state through a shared MariaDB heartbeat.
Available network information includes:
- Online and offline state
- Current player count
- Maximum player count
- Accepting-players state
- Full or closed state
- Last heartbeat time
- Total network player count
ServerRouter provides:
- BetterScoreBoard placeholders
- Per-server and total-player placeholders
- Colored status placeholders
- Internal cached API data
- Support for external dashboards and UI systems
Scoreboard integration is optional. ServerRouter’s routing system works without a scoreboard plugin.
Configuration & Localization
ServerRouter automatically updates existing configuration files when new options are introduced while preserving current values whenever possible.
Generated language files are available for:
- English
- Italian
- German
- Spanish
- French
- Portuguese
- Russian
- Turkish
Default player-facing messages use language keys, but normal text can also be written directly in the configuration.
Generated language and portal files are stored outside the JAR and can be customized safely.
Database Requirements
ServerRouter uses MariaDB to synchronize network information and optional modules.
Servers belonging to the same network should use:
- The same database
- The same table prefix
- The same ServerRouter version
Every server must have its own unique
serverId.The shared database can synchronize:
- Server heartbeat and availability
- Player counts
- Network chat
- Network events
- Network player presence
- Optional shared inventories
Fully Modular
ServerRouter’s additional systems can be enabled or disabled depending on your network.
Optional modules include:
- Network Chat
- Network Events
- Network Player List
- Shared Inventory
- BetterScoreBoard integration
- API and cached network data
This makes ServerRouter suitable for both small two-server setups and larger networks with many different destinations.
Summary
ServerRouter provides everything needed to build a connected Hytale network:
- Configurable server routes
- Command and portal transfers
- Automatic portal generation
- Secure transfer handling
- Live network status
- Cross-server chat and events
- Network-wide player list
- API and scoreboard placeholders
- Optional shared inventory
- Automatic config migration
- Generated localization files
One network. Every server.
