netcode rust implementation

Protocol

This crate implements the netcode network protocol created by Glenn Fiedler.

netcode is a simple connection based client/server protocol built on top of UDP.

See the official upstream specification to learn more about how the protocol works.

Install

Run the following Cargo command in your project directory:

cargo add netcode-rs

Or add the following line to your Cargo.toml:

[dependencies]
netcode-rs = "1.4.0"

NOTE: While the crate name is netcode-rs, the library name is actually netcode.
This means that even though you used cargo add netcode-rs to add the dependency, you will need to write use netcode::* (and notuse netcode_rs::*) to use it.

I know this is confusing, and I know that -rs crate names are frowned upon.
Unfortunately the original netcode crate is unmaintained and its maintainer is unreachable, so I could not get the ownership for the crate name. I didn't want to use names like netcode2 to avoid confusion with the netcode protocol versions.

Examples

server

use std::{thread, time::{Instant,Duration}};use netcode::{Server,MAX_PACKET_SIZE};// Create a serverlet protocol_id = 0x11223344u64;// a unique number that must match the client's protocol idlet private_key = netcode::generate_key();// you can also provide your own keyletmut server = Server::new("0.0.0.0:5555", protocol_id, private_key).unwrap();// Run the server at 60Hzlet start = Instant::now();let tick_rate = Duration::from_secs_f64(1.0 / 60.0);loop{let elapsed = start.elapsed().as_secs_f64();
server.update(elapsed);whileletSome((packet, from)) = server.recv(){// ...}
thread::sleep(tick_rate);}

client

use std::{thread, time::{Instant,Duration}};use netcode::{ConnectToken,Client,MAX_PACKET_SIZE};// Generate a connection token for the clientlet protocol_id = 0x11223344u64;// a unique number that must match the server's protocol idlet private_key = netcode::generate_key();// you can also provide your own keylet client_id = 123u64;// globally unique identifier for an authenticated clientlet server_address = "my-domain.com:5555";// the server's public address (can also be multiple addresses)let connect_token = ConnectToken::build(server_address, protocol_id, client_id, private_key).generate().unwrap();// Start the clientlet token_bytes = connect_token.try_into_bytes().unwrap();letmut client = Client::new(&token_bytes).unwrap();
client.connect();// Run the client at 60Hzlet start = Instant::now();let tick_rate = Duration::from_secs_f64(1.0 / 60.0);loop{let elapsed = start.elapsed().as_secs_f64();
client.update(elapsed);ifletSome(packet) = client.recv(){// ...}
thread::sleep(tick_rate);}

See examples for more.

Planned Features

• reliable packet acknowledgement system
• bevy plugin