hytale-query-a2s

A2S (Source Query) protocol implementation for Hytale servers. Enables server browsers and monitoring tools to query your Hytale server using the standard Valve A2S protocol.

Features

• A2S_INFO - Server information
• A2S_PLAYER - Connected player list including their UUID
• A2S_RULES - Server rules/variables
• Challenge-response authentication

Build

mvn clean package -q -Drevision=x.x.x

Output: target/hytale-query-a2s-x.x.x.jar

Installation

1. Copy hytale-query-a2s-x.x.x.jar to your Hytale server's mods/ directory
2. Restart the server

Configuration

Set the QUERY_PORT environment variable to specify your server's Query port. Default is game port + 1.

export QUERY_PORT=29014

Example usage

Using gamedig:

npx gamedig --type protocol-valve x.x.x.x:29014

Example response:

{
  "name": "My Hytale Server",
  "map": "default",
  "password": false,
  "raw": {
    "protocol": 17,
    "folder": "hytale",
    "game": "Hytale",
    ...
    "players": [
      {
        "name": "Fragnet (98373738-e122-4dc0-a6b1-ea73278d97b1)",
        "score": 0,
        "time": 0
      }
    ]
  },
  "version": "2026.01.17-4b0f30090",
  "maxplayers": 4,
  "numplayers": 1,
  ...
  "queryPort": 29014,
  "connect": "x.x.x.x:29013"
}

License

MIT License - see LICENSE