aeronet
A light-as-air client/server networking library with first-class support for Bevy, providing a consistent API which can be implemented by different transport mechanisms.
Aeronet's main feature is the transport - an interface for sending data to and receiving data from an endpoint, either the client or the server. You write your code against this interface (or use the Bevy plugin which provides events used by the transport), and you don't have to worry about the underlying mechanism used to transport your data.
Transports
aeronet_channelvia in-memory MPSC channels, useful for local singleplayer serversaeronet_wt_nativevia a Rust implementation of WebTransport, useful for a generic client-server architecture with support for WASM clientsaeronet_wt_wasmvia the browser's implementation of WebTransport, useful for a WASM app which requires a networking client
Getting started
First, you will need two [Message] types to use for sending client-to-server (C2S) and server-to-client messages (S2C). They may be the same type.
#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
pub enum C2S {
Move(f32),
Shoot,
}
#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
pub enum S2C {
AddPlayer(String),
UpdateHealth(f32),
}
fn assert_is_message<T: aeronet::Message>() {}
assert_is_message::<C2S>();
assert_is_message::<S2C>();
Then, you will need a transport implementation to use. Select one from the list above that suits your needs. Afterwards, use the [ClientTransport] and [ServerTransport] traits to interact with the transport, to do functions such as sending and receiving data.
let client = MyClientTransport::<C2S, S2C>::new();
client.send(C2S::Shoot);
let rtt: Duration = client.info().rtt();
println!("Latency to server: {rtt}");
With Bevy
Aeronet provides transport-agnostic plugins for the client and server transports, letting you write the same code for all networking without worrying about the underlying transport that's used to deliver your messages.
use bevy::prelude::*;
use aeronet::ClientTransportPlugin;
fn main() {
App::new()
.add_plugins((
ClientTransportPlugin::<C2S, S2C, MyClientTransport<_, _>>::default(),
))
.add_systems(Update, on_recv)
.run();
}
fn on_recv(
mut recv: EventReader<FromServer<S2C>>,
) {
for FromServer(msg) in recv.iter() {
println!("Got a message from the server: {msg:?}");
}
}
4 Aug 9, 2023
104 Oct 7, 2023
4 Feb 4, 2024
4 Mar 19, 2023
13 Oct 3, 2023
113 Dec 28, 2022
10 May 27, 2023
2 Apr 1, 2022
139 Aug 1, 2023
16 Nov 9, 2022
18 Dec 31, 2023
26 Dec 23, 2022
2 Nov 17, 2021
20 Dec 29, 2022
45 May 31, 2023
690 Jun 29, 2023
21 Oct 1, 2023
4 Aug 14, 2022