Introduction

This is a Valve RCON implementation that tries to provide a working RCON library. This package was made after finding out that most of the implementations of the RCON protocol do not work correctly when used with Counter Strike: Global Offensive. This is not necessarily the fault of the library maintainers. The RCON protocol is not well defined and implementations vary wildly. In fact, CS:GO does not work well with most of the libraries mostly because it does not adhere to the authentication scheme described in Valve's documentation.

This package aims to be an RCON library that just works. We do not attempt to correctly implement the protocol as described in Valve's Developer Wiki, but instead attempt to make this library work on as many games as possible.

The current list of verified working games is:

• Counter Strike: Global Offensive
• Counter Strike: Source
• Garry's Mod
• Left 4 Dead 2
• Half Life 2 Multiplayer
• Team Fortress 2

I made this fork from the original project to fix wrongly done body parsing that resulted in some fields from the answer not being returned, so I won't actively maintain this project.

It's used for : https://github.com/Unyxos/srcds_exporter

Installation

npm install working-rcon

Example usage

const { connect, TimeoutError } = require('working-rcon')

const main = async () => {
	try {
		const client = await connect('34.123.45.23', 27015, 'password', 5000)

		const status = await client.command('status')
		const stats = await client.command('stats')

		await client.disconnect()

		console.log(status)
		console.log(stats)
	} catch (err) {
		if (err instanceof TimeoutError) {
			console.error('request timed out')
		} else {
			throw err
		}
	}
}

API Documentation

connect(host: string, port: number, password: string, timeout: number = 1000): Promise<RconClient>

Creates a new connection and returns an RCON client object. Can throw a Node socket error if something goes wrong during connecting. Can throw a TimeoutError if the authentication phase times out.

This call intentionally does not actually wait for an authentication response from the server, because this sequence is not reliable on all servers. For instance on CS:GO servers there is no reliable way to verify that the authentication was successful.

Parameters

• host: The hostname of the target host.
• port: The port running the RCON server.
• password: The rcon password.
• timeout: A timeout that will be used when sending requests to the server. A TimeoutError will be thrown if this timeout is exceeded

Return value

A promise that resolves to an instance of RconClient.

RconClient#command(cmd: string): Promise<string>

Sends an RCON command to the server and returns the response. The promise may reject with a TimeoutError if the timeout specified in the connect call is reached.

Parameters

• cmd: The command to send.

Return value

A promise that resolves to the response of the server.

RconClient#disconnect(): Promise<undefined>

Closes the RCON connection.

Return value

A promise that resolves when the connection has been closed.