One Query

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

1. Download the JAR file
2. Place it in your server's plugins folder
3. Restart the server
4. 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:

• Node.js / TypeScript Library
• Protocol Specification
• API Documentation

Links

• Source Code
• Documentation
• hytale.one Server List

License

MIT — free to use, modify, and distribute.