q3rcon/README.md

Q3Rcon

Send rcon commands to Q3 compatible servers.

For an outline of past/future changes refer to: CHANGELOG

Requirements

• The game must implement RCON using the Q3 protocol.

Background

Quake3 Rcon works by firing UDP packets to the game server port, responses may be returned at once or in fragments (depending on the size of the response). For this reason I've made this package quite flexible, timeouts for responses can be set by request kind using a timeouts map. The default timeout for a response is 20ms, although this can be changed as well.

Rcon itself is insecure and each packet includes the password so I don't suggest using it remotely. If you have direct access to the server then SSH in first, then use this tool locally.

Use

go get github.com/onyx-and-iris/q3rcon

package main

import (
	"fmt"
	"log"

	"github.com/onyx-and-iris/q3rcon"
)

func main() {
	var (
		host     string = "localhost"
		port     int    = 30000
		password string = "rconpassword"
	)

	rcon, err := q3rcon.New(host, port, password)
	if err != nil {
		log.Fatal(err)
	}
	defer rcon.Close()

	resp, err := rcon.Send("mapname")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(resp)
}

WithDefaultTimeout(timeout time.Duration)

You may want to change the default timeout if some of your responses are getting mixed together (stability can depend on connection to the server). For example, on LAN I can leave the default at 20ms, when connecting remotely I normally increase this to 50ms.

For example:

	rcon, err := q3rcon.New(
		host, port, password,
		q3rcon.WithDefaultTimeout(50*time.Millisecond))

WithTimeouts(timeouts map[string]time.Duration)

Perhaps there are some requests that take a long time to receive a response but you want the whole response in one chunk. Pass a timeouts map, for example:

	timeouts := map[string]time.Duration{
		"map_rotate":  1200 * time.Millisecond,
		"map_restart": 1200 * time.Millisecond,
	}

	rcon, err := q3rcon.New(
		host, port, password,
		q3rcon.WithTimeouts(timeouts))