Bevy plugin for the GGRS P2P rollback networking library. The plugin creates a custom stage with a separate schedule, which handles correctly advancing the gamestate, including rollbacks. It efficiently handles saving and loading of the gamestate by only snapshotting relevant parts of the world, as defined by the user. It is supposed to work with the latest released version of bevy.
For explanation on how to use it, check the 👉examples!
Due to exciting upcoming stageless scheduling This whole plugin will have to be reworked from the ground up (Once it is there). Since I am not happy with using bevy-reflect to save and load snapshots of the world, I am looking forward to this refactoring!
bevy_GGRS has a demo app you can try in the browser! It uses matchbox to facilitate communication between browsers. Try it out with a friend! Just click the link and match with another player! (You can also open the link in two separate windows to play against yourself)
The GGRS plugin creates a custom GGRSStage which owns a separate schedule. Inside this schedule, the user can add stages and systems as they wish.
When the default schedule runs the GGRSStage, it polls the session and executes resulting GGRSRequests, such as loading, saving and advancing the gamestate.
- advancing the gamestate is done by running the internal schedule once.
- saving the gamestate is done by creating a snapshot of entities tagged with a
bevy_ggrs::Rollbackcomponent and saving only the components that were registered throughregister_rollback_type::<YourCoolComponent>(). The plugin internally keeps track of the snapshots together with the GGRS session. - loading the gamestate applies the snapshot by overwriting, creating and deleting entities tagged with a
bevy_ggrs::Rollbackcomponent and updating the registered components values.
Since bevy_ggrs operates with a separate schedule, compatibility with other plugins might be complicated to achieve out of the box, as all gamestate-relevant systems needs to somehow end up inside the internal GGRS schedule to be updated together the rest of the game systems.
| bevy | bevy_ggrs | ggrs |
|---|---|---|
| 0.8 | main | main |
| 0.8 | 0.10 | 0.9 |
| 0.6 | 0.9 | 0.9 |
to bevy_backroll and bevy_rollback for figuring out pieces of the puzzle that made bevy_GGRS possible. Special thanks to the helpful folks in the bevy discord, providing useful help and pointers all over the place.
Bevy_GGRS is dual-licensed under either
- MIT License: Also available online
- Apache License, Version 2.0: Also available online
at your option.