RCON

Simple CLI & library for communicating with Valve's Source RCON compatible game servers (TF2/CS:GO/GMod/etc...).

Command Line Usage

Basic flags for connecting. Host and password must be set. If the host does not specify a port, 27015 is used as default.

Basic RCON CLI interface

Usage:
  rcon [command] [flags]

Flags:
  -h, --help              help for rcon
  -H, --host string       Remote host, host:port format (default "localhost:27015")
  -p, --password string   RCON password
  -v, --version           version for rcon

If you do not specify a command a simple REPL shell will open instead as shown below

$ rcon -H tf2-server.com -p asdf       
rcon> status
hostname: Uncletopia | San Francisco
version : 5970214/24 5970214 secure
udp/ip  : 23.239.22.163:27015  (public ip: 23.239.22.163)
steamid : [G:1:3414356] (85568392923453780)
account : not logged in  (No account specified)
map     : cp_sunshine at: 0 x, 0 y, 0 z
tags    : Uncletopia,cp,nocrits,nodmgspread
players : 23 humans, 0 bots (32 max)
edicts  : 1028 used of 2048 max
# userid name                uniqueid            connected ping loss state  adr
#   1039 "BigDickMoe"        [U:1:356612105]     51:17      100    0 active 11.22.33.44:27005
#   1058 "Yeooranium"        [U:1:279111806]     25:43      118    0 active 11.22.33.44:27005
#   1062 "LaunderedPancake"  [U:1:87426245]      18:17       74    0 active 11.22.33.44:27005

rcon> quit
$

Library Usage

package main

import (
    "context"
    "github.com/leighmacdonald/rcon/rcon"
)

func main() {
    // Connect
    conn, err := rcon.Dial(context.Background(), "localhost:27015", "P@SSW0RD", 10*time.Second)
    if err != nil {
        log.Fatalf("Failed to dial server")
    }
    // Exec your command
    resp, err := conn.Exec("status")
    if err != nil {
        log.Fatalf("Failed to exec command: %v", err)
    }
    // Do something with the response
    fmt.Printf("%s\n", resp)
}