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

bevy_simple_prefs

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

3 releases (breaking)

0.3.0 Jul 26, 2024
0.2.0 Jul 16, 2024
0.1.0 Jul 4, 2024

#1102 in Game dev

MIT/Apache

34KB
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.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

~31MB
~569K SLoC