bevy-persistent 0.10.0

A Bevy helper to easily manage resources that need to persist across game sessions.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

use bevy::{
    app::AppExit,
    log,
    prelude::*,
};
use bevy_persistent::prelude::*;
use serde::{
    Deserialize,
    Serialize,
};
use std::path::Path;

#[derive(Debug, Deserialize, Resource, Serialize)]
struct KeyBindings {
    jump: KeyCode,
    crouch: KeyCode,
}

fn main() {
    App::new()
        .add_plugins(
            // We don't need a window for this example.
            DefaultPlugins.set(WindowPlugin { primary_window: None, ..Default::default() }),
        )
        .add_systems(Startup, setup)
        .add_systems(
            Update,
            (show_initial_key_bindings, switch_crouch_key, show_final_key_bindings, exit).chain(),
        )
        .run();
}

fn setup(mut commands: Commands) {
    let config_dir = dirs::config_dir()
        .map(|native_config_dir| native_config_dir.join("bevy-persistent"))
        .unwrap_or(Path::new("session").join("configuration"))
        .join("examples")
        .join("alternating-crouch-key");

    commands.insert_resource(
        Persistent::<KeyBindings>::builder()
            .name("key bindings")
            .format(StorageFormat::Toml)
            .path(config_dir.join("key-bindings.toml"))
            .default(KeyBindings { jump: KeyCode::Space, crouch: KeyCode::KeyC })
            .revertible(true)
            .revert_to_default_on_deserialization_errors(true)
            .build()
            .expect("failed to initialize key bindings"),
    )
}

fn show_initial_key_bindings(key_bindings: Res<Persistent<KeyBindings>>) {
    log::info!("initial key bindings: {:?}", key_bindings.get());
}

fn switch_crouch_key(mut key_bindings: ResMut<Persistent<KeyBindings>>) {
    key_bindings
        .update(|key_bindings| {
            key_bindings.crouch = match key_bindings.crouch {
                KeyCode::KeyC => KeyCode::ControlLeft,
                KeyCode::ControlLeft => KeyCode::KeyC,
                _ => unimplemented!(),
            }
        })
        .expect("failed to update key bindings");
}

fn show_final_key_bindings(key_bindings: Res<Persistent<KeyBindings>>) {
    log::info!("final key bindings: {:?}", key_bindings.get());
}

fn exit(mut exit: MessageWriter<AppExit>) {
    exit.write(AppExit::Success);
}