DotRcon 0.0.3

DotRcon

A modern, async-first .NET library for the Source RCON protocol.

Supports authentication, command execution, multi-packet responses, and concurrent usage.

Features

• Async/await first — built on TcpClient and NetworkStream with full CancellationToken support.
• Multi-packet response handling — automatically assembles split responses using the terminator packet technique.
• Thread-safe — concurrent ExecuteAsync calls are matched to responses via request IDs.
• Proper resource cleanup — implements IAsyncDisposable for clean TCP teardown.
• Minimal API surface — just ConnectAsync and ExecuteAsync.

Installation

dotnet add package DotRcon

Quick Start

using DotRcon;

await using var client = await RconClient.ConnectAsync("127.0.0.1", 27015, "yourRconPassword");

var status = await client.ExecuteAsync("status");
Console.WriteLine(status);

var players = await client.ExecuteAsync("users");
Console.WriteLine(players);

Error Handling

using DotRcon;
using DotRcon.Exceptions;

try
{
    await using var client = await RconClient.ConnectAsync("127.0.0.1", 27015, "password");
    var result = await client.ExecuteAsync("changelevel de_dust2");
}
catch (RconAuthenticationException)
{
    Console.WriteLine("Wrong RCON password.");
}
catch (RconConnectionException ex)
{
    Console.WriteLine($"Connection error: {ex.Message}");
}

Cancellation & Timeouts

using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));

await using var client = await RconClient.ConnectAsync("127.0.0.1", 27015, "password", cts.Token);
var result = await client.ExecuteAsync("status", cts.Token);

Concurrent Commands

The client supports concurrent command execution. Each command is tracked by a unique request ID, so responses are matched correctly even when multiple commands are in-flight.

await using var client = await RconClient.ConnectAsync("127.0.0.1", 27015, "password");

var tasks = new[]
{
    client.ExecuteAsync("status"),
    client.ExecuteAsync("maps *"),
    client.ExecuteAsync("users"),
};

var results = await Task.WhenAll(tasks);

Supported Games

Any game server implementing the Source RCON protocol, including:

• Counter-Strike 2 / CS:GO
• Team Fortress 2
• Garry's Mod
• Left 4 Dead 2
• ARK: Survival Evolved
• Rust
• Minecraft (with RCON enabled)
• And many more

Protocol Reference

This library implements the Source RCON Protocol as documented on the Valve Developer Wiki.

License

MIT