Source Server Query Library
Contents
About
The Source Server Query Library simplifies the communication with Source game servers and Source master servers.
You do not have to deal with the Source Server Query Protocol and can focus on integrating the library into e.g. a game browser, a remote console application etc.
With Source Server Query Library you can:
- Get latency times of game servers
- Receive general information about game servers
- Receive player details of players on game servers
- Receive game rules of game servers
- Receive logs of game servers
- Receive a list of game servers from a master server
- Send remote commands to game servers and receive the responses
Author
Pascal Herget
Languages
Currently only for C/C++.
How to use
First, initialize SSQ:
SSQ_Initialize( false );
It's also a smart idea to set the timeout to something else than infinity (note: this currently only works for listening to messages, not to connection attempts with the server):
SSQ_SetTimeout( SSQ_GS_TIMEOUT, 3000 ); // 3 seconds
Then, set the game server address:
bool connectionSuccess = SSQ_SetGameServer( "127.0.0.1:27015" );
If the connection was succesful, you can query the server, and if that succeeds, you can use the data:
if( connectionSuccess )
}
PSSQ_INFO_REPLY reply = new SSQ_INFO_REPLY; // Watch out! Memory leak here! Make this a private member that is cleaned up appropriately.
if( SSQ_GetInfoReply( reply ) )
{
char logmsg[4];
if( reply )
{
Q_snprintf( logmsg, sizeof(logmsg), "%c", reply ->dedicated );
Log( (const char*) logmsg );
}
}
}
When you're done using it, clean up:
SSQ_Initialize( true);
Manual
Structures
SSQ_BATCH_REPLY
The SSQ_BATCH_REPLY structure is filled with raw game server addresses.
typedef struct{
long num_servers;
long data_size;
char* data;
}SSQ_BATCH_REPLY,
*PSSQ_BATCH_REPLY;
Members
- num_servers
Number of game server addresses.
- data_size
Size of the data pointed to by data.
- data
Pointer to the raw game server addresses.
Remarks
The addresses are stored as an array of 6 byte addresses (4 byte numerical address + 2 byte port). The last address (in a complete callback loop) is 0 for all 6 bytes.
SSQ_INFO_REPLY
The SSQ_INFO_REPLY structure is filled with information about a game server.
typedef struct{
char version;
char hostname[256];
char map[32];
char game_directory[32];
char game_description[256];
short app_id;
char num_players ;
char max_players;
char num_of_bots;
char dedicated;
char os;
char password;
char secure;
char game_version[32];
}SSQ_INFO_REPLY,
*PSSQ_INFO_REPLY;
Members
- version
Network protocol version of the game server.
- hostname
Hostname of the game server.
- map
Current map on the game server.
- game_directory
Game directory of the game server.
- game_description
Description of the game running on the game server.
- app_id
Steam Application Identifier.
- num_players
Current number of players on the game server.
- max_players
Maximum allowed players on the game server.
- num_of_bots
Current number of bots on the game server.
- dedicated
Value is "d" for dedicated server and "l" for listen server.
- os
Value is 'l' for Linux and 'w' for Windows. OS running on the game server.
- password
Value is 1 if the game server is password protected.
- secure
Value is 1 if the game server has Valve Anti-Cheat.
- game_version
Version of the game running on the game server.
Remarks
Strings are truncated if they are longer than the buffer.
Download
Binary: SSQbeta1.zip
Source: SSQbeta2_src.zip