https://github.com/vleue/bevy_embedded_assets

Embed assets in your Bevy game
https://github.com/vleue/bevy_embedded_assets

asset-management assets bevy bevy-plugin rust

Last synced: 2 months ago
JSON representation

Embed assets in your Bevy game

• Host: GitHub
• URL: https://github.com/vleue/bevy_embedded_assets
• Owner: vleue
• Created: 2022-01-03T18:01:03.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-28T22:23:32.000Z (3 months ago)
• Last Synced: 2025-04-28T22:51:24.925Z (3 months ago)
• Topics: asset-management, assets, bevy, bevy-plugin, rust
• Language: Rust
• Homepage:
• Size: 64.5 KB
• Stars: 180
• Watchers: 2
• Forks: 12
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Bevy Embedded Assets

![MIT/Apache 2.0](https://img.shields.io/badge/license-MIT%2FApache-blue.svg)

[![Realease Doc](https://docs.rs/bevy_embedded_assets/badge.svg)](https://docs.rs/bevy_embedded_assets)

[![Crate](https://img.shields.io/crates/v/bevy_embedded_assets.svg)](https://crates.io/crates/bevy_embedded_assets)

[![Bevy Tracking](https://img.shields.io/badge/Bevy%20tracking-main-lightblue)](https://github.com/bevyengine/bevy/blob/main/docs/plugins_guidelines.md#main-branch-tracking)

[![CI](https://github.com/vleue/embedded_assets/actions/workflows/ci.yaml/badge.svg)](https://github.com/vleue/embedded_assets/actions/workflows/ci.yaml)

Embed your asset folder inside your binary for easier releases.

```rust

use bevy::prelude::*;

use bevy_embedded_assets::EmbeddedAssetPlugin;

fn main() {

    App::new().add_plugins((EmbeddedAssetPlugin::default(), DefaultPlugins));

}

```

`EmbeddedAssetPlugin` has three modes:

* `PluginMode::AutoLoad` will embed the asset folder and make it available through the `embedded://` source

* `PluginMode::ReplaceDefault` will embed the asset folder and make it available through the default source

* `PluginMode::ReplaceAndFallback` will embed the asset folder and make it available through the default source. If a fail is not found at runtime, it fallback to the default source for the current platform

## Bevy Compatibility

|Bevy|bevy_embedded_assets|

|---|---|

|main|main|

|0.16|0.13|

|0.15|0.12|

|0.14|0.11|

|0.13|0.10|

|0.12|0.9|

|0.11|0.8|

|0.10|0.7|

|0.9|0.6|

|0.8|0.4|

|0.7|0.3|

|0.6|0.2|

|0.5|0.1|