#rcon #minecraft #command #protocols

mc-rcon

A client implementation of Minecraft's RCON protocol

1 unstable release

new 0.1.0 Apr 25, 2024

#974 in Network programming

Download history 144/week @ 2024-04-22

144 downloads per month

MIT license

15KB
174 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].

Note that, although RCON servers can send multiple response packets, this crate currently does not handle that possibility. If you need that functionality, please open an issue.

Dependencies

~66KB