promotional bannermobile promotional banner
premium banner
This plugin exposes an Valve Steam Query (A2S) query port.

Description

🚀 Features

  • A2S_INFO Support: Provides essential server details (Name, Map, Player Count, Max Players, Version, etc.).
  • A2S_PLAYER Support: Exposes the current list of online players.
  • A2S_RULES Support: Shares advanced server metadata, including: 
    • Server version and revision ID.
    • Hytale protocol version and hash.
    • Authentication status (to check if the server is properly logged in).
    • Real-time TPS (Ticks Per Second) for each world.
  • Auto-Discovery: Automatically binds to your server's IP and uses Game Port + 1 by default.
  • Lightweight: Minimal impact on server performance with optimized status updates.

🛠️ Installation

The plugin will start automatically and log its binding address (e.g., [QueryPlugin] A2S Server started on 0.0.0.0:29401).


⚙️ Configuration
The plugin works out-of-the-box for most setups. If you need to customize the network settings, you can use the following environment variables:

  • QUERY_HOST: The IP address to bind the query server to. Default: Game server bind address or 0.0.0.0
  • QUERY_PORT: The UDP port to listen for query requests on. Default: Game Port + 1

🔍 Verification
You can test if your query server is working correctly using qstat or any A2S-compatible tool:
qstat -a2s <your-server-ip>:<query-port>


Developed by GPORTAL. Providing reliable infrastructure for the Hytale community.