Skip to content

Latest commit

 

History

History
69 lines (52 loc) · 2.28 KB

README.md

File metadata and controls

69 lines (52 loc) · 2.28 KB
Raw

GoldSource Info Client

goldsrc-info-client is a C++ client for querying the Valve's GoldSource engine games.

Created and tested for Counter-Strike 1.6 running on HLDS.

The project consist of a dynamic-linked library where the implementation of the client lies and a test console application. The library is Windows only and uses the winsock2 APIs for the UDP connection to the server.

About

Using this library you can create an application that shows information about your Counter-Strike 1.6 or other goldsrc game server. You can request the following information:

  • Generic server information - returns server name, current map, min/max players and more - for more detailed information check the InfoResponse class.
  • Server rules - returns all the cvars that the server exposes
  • Players - returns all players with id, frag count and duration
  • Ping - calculates the latency to the server

Implementation based on https://developer.valvesoftware.com/wiki/Server_queries

Usage

Create a client object:

hlds::Client client(serverIP, serverPort);

Use the client to query the server:

  • Query server info
hlds::InfoResponse info = client.QueryInfo();
std::cout << info.name << ", " << info.game << ", " << info.map
          << ", " << info.players << " / " << info.maxPlayers << std::endl;
  • Query rules
RulesVector rules = client.QueryRules();
for (auto& rule : rules)
{
  std::cout << rule.first << " = " << rule.second << std::endl;
}
  • Query players
std::vector<hlds::PlayerData> players = client.QueryPlayers();
std::cout << "Players count: " << players.size() << std::endl;

for (auto& player : players)
{
  std::cout << "[" << player.index << "] " << player.name
            << ", " << player.score << " frags, " << player.duration << std::endl;	
}
  • Calculate ping - return the latency to the server in ms. Uses std::chrono::high_resolution_clock to calculate the latency.
size_t latency = client.QueryPing();
std::cout << "Latency: " << latency << std::endl;

Troubleshooting

If the server is not available or there's a problem parsing the packets, an exception will be thrown.

License

This software is licensed under the terms of the MIT license.