#bevy #gamedev #file #save

bevy_simple_prefs

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

6 releases (breaking)

Uses new Rust 2024

0.5.1 May 5, 2025
0.5.0 Apr 25, 2025
0.4.0 Nov 30, 2024
0.3.0 Jul 26, 2024
0.1.0 Jul 4, 2024

#1219 in Game dev

Download history 5/week @ 2025-01-31 2/week @ 2025-02-07 36/week @ 2025-02-14 7/week @ 2025-02-21 11/week @ 2025-02-28 54/week @ 2025-04-04 124/week @ 2025-04-25 212/week @ 2025-05-02 133/week @ 2025-05-09 28/week @ 2025-05-16

497 downloads per month

MIT/Apache

38KB
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.5 0.16
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

~39MB
~675K SLoC