#bevy-plugin #single-file #bevy #gamedev #resources #preferences #ron

bevy_simple_prefs

A small Bevy plugin for persisting multiple Resources to a single file

4 releases (breaking)

new 0.4.0 Nov 30, 2024
0.3.0 Jul 26, 2024
0.2.0 Jul 16, 2024
0.1.0 Jul 4, 2024

#993 in Game dev

Download history 5/week @ 2024-09-20 5/week @ 2024-09-27 5/week @ 2024-10-04 1/week @ 2024-10-11 7/week @ 2024-11-01 3/week @ 2024-11-08 134/week @ 2024-11-29

139 downloads per month

MIT/Apache

36KB
170 lines

bevy_simple_prefs

crates.io docs Following released Bevy versions

An unambitious Bevy plugin for persisting multiple Bevy Resources into a single preferences file, suitable for small projects like jam games.

  • Persists to a single ron file
  • Does IO in Bevy's async task pool
  • WASM compatible

Usage

  • Derive Prefs on a struct with members that are Resources you want to be saved
  • Simply modify your Resources to initiate a save
  • Write code that reacts to those Resources changing, if you want

See examples/prefs.rs

Compatibility

bevy_simple_prefs bevy
0.4 0.15
0.1-0.3 0.14

Contributing

Please feel free to open a PR, but keep in mind this project's goals. This is meant to be a very lightweight crate. There should be zero additional dependencies on other Bevy ecosystem crates.

Please keep PRs small and scoped to a single feature or fix.

Alternatives

If you need more features, check out bevy-persistent or bevy-settings. There are also a few other options in the persistence section of Bevy Assets.

Dependencies

~30–41MB
~678K SLoC