This Bevy plugin tries to tackle the problem of asset dependencies for states. For example, you have ```rs enum AppState { Splash, .. }
struct SplashAssets { .. }
``
and you want to make sureSplashAssetsis available beforeSplashis entered and also get cleaned upSplashAssetswhenSplash` is exited.
See the basic example for a complete usage. But in general, it is like
State```rs use coveyassetloader::prelude::*;
// implement AssetState
enum AppState {
#[default]
Boot,
#[assets(SplashAssets)]
Splash,
#[assets(MainMenuAssets)]
MainMenu,
// no it doesn't support multiple assets
// #[assets(InGameAssets1, InGameAssets2)]
InGame,
}
```
Assets```rs // implement AssetCollection , Resource and Reflect
struct SplashAssets {
#[asset(path = "fonts/FiraSans-Bold.ttf")]
font1: Handle,
#[asset(path = "audio/breakout_collision.ogg")]
audio1: Handle
rs
impl Plugin for SplashPlugin {
fn build(&self, app: &mut App) {
app
// Required, load SplashAssets for AppState
.state_asset_loader::<SplashAssets, AppState>()
// Optional, release SplashAssets when it exits AppState::Splash after `GlobalAssetCleanUpTimer` has finished, default is 5 seconds.
.cleanup_assets_on_exit::<SplashAssets>(AppState::Splash)
// Optional, if specified, will override `GlobalAssetCleanUpTimer` for this specific Resrouce, in this case, SplashAssets will be released after 2 seconds.
.insert_resource(AssetCleanUpTimer::<SplashAssets>(
Timer::from_seconds(2.0, TimerMode::Once),
PhantomData,
))
}
}
Unfortunately to make it work, you have to use ScheduleNextState instead of NextState to change state. It is not a feature but a workaround of the limitation of Bevy
rs
fn system(
mut schedule_state: ResMut<ScheduleNextState<AppState>>,
) {
schedule_state.set(AppState::MainMenu);
}