Description
🚀 Features
- A2S_INFO Support: Provides essential server details (Name, Map, Player Count, Max Players, Version, etc.).
- A2S_PLAYER Support: Exposes the current list of online players.
- A2S_RULES Support: Shares advanced server metadata, including:
- Server version and revision ID.
- Hytale protocol version and hash.
- Authentication status (to check if the server is properly logged in).
- Real-time TPS (Ticks Per Second) for each world.
- Auto-Discovery: Automatically binds to your server's IP and uses Game Port + 1 by default.
- Lightweight: Minimal impact on server performance with optimized status updates.
🛠️ Installation
The plugin will start automatically and log its binding address (e.g., [QueryPlugin] A2S Server started on 0.0.0.0:29401).
⚙️ Configuration
The plugin works out-of-the-box for most setups. If you need to customize the network settings, you can use the following environment variables:
- QUERY_HOST: The IP address to bind the query server to. Default: Game server bind address or 0.0.0.0
- QUERY_PORT: The UDP port to listen for query requests on. Default: Game Port + 1
🔍 Verification
You can test if your query server is working correctly using qstat or any A2S-compatible tool:
qstat -a2s <your-server-ip>:<query-port>
Developed by GPORTAL. Providing reliable infrastructure for the Hytale community.


