8 unstable releases (3 breaking)

0.9.0 Jul 24, 2024
0.8.0 Feb 19, 2024
0.7.2 May 12, 2022
0.7.1 Apr 22, 2022
0.6.2 Feb 23, 2022

#173 in Network programming

Download history 1/week @ 2024-08-20 6/week @ 2024-08-27 2/week @ 2024-09-17 14/week @ 2024-09-24 5/week @ 2024-10-01 2/week @ 2024-10-08 3/week @ 2024-10-15 5/week @ 2024-10-29 44/week @ 2024-11-05 29/week @ 2024-11-12 11/week @ 2024-11-19

89 downloads per month
Used in bevy_eventwork_mod_websoc…

MIT license

64KB
966 lines

bevy_eventwork is a solution to the "How do I connect multiple bevy instances" problem in your bevy games, forked from the excellent bevy_spicy_networking, with significant changes for modularity and including the removal of big dependencies like tokio and typetag.

Contents

Documentation

You can check out the online documentation, or build it yourself by cloning this repo and running cargo doc -p bevy_eventwork.

For examples, check out the examples directory.

  • In server.rs you will find a simple chat server, that broadcasts the messages it receives from clients
  • In client.rs you will find a simple graphical chat client, where you can connect to a server and send messages to

(Note: Since bevy does not include a text input widget, it is a very simplified demo. This should be easy to extend once the UI part of bevy is more complete.)

Quickstart

  1. Add bevy_eventwork, and serde to your Cargo.toml
  2. Create the messages you wish to exchange beetween a client and server, or vice-versa.
    • Implement Serialize and Deserialize from Serde on it
    • Implement NetworkMessage
#[derive(Serialize, Deserialize)]
struct WhisperMessage {
    recipient: UserId,
    message: String,
}

/// In this example, we'll be sending this from a client to a server,
/// BUT, any eventwork bevy instance could recieve the message as
/// long as they register to listen for it.
impl NetworkMessage for WhisperMessage {
    const NAME: &'static str = "example:WhisperMessage";
}
  1. On the recipient side, set-up the app and register the type to be received
use bevy_eventwork::{AppNetworkMessage, tcp::TcpProvider};

fn main() {
    let mut app = App::new();

    /// Add the EventworkPlugin specifying what Transport to use and what runtime
    app.add_plugins(bevy_eventwork::EventworkPlugin::<
        TcpProvider,
        bevy::tasks::TaskPool,
    >::default());

    /// Insert your desired runtime pool into the app wrapped in EventworkRuntime
    app.insert_resource(EventworkRuntime(
        TaskPoolBuilder::new().num_threads(2).build(),
    ));

    /// Register any messages to be heard
    ///
    /// Now whenever a client sends a `WhisperMessage` the server will generate an event of
    /// `NetworkData<WhisperMessage>` which your application can then handle
    app.listen_for_message::<WhisperMessage, TcpProvider>();
}
  1. Listen for events of that type
fn handle_incoming_whisper_messages(
    mut whisper_messages: EventReader<NetworkMessage<WhisperMessage>>,
) {
    for whisper_message in whisper_messages.iter() {
        // Handle the whisper
    }
}

Request/Response

Starting with version 0.7.1, you can now automatically handle Request/Response style messaging with event work! Check the documentation for more info!

Bevy Version Compatibility

Simply pick the version compatible to your bevy version:

Bevy Eventwork Bevy
0.9 0.14
0.8 0.13
0.7 0.8

Any version that is not compatible with the latest bevy version is in maintenance mode. It will only receive minor bug fixes from my side, or community supplied ones.

Supported Platforms

  • Linux
  • Windows
  • WASM (With a Wasm compatible transport provider like BEMW)

The above three platforms are officially supported. MacOS should work but I do not have a Mac to test. If you have a Mac, and wish to test it out and report back, please let me know!

Roadmap

  • General code cleanup, testing, and documentation work
  • Message wide event pipelines
    • Useful for mapping connection id to user provided ids
  • Message type mapping
    • Currently the message type is sent as a string with each method, it would be nice if you could just send a few bytes instead.
  • RPCs!

Crates using bevy_eventwork

Currently none, you can help by expanding this list. Just send a PR and add it to the table below!

Name Version
- -

Transport providers for bevy_eventwork

Name Version
eventwork_tcp (included) 0.9
bevy_eventwork_mod_websockets (LINK) 0.2

Contributing

To contribute, simply fork the repository and send a PR.

Feel free to chat me up on the bevy discord under @SirCarter#8209 if you have any questions, suggestions, or I'm not looking into your PR fast enough and you need someone to yell at (respectfully of course).

Dependencies

~36–74MB
~1.5M SLoC