A2S Query protocol
Note: The content on this page pertains to Clanforge. If you’re using Multiplay Hosting, refer to the Multiplay Hosting documentation.
A2S is a popular UDP-based game server query protocol that Valve Software keeps as a part of the Steam SDK. Many game engines support A2S natively, but if yours doesn’t, you can add support for A2S manually by using one of the A2S libraries for your preferred language (for example, go-a2s for Golang, QueryMaster for C#).
Visit the Valve Software wiki page for server queries to learn more about the technical details of the A2S protocol, including the protocol specification, response body format, and a list of implementations in various languages.
To integrate a manual A2S implementation with Clanforge, you must configure at least the following variables:
It’s important to ensure that the values reported for Players
and Max Players
in A2S_INFO
responses are accurate. Clanforge uses these values to calculate and monitor resource usages on the machine. If the values are inaccurate or in the wrong format, Clanforge won’t be able to manage resources properly, which can cause errors, game server crashes, or sub-optimal performance. It is the recommended best practice that you also provide accurate maptype data, which allows us to report crashes by maptype.
Note: A2S is a legacy protocol. Unity’s SQP protocol is newer and integrates more easily into the Unity ecosystem.