OrbisProxy is a lightweight, high-performance proxy written in Go (not Java).
It is designed for reliability, scalability with built-in load balancing, player transfers, automatic fallback handling, and plugin support.
- Written in Go for low memory usage and high performance
- Server with load balancing strategies
- Player transfer system
- Automatic fallback handling
- Route-based connections
- Define hostnames and automatically route incoming connections to specific backend servers based on the used domain
- Multi-language support with per-player localization (en, de, zh, es, ru)
- Plugin extensibility
- Hot-Reloadable Lua Plugins: Lua Plugin API
- (Planned) Go Plugin API (Linux only) for advanced plugin extensibility
Pools group multiple servers and distribute players automatically using a strategy like round-robin.
Example: If you transfer a player to a pool name, OrbisProxy automatically selects the target server based on the pool strategy.
If a backend server crashes or becomes unreachable, all players are automatically moved to the configured fallback server.
| Command | Arguments | Permission | Description |
|---|---|---|---|
/proxy |
— | orbisproxy.command.proxy |
Shows all proxy commands |
/proxy |
servers |
orbisproxy.command.proxy.servers |
Lists all servers and their online/offline status |
/proxy |
version |
orbisproxy.command.proxy.version |
Shows the proxy version |
/proxy |
find --target=[player] |
orbisproxy.command.proxy.find |
Find a specific player on the proxy |
/transfer |
<server> --target=[player] |
orbisproxy.command.transfer |
Transfer a specific player to a server |
/transfer |
<server> --all |
orbisproxy.command.transfer |
Transfer all players to a server |
/transfer |
<pool-name> |
orbisproxy.command.transfer |
Transfer player to a pool (auto-selected target) |
Transfers can also be triggered by other plugins or by using the ClientReferral packet. When using a ClientReferral transfer:
- The host field is interpreted as the target server or pool name
- The port value is ignored
- The host value must be prefixed with:
optransfer.<server>
Where <server> is replaced by the server name or pool name defined in the configuration.
By using Hytales build-in /refer command.
To connect to server lobby-1: /refer optransfer.lobby-1 1234
To connect to server lobby-2: /refer optransfer.lobby-2 1234
To connect to pool lobby /refer optransfer.lobby 1234
-c "config.yml"
Path to configuration file (optional, default: config.yml)
-debug true
Enable debug logging (default: false)
Quick and easy scripting for lightweight plugins.
See the full Lua API reference here: Lua API Documentation
Advanced plugin development in Go.
Linux only. Windows is not supported.
See example Proxy Configuration
See Backend Server Setup Guide
See Docker Guide
See Linux Service Installation Guide
See Pterodactyl Egg Guide
If you require any specific deployment options or assistance, please feel free to reach out to us on Discord.
OrbisProxy is confirmed to work with a variety of Hytale mods, including:
- Admin Portals - fully supported
Closed Source currently.