Hytale Simple Query

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.


🖥 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

📦 Installation

1. Place hytale-simple-query-1.0.0.jar into the mods/ folder
2. Restart the server
3. A new config will be generated at:

mods/Yamiru_HytaleQuery/config.json

⚙ Default Settings
Setting Value
Query Port 5533 (UDP)
Bind Address 0.0.0.0
Max Players 100
Rate Limit 50 req/sec
Ban Duration 30 seconds
Challenge Auth Enabled

🔥 Firewall
UFW:
sudo ufw allow 5533/udp
iptables:
sudo iptables -A INPUT -p udp --dport 5533 -j ACCEPT

📘 Requirements
Java 25+
Hytale Server

📄 License
MIT License