Bundled assets for Bevy

Features

• Uses assets from the local filesystem if present for easy development, falls back to bundled assets only for those that aren't found locally.
• Provides an easy to use inline_assets! macro for bundling assets (or the API can be used directly instead).

Status

Works for the latest Bevy commit on GitHub as of 2020-11-02 (f81208ad); it does not work with Bevy 0.2.1 from crates.io and it will likely need to be updated as underlying APIs change at least until the next release of Bevy on crates.io. See Bevy issue 606 and the linked PRs for discussion of native Bevy support for bundling assets.

Installation

shell cargo add bevy_prototype_inline_assets --git https://github.com/emosenkis/bevy_prototype_inline_assets --branch main

or, in your Cargo.toml:

toml bevy = { git = "https://github.com/bevyengine/bevy" } bevy_prototype_inline_assets = { git = "https://github.com/emosenkis/bevy_prototype_inline_assets", branch = "main" }

Usage

``` rust use bevy::asset::{AssetPlugin, LoadState}; use bevy::prelude::*; use bevyprototypeinlineassets::{inlineassets, InlineAssets, InlineAssetsPlugin}; use std::collections::HashMap; use std::path::Path;

fn main() { let inlineassets = inlineassets![ "assets/image.png", "assets/font.ttf", "assets/audio.mp3", ... ]; App::build() .addresource(inlineassets) .addplugingroupwith(DefaultPlugins, |group| { group.addafter::(InlineAssetsPlugin) }) .initresource::>() .addstartupsystem(setup.system()) .addsystem(spawn.system()) .run(); }

fn setup( mut commands: Commands, inlineassets: Res, assetserver: Res, mut inlineassethandles: ResMut>, ) { *inlineassethandles = inlineassets.loadall(asset_server); }

fn spawn( mut commands: Commands, inlineassethandles: Res>, assetserver: Res, loaded: Local, ) { if *loaded || assetserver.getgrouploadstate(inlineassethandles.values().map(|h| h.id)) != LoadState::Loaded { return; } let handle = inlineasset_handles.get(Path::new("assets/image.png")).unwrap().clone().typed(); ... } ```