Hytale Simple Query
A lightweight UDP Query Protocol plugin for Hytale servers.
Designed to let server-listing platforms and websites fetch real-time server data with minimal overhead.
🖼️ Preview Screenshot
🖥 Demo
Live query example:
https://yamiru.com/hytale
PHP example (simple web query):
https://github.com/Yamiru/Hytale-Simple-query/blob/main/serverexample.php
✨ Features
SettingValue
Query Port5533 (UDP)
Bind Address 0.0.0.0
Max Players 100
Rate Limit 50 req/se
Ban Duration 30 seconds
Challenge AuthEnabled
🔧 Configuration
Config path: mods/Yamiru_HytaleQuery/config.json
📡 Query Protocol
The plugin follows the standard Game Server Query Protocol workflow.
🔥 Firewall
UFW:
sudo ufw allow 5533/udp
iptables:
sudo iptables -A INPUT -p udp --dport 5533 -j ACCEPT
📘 Requirements
MIT License
📧 Contact
A lightweight UDP Query Protocol plugin for Hytale servers.
Designed to let server-listing platforms and websites fetch real-time server data with minimal overhead.
🖼️ Preview Screenshot
🖥 Demo
Live query example:
https://yamiru.com/hytale
PHP example (simple web query):
https://github.com/Yamiru/Hytale-Simple-query/blob/main/serverexample.php
✨ Features
- Fully compatible UDP Game Server Query Protocol
- Real-time player count & player list
- TPS reporting
- Rate-limit protection
- IP whitelist / blacklist
- Challenge-response authentication
- Customizable version, map, and server name
- Response caching for improved performance
- Place hytale-simple-query-1.0.0.jar into the mods/ folder
- Restart the server
- A new config will be generated at:
mods/Yamiru_HytaleQuery/config.json
SettingValue
Query Port5533 (UDP)
Bind Address 0.0.0.0
Max Players 100
Rate Limit 50 req/se
Ban Duration 30 seconds
Challenge AuthEnabled
🔧 Configuration
Config path: mods/Yamiru_HytaleQuery/config.json
📡 Query Protocol
The plugin follows the standard Game Server Query Protocol workflow.
🔥 Firewall
UFW:
sudo ufw allow 5533/udp
iptables:
sudo iptables -A INPUT -p udp --dport 5533 -j ACCEPT
📘 Requirements
- Java 25+
- Hytale Server
MIT License
📧 Contact
- Website: yamiru.com
- GitHub: @Yamiru
- Issues: GitHub Issues