6 releases (breaking)

0.6.0 Nov 13, 2022
0.5.0 Sep 10, 2022
0.4.0 May 4, 2022
0.3.0 Jan 18, 2022
0.1.0 May 29, 2021

#3 in #ggpo

Download history 14/week @ 2024-02-19 11/week @ 2024-02-26 3/week @ 2024-03-04 8/week @ 2024-03-11 1/week @ 2024-03-25 76/week @ 2024-04-01

86 downloads per month
Used in 2 crates (via bevy_backroll)

ISC license

140KB
3K SLoC

backroll-rs

crates.io Documentation License Discord

Backroll is a pure Rust implementation of GGPO-style rollback networking.

Development Status

This is still in an early beta stage. At time of writing, the public facing API is stable, and has undergone limited testing. There may still be notable bugs that have not been found yet.

Differences with the C++ implementation

  • (Almost) 100% pure safe Rust. No unsafe pointer manipulation.
  • Type safety. backroll-rs heavily utilizes generics and associated types to avoid serialization overhead and potentially unsafe type conversions when saving and loading game state.
  • Abstracted transport layer protocols - integrate and use any transport layer library you need. Comes with a raw UDP socket based implementation.
  • Configurable at runtime - Many of the hard-coded constants in GGPO are exposed as configuration parameters during session initialization.
  • Reduced memory usage - Backroll's use of generics potentially shrinks down the sizes of many data types.
  • Vectorized input compression scheme - Backroll utilizes the same XOR + RLE encoding, but it's written to maximize CPU utilization.
  • Multithreaded I/O - All network communications run within an async task pool. I/O polling is no longer manual, nor blocks your game's execution.

Dependencies

~4–12MB
~116K SLoC