#minecraft #packets #protocols #light-weight #packet

rust_mc_proto

lightweight minecraft protocol support in pure rust

17 releases

0.1.16 Aug 22, 2024
0.1.15 Jul 15, 2024
0.1.8 May 24, 2024

#1185 in Network programming

Download history 375/week @ 2024-05-20 13/week @ 2024-05-27 2/week @ 2024-06-03 329/week @ 2024-07-08 466/week @ 2024-07-15 137/week @ 2024-07-29 133/week @ 2024-08-19 8/week @ 2024-08-26

141 downloads per month

Custom license

36KB
814 lines

rust_mc_proto

lightweight minecraft packets protocol support in pure rust
has compression (MinecraftConnection::set_compression)
all types of packets you can find on wiki.vg
crates github

setup

stable

rust_mc_proto = "0.1.15"

unstable

rust_mc_proto = { git = "https://github.com/MeexReay/rust_mc_proto" }

features:

  • atomic_compression (default)

how to use it

for reference:

pub type MCConn<T> = MinecraftConnection<T>;
pub type MCConnTcp = MinecraftConnection<TcpStream>;

example of receiving motd:

use rust_mc_proto::{Packet, ProtocolError, MCConnTcp, DataBufferReader, DataBufferWriter};

/*

    Example of receiving motd from the server
    Sends handshake, status request and receiving one

*/

fn send_handshake(conn: &mut MCConnTcp,
                protocol_version: u16,
                server_address: &str,
                server_port: u16,
                next_state: u8) -> Result<(), ProtocolError> {
    let mut packet = Packet::empty(0x00);

    packet.write_u16_varint(protocol_version)?;
    packet.write_string(server_address)?;
    packet.write_unsigned_short(server_port)?;
    packet.write_u8_varint(next_state)?;

    conn.write_packet(&packet)?;

    Ok(())
}

fn send_status_request(conn: &mut MCConnTcp) -> Result<(), ProtocolError> {
    let packet = Packet::empty(0x00);
    conn.write_packet(&packet)?;

    Ok(())
}

fn read_status_response(conn: &mut MCConnTcp) -> Result<String, ProtocolError> {
    let mut packet = conn.read_packet()?;

    packet.read_string()
}

fn main() {
    let mut conn = MCConnTcp::connect("sloganmc.ru:25565").unwrap();

    send_handshake(&mut conn, 765, "sloganmc.ru", 25565, 1).unwrap();
    send_status_request(&mut conn).unwrap();

    let motd = read_status_response(&mut conn).unwrap();

    dbg!(motd);
}

more examples

this crate can be used for a server on rust idk -_-

Dependencies

~705KB
~12K SLoC