SteamQuery.NET 1.1.1

SteamQuery.NET

Yet another Steam server queries .NET wrapper.

Supports Source, GoldSource, and obsolete GoldSource protocols.

Usage Example

You can check the ExampleApplication project!

var server = new GameServer("127.0.0.1:27015");

await server.PerformQueryAsync();

Console.WriteLine($"Server Name: {server.Information.ServerName}"); // Server Name: [TR] AnneTokatlayan Pro Public
Console.WriteLine($"Players: {server.Information.OnlinePlayers}/{server.Information.MaxPlayers}"); // Players: 13/37
Console.WriteLine($"Rule Count: {server.Rules.Count}"); // Rule Count: 420

server.Close();

Or instead of performing all queries, you can specify which queries should be performed and also use timeouts;

var server = new GameServer("127.0.0.1:27015")
{
    SendTimeout = 1337,
    ReceiveTimeout = 7331
};
server.Reestablish(); // Have to reestablish the socket after changing timeouts. I will change this in the future. Either pass via constructor parameter or use builder pattern.

await server.PerformQueryAsync(SteamQueryA2SQuery.Information | SteamQueryA2SQuery.Rules);

Console.WriteLine($"Server Name: {server.Information.ServerName}"); // Server Name: [TR] AnneTokatlayan Pro Public
Console.WriteLine($"Players: {server.Players.Count}/{server.MaxPlayers}"); // Output will be like "Players: 0/31" because you did not perform the Players query.
Console.WriteLine($"Rule Count: {server.Rules.Count}"); // Rule Count: 420

server.Close();

Or you can use using keyword to let .NET take care of the disposal process of server object;

using var server = new GameServer("127.0.0.1", 27015);

var information = await server.GetInformationAsync();
Console.WriteLine($"Server Name: {information.ServerName}"); // Server Name: [TR] AnneTokatlayan Pro Public

var players = await server.GetPlayersAsync();
Console.WriteLine($"Players: {players.Count}/{information.MaxPlayers}"); // Players: 13/37

var rules = await server.GetRulesAsync();
foreach (var rule in rules)
{
    Console.WriteLine($"{rule.Name} = {rule.Value}");
}

You can also use a host name, instead of IP address. And also the synchronous methods!

using var server = new GameServer("localhost:27015");

var information = server.GetInformation();

Console.WriteLine($"Server Name: {information.ServerName}"); // Server Name: [TR] AnneTokatlayan Pro Public

FYI: Before you perform any queries, related properties will have default values.

using var server = new GameServer("localhost:27015");

Console.WriteLine($"Server Name: {server.Information.ServerName}"); // Output will be like "Server Name: " because you did not perform the Information query.

var information await server.GetInformationAsync();

Console.WriteLine($"Server Name: {server.Information.ServerName}"); // Server Name: [TR] AnneTokatlayan Pro Public
Console.WriteLine($"Server Name: {information.ServerName}"); // Server Name: [TR] AnneTokatlayan Pro Public

Supported Frameworks

[1]

The versions listed for .NET Framework apply to .NET Core 2.0 SDK and later versions of the tooling. Older versions used a different mapping for .NET Standard 1.5 and higher.

[2]

The versions listed here represent the rules that NuGet uses to determine whether a given .NET Standard library is applicable. While NuGet considers .NET Framework 4.6.1 as supporting .NET Standard 1.5 through 2.0, there are several issues with consuming .NET Standard libraries that were built for those versions from .NET Framework 4.6.1 projects. For .NET Framework projects that need to use such libraries, we recommend that you upgrade the project to target .NET Framework 4.7.2 or higher.

To-Do

• bzip2 decompression. (It's kind of implemented. I just couldn't find any server that uses bzip2 compression. If you know any, just hit me up. I'd appreciate it.)
• Master Server Query Protocol.
• Source RCON Protocol.

For More Information

If you want to learn more about Steam's server queries and their weird behaviors, check Steam server queries developer community page and talk page about it.