#rcon #minecraft-server

mc-rcon

A client implementation of Minecraft's RCON protocol

2 releases

0.1.1 Jul 30, 2024
0.1.0 Apr 25, 2024

#869 in Network programming

30 downloads per month

MIT license

18KB
226 lines

This is a Rust crate provides a client for Minecraft's RCON protocol as specified at https://wiki.vg/RCON.

Connect to a server with RconClient::connect, log in with RconClient::log_in, and then send your commands RconClient::send_command. For example:

let client = RconClient::connect("localhost:25575")?;
client.log_in("SuperSecurePassword")?;
println!("{}", client.send_command("seed")?);

This example connects to a server running on localhost, with RCON configured on port 25575 (or omitted, as that is the default port) and with password SuperSecurePassword, after which it uses Minecraft's seed command to query the world's generation seed.

Assuming that the server is configured accordingly, this program will print a response from the server like Seed: [-1137927873379713691].

For excessively long responses, RCON servers can send multiple response packets. This crate does handle this possibility, but as an implementation detail it will sometimes send extra seed commands.

Dependencies

~69KB