go-rcon

Minecraft RCON client module for connecting to Minecraft server using RCON protocol written in Go.

rcon.Client features a concurrent-safe Send function that creates a separate RCON connection for each command enabling asynchronous execution if desired. The ability to reuse a single connection is also available by creating rcon.Conn directly and sending commands via SendCommand function until the connection is closed.

Fragmented responses over 4096 bytes are also handled and parsed into single response.

This project is still under development and requires additional testing before it can be considered production ready.

Getting Started

Installing

go get will always pull the latest tagged release from the main branch.

go get github.com/jltobler/go-rcon

Usage

Import the package into your project.

import "github.com/jltobler/go-rcon"

Construct a new RCON client which can be used to access the send function.

rconClient := rcon.NewClient("rcon://localhost:25575", "password")

Use the Send function to request commands be remotely executed on the Minecraft server.

rconClient, err := rconClient.Send("time set day")