Crate rak_rs

rak-rs

A fully functional RakNet implementation in pure rust, asynchronously driven.

Getting Started

RakNet (rak-rs) is available on crates.io, to use it, add the following to your Cargo.toml:

[dependencies]
rak-rs = "0.3.3"

Features

This RakNet implementation comes with 3 primary features, async_std, async_tokio and mcpe. However, by default, only async_std is enabled, and mcpe requires you to modify your Cargo.toml.

If you wish to use these features, add them to your Cargo.toml as seen below:

[dependencies]
rak-rs = { version = "0.3.3", default-features = false, features = [ "async_tokio", "mcpe" ] }

rak-rs also provides the following modules:

• rak_rs::client - A client implementation of RakNet, allowing you to connect to a RakNet server.
• rak_rs::connection - A bare-bones implementation of a Raknet peer, this is mainly used for types.
• rak_rs::error - A module with errors that both the Client and Server can respond with.
• rak_rs::protocol - A lower level implementation of RakNet, responsible for encoding and decoding packets.
• rak_rs::server - The base server implementation of RakNet.
• rak_rs::util - General utilities used within rak-rs.

Client

The client module provides a way for you to interact with RakNet servers with code.

Example:

use rak_rs::client::{Client, DEFAULT_MTU};
use std::net::ToSocketAddrs;

#[async_std::main]
async fn main() {
    let version: u8 = 10;
    let mut client = Client::new(version, DEFAULT_MTU);

    client.connect("my_server.net:19132").await.unwrap();

    // receive packets
    loop {
        let packet = client.recv().await.unwrap();

        println!("Received a packet! {:?}", packet);

        client.send_ord(vec![254, 0, 1, 1], Some(1));
    }
}

Server

A RakNet server implementation in pure rust.

Example:

use rakrs::connection::Connection;
use rakrs::Listener;
use rakrs::

#[async_std::main]
async fn main() {
    let mut server = Listener::bind("0.0.0.0:19132").await.unwrap();
    server.start().await.unwrap();

    loop {
        let conn = server.accept().await;
        async_std::task::spawn(handle(conn.unwrap()));
    }
}

async fn handle(mut conn: Connection) {
    loop {
        // keeping the connection alive
        if conn.is_closed() {
            println!("Connection closed!");
            break;
        }
        if let Ok(pk) = conn.recv().await {
            println!("Got a connection packet {:?} ", pk);
        }
    }
}

Re-exports

• pub use protocol::mcpe;
• pub use protocol::mcpe::motd::Motd;
• pub use server::Listener;

Modules

• client
  A client implementation of RakNet, allowing you to connect to a RakNet server. This module contains the client implementation of RakNet. This module allows you to connect to a RakNet server, and send and receive packets. This is the bare-bones implementation for a RakNet client.
• connection
  The connection implementation of RakNet, allowing you to send and receive packets. This is barebones, and you should use the client or server implementations instead, this is mainly used internally. This module contains the logic to handle a connection or “peer” to the server. This is used internally by the server, and is not intended to be used by the end user outside of the server.
• error
  The error implementation of RakNet, allowing you to handle errors.
• protocol
  The packet implementation of RakNet. This is a lower level implementation responsible for serializing and deserializing packets. Protocol implementation for RakNet. this module contains all of the necessary packets to communicate with RakNet servers.
• server
  The server implementation of RakNet, allowing you to create a RakNet server. This is the server implementation of RakNet, allowing you to create a RakNet server.
• util
  Utilties for RakNet, like epoch time.

Macros

• match_ids
• rakrs_debug
  A wrapper for println that is enabled only with the features debug, debug_all, or debug_features.
• rakrs_debug_buffers
• register_packets
  A utility macro that adds the implementation for any OnlinePacket(Pk) where Pk can be converted to RakPacket, OnlinePacket or OfflinePacket and vice versa.