rantz_proto 1.2.4

An opinionated rust library for transforming on-disk assets into Entities in Bevy.
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89

use crate::prelude::*;
use bevy::prelude::*;
use serde::Deserialize;
use std::path::PathBuf;

/// Extension for App for registering prototypes
pub trait RegisterPrototype {
    /// Add a prototype to the app. This will load the manifest,
    /// and insert the prototype into the `PrototypeLibrary`
    fn add_prototype<M: Manifest<Output = P>, P: Prototype>(
        &mut self,
        path: impl Into<PathBuf>,
    ) -> &mut Self;
}

impl RegisterPrototype for App {
    fn add_prototype<M: Manifest<Output = P>, P: Prototype>(
        &mut self,
        path: impl Into<PathBuf>,
    ) -> &mut Self {
        // Init Assets & Resources
        self.init_asset::<M>();
        self.init_resource::<PrototypeLibrary<P>>();
        check_insert_loader(self.world_mut());
        let mut loader = self.world_mut().resource_mut::<ManifestLoader>();
        loader.register::<M>(path);

        // Add child plugins for asset loading
        add_plugins::<ManifestCollection<M>>(self);

        // Add processing system
        self.add_systems(
            Update,
            (load::<M>, track_asset::<M, P>)
                .chain()
                .in_set(ProtoSchedule::Loading),
        );

        // If hot reloading then register the rebuild system
        #[cfg(feature = "hot_reload")]
        register_rebuild_system::<P>(self.world_mut());

        self
    }
}

fn add_plugins<T: AccessManifestFormat + Clone + Asset + for<'de> Deserialize<'de>>(app: &mut App) {
    match T::manifest_format() {
        #[cfg(feature = "ron")]
        ManifestFormat::Ron => {
            app.add_plugins(bevy_common_assets::ron::RonAssetPlugin::<T>::new(&[]));
        }
        #[cfg(feature = "json")]
        ManifestFormat::Json => {
            app.add_plugins(bevy_common_assets::json::JsonAssetPlugin::<T>::new(&[]));
        }
        #[cfg(feature = "yaml")]
        ManifestFormat::Yaml => {
            app.add_plugins(bevy_common_assets::yaml::YamlAssetPlugin::<T>::new(&[]));
        }
        #[cfg(feature = "toml")]
        ManifestFormat::Toml => {
            app.add_plugins(bevy_common_assets::toml::TomlAssetPlugin::<T>::new(&[]));
        }
        #[cfg(feature = "csv")]
        ManifestFormat::Csv => {
            app.add_plugins(bevy_common_assets::csv::CsvAssetPlugin::<T>::new(&[]));
        }
        #[cfg(feature = "xml")]
        ManifestFormat::Xml => {
            app.add_plugins(bevy_common_assets::xml::XmlAssetPlugin::<T>::new(&[]));
        }
        #[cfg(feature = "msgpack")]
        ManifestFormat::MsgPack => {
            app.add_plugins(bevy_common_assets::msgpack::MsgPackAssetPlugin::<T>::new(
                &[],
            ));
        }
        ManifestFormat::Custom => (), /* Users must register their own asset loader for custom
                                       * formats. */
    }
}

fn check_insert_loader(world: &mut World) {
    if world.get_resource::<ManifestLoader>().is_none() {
        let loader = ManifestLoader::new();
        world.insert_resource(loader);
    }
}