rust-raknet

RakNet Protocol implementation by Rust.

Raknet is a reliable udp transport protocol that is generally used for communication between game clients and servers, and is used by Minecraft Bedrock Edtion for underlying communication.

Raknet protocol supports various reliability options, and has better transmission performance than TCP in unstable network environments. This project is an incomplete implementation of the protocol by reverse engineering.

Requires >= Tokio 1.x asynchronous runtime support.

Reference : http://www.jenkinssoftware.com/raknet/manual/index.html

This project is not affiliated with Jenkins Software LLC nor RakNet.

Features

• Async
• MIT License
• Pure Rust implementation
• Fast Retransmission
• Selective Retransmission (TCP/Full Retransmission)
• Non-delayed ACK (TCP/Delayed ACK)
• RTO Not Doubled (TCP/RTO Doubled)
• Linux/Windows/Mac/BSD support
• Compatible with Minecraft

Get Started

# Cargo.toml
[dependencies]
rust-raknet = "*"

Documentation : https://docs.rs/rust-raknet/latest/rust_raknet/

Reliability

• unreliable
• unreliable sequenced
• reliable
• reliable ordered
• reliable sequenced

Example

//server

async fn serve(){
    let mut listener = RaknetListener::bind("127.0.0.1:19132".parse().unwrap()).await.unwrap();
    listener.listen().await;
    loop{
        let socket = listener.accept().await.unwrap();
        let buf = socket.recv().await.unwrap();
        if buf[0] == 0xfe{
            //do something
        }
    }
    listener.close().await.unwrap();
}

//client

async fn connect(){
    let socket = RaknetSocket::connect("127.0.0.1:19132".parse().unwrap()).await.unwrap();
    socket.send(&[0xfe], Reliability::ReliableOrdered).await.unwrap();
    let buf = socket.recv().await.unwrap();
    if buf[0] == 0xfe{
        //do something
    }
    socket.close().await.unwrap();
}

Benchmark

Use Tcp to compare with this project. Set the server packet loss rate to 50%, the client connects to the server, and the server sends an 800-byte packet every 30ms, a total of 100 times. The client counts the delay time of each received data, and calculates the average time of receiving 100 times. The following results are obtained.

Test code: https://github.com/b23r0/rust-raknet/blob/main/example/test_benchmark/src/main.rs

Result:

(June 12, 2022)

In the network environment with high packet loss rate, this project can reduce the delay time by about 50% compared with TCP.

Contributing

Options :

• Report a BUG
• Submit an ISSUE about suggestion
• Submit a improved PR
• Add an example of using rust-raknet
• Supplement the documentation about using rust-raknet

Thanks go to these wonderful people.

b23r0

nounfve

Contributions of any kind are welcome! If you've ever wanted to contribute to open source, and a great cause, now is your chance!

Donation

BTC : 1HeroYcNYMhjsq8RYCx1stSaRZnQd9B9Eq

ETH : 0x9999997B3deF7b69c09D7a9CA65E5242fb04a764