Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gschup/ggrs
GGRS is a reimagination of GGPO, enabling P2P rollback networking in Rust. Rollback to the future!
https://github.com/gschup/ggrs
gamedev ggpo networking rollback rust
Last synced: about 1 month ago
JSON representation
GGRS is a reimagination of GGPO, enabling P2P rollback networking in Rust. Rollback to the future!
- Host: GitHub
- URL: https://github.com/gschup/ggrs
- Owner: gschup
- License: other
- Created: 2021-04-13T13:30:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-23T15:29:36.000Z (5 months ago)
- Last Synced: 2024-04-24T17:32:48.049Z (5 months ago)
- Topics: gamedev, ggpo, networking, rollback, rust
- Language: Rust
- Homepage:
- Size: 1.31 MB
- Stars: 482
- Watchers: 12
- Forks: 24
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# [![GGRS LOGO](./ggrs_logo.png)](https://github.com/gschup/ggrs)
[![crates.io](https://img.shields.io/crates/v/ggrs?style=for-the-badge)](https://crates.io/crates/ggrs)
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/gschup/ggrs/rust.yml?branch=main&style=for-the-badge)## P2P Rollback Networking in Rust
GGRS (good game rollback system) is a reimagination of the [GGPO network SDK](https://www.ggpo.net/) written in 100% safe [Rust 🦀](https://www.rust-lang.org/). The callback-style API from the original library has been replaced with a much saner, simpler control flow. Instead of registering callback functions, GGRS returns a list of requests for the user to fulfill.
If you are interested in integrating rollback networking into your game or just want to chat with other rollback developers (not limited to Rust), check out the [GGPO Developers Discord](https://discord.com/invite/8FKKhCRCCE)!
## Live Demonstrations
GGRS has two demo apps you can try in the browser! One written with [macroquad](https://github.com/not-fl3/macroquad), the other written with [bevy](https://bevyengine.org/). Both use [matchbox](https://github.com/johanhelsing/matchbox). 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)
🚧 MATCHMAKING CURRENTLY OFFLINE! 🚧
- [Bevy Demo](https://gschup.github.io/bevy_ggrs_demo/) ([Repository](https://github.com/gschup/bevy_ggrs_demo))
- [Macroquad Demo](https://gschup.github.io/ggrs_demo/) ([Repository](https://github.com/gschup/ggrs_demo))## Projects using GGRS
- [Jumpy](https://github.com/fishfolk/jumpy)
- [Gamercade](https://gamercade.io/)
- [NES-bundler](https://github.com/tedsteen/nes-bundler)
- [Girls with Swords](https://github.com/trian-gles/Girls-with-swords-GGRS) ([gameplay footage](https://youtu.be/TFJSpAqXtiI))
- [NieR Automata: Online](https://git.yasupa.de/jasper3108/NAMS-mp) ([Youtube](https://www.youtube.com/@nieronline))## Getting Started
To get started with GGRS, check out the following resources:
- [Wiki](https://github.com/gschup/ggrs/wiki)
- [Examples](./examples/)
- [Documentation](https://docs.rs/ggrs/newest/ggrs/)## Development Status
GGRS is in an early stage, but the main functionality for multiple players and spectators should be quite stable. See the Changelog for the latest changes, even those yet unreleased on crates.io! If you want to contribute, check out existing issues, as well as the contribution guide!
- [Changelog](./CHANGELOG.md)
- [Issues](https://github.com/gschup/ggrs/issues)
- [Contribution Guide](./CONTRIBUTING.md)## Useful Links
### Bevy Plugin
The authors of GGRS are also maintaining a [bevy](https://bevyengine.org/) plugin. Check it out:
- [Bevy GGRS](https://github.com/gschup/bevy_ggrs)
### WASM support through WebRTC sockets
If you are interested to run a GGRS application in your browser, check the amazing Matchbox project!
The matchbox sockets are compatible with GGRS through a feature flag:- [Matchbox](https://github.com/johanhelsing/matchbox)
### Godot Wrapper
[Godot](https://godotengine.org/) is a popular open-source game engine. marcello505 is developing a wrapper for GGRS.
Find the repository here:- [Godot GGRS Wrapper](https://github.com/marcello505/godot-ggrs-wrapper)
### Other Rollback Implementations in Rust
Also take a look at the awesome backroll project, a completely async rollback library. Special thanks to james7132 for a lot of inspiration and fruitful discussion.
- [backroll-rs](https://github.com/HouraiTeahouse/backroll-rs/)
## Licensing
GGRS is dual-licensed under either
- [MIT License](./LICENSE-MIT): Also available [online](http://opensource.org/licenses/MIT)
- [Apache License, Version 2.0](./LICENSE-APACHE): Also available [online](http://www.apache.org/licenses/LICENSE-2.0)at your option.