OneQuery - Hytale Server Query Plugin

Let server lists display your server stats. Works like Minecraft's query protocol, but built for Hytale.

Features

Zero Dependencies — just drop in and it works
Same Port — uses your game port, no extra ports needed
Secure — challenge-response prevents DDoS amplification
Network Mode — combine player counts across multiple servers
Access Control — protect endpoints with tokens

What Can Be Queried?

Server name and MOTD
Player count (current and max)
Online player list with UUIDs
Server version and protocol info
Installed plugins

Network Mode (New in v2!)

Running multiple servers? OneQuery can aggregate data across your entire network:

Show total players across all servers from your lobby
Display combined player list from any server
Real-time sync via Redis

Perfect for survival networks, minigame servers, and large communities.

Access Control

Protect sensitive data with token-based authentication:

Make player count public, but player list private
Give different apps different permissions
Revoke access anytime

Plugin API

Other plugins can access network-wide data:

OneQueryAPI api = OneQueryAPI.get();
int totalPlayers = api.getPlayerCount();
List<PlayerInfo> survivalPlayers = api.getPlayers("survival-*");
boolean isOnline = api.isPlayerOnline(uuid);

Installation

Download the JAR file
Place it in your server's plugins folder
Restart the server
Done! Your server is now queryable

Configuration

Works out of the box. Config file: mods/HytaleOne_OneQuery/config.json

{
  "Enabled": true,
  "LegacyProtocolEnabled": true
}

Optional Features

Network Mode — aggregate players across servers:

{
  "Network": {
    "Enabled": true,
    "ServerId": "lobby-1",
    "NetworkId": "my-network",
    "Mode": "AGGREGATE",
    "Store": {
      "Type": "redis",
      "Redis": { "Host": "localhost", "Port": 6379 }
    }
  }
}

Access Control — protect endpoints with tokens:

{
  "Authentication": {
    "Public": { "Basic": true, "Players": false },
    "Tokens": {
      "my-secret-token": { "Basic": true, "Players": true }
    }
  }
}

Server Info Overrides — custom display values:

{
  "ServerInfo": {
    "ServerName": "My Server",
    "Motd": "Welcome!",
    "Host": "play.example.com"
  }
}

See the full documentation for all options.

Join Our Discord

Need help? Want updates? Join our community:

👉 discord.gg/y7QJszbpvC

For Developers

Query servers from your app:

License

MIT — free to use, modify, and distribute.

One Query