9 breaking releases

new 0.11.0 May 3, 2025
0.10.1 Feb 1, 2025
0.9.0 Aug 2, 2024
0.8.0 Feb 22, 2024
0.1.0 Sep 18, 2021

#756 in Game dev

Download history 10/week @ 2025-01-08 2/week @ 2025-01-15 134/week @ 2025-01-29 54/week @ 2025-02-05 77/week @ 2025-02-12 7/week @ 2025-02-19 75/week @ 2025-02-26 7/week @ 2025-03-05 26/week @ 2025-03-12 3/week @ 2025-03-19 10/week @ 2025-03-26 10/week @ 2025-04-02 16/week @ 2025-04-09 9/week @ 2025-04-16 26/week @ 2025-04-23

62 downloads per month
Used in bevy_gaussian_splatting

MIT/Apache

91KB
234 lines

Bevy Web Asset

crates.io MIT/Apache 2.0 crates.io docs.rs

This is a tiny crate that that adds the ability to load assets from http and https urls.

Supports both wasm (web-sys) and native.

This is nice if you want to keep your content on a server, even when developing native games. Use cases can be:

  • Tuning game balance post-launch
  • Seasonal events (halloween theme etc.)
  • Downloading dynamic content from 3rd party services (lospec, gltf repositories etc.)
  • Sharing user-created assets/mods over some service (level editor etc.)
  • Keeping initial download size small
  • Testing with different online assets during development

Usage

NOTE: You need to add the plugin before AssetPlugin:

use bevy::prelude::*;
use bevy_web_asset::WebAssetPlugin;

fn main() {
    App::new()
        // The `WebAssetPlugin` must be inserted before the `AssetPlugin`
        .add_plugins((
            WebAssetPlugin::default(),
            DefaultPlugins
        ))
        // ...
        .run();
}

But using it is quite simple, just use http urls instead of regular asset paths.

let font: Handle<Font> = asset_server.load("https://example.com/fonts/quicksand-light.ttf");

Or:

commands.spawn(SpriteBundle {
    // Simply use a url where you would normally use an asset folder relative path
    texture: asset_server.load("https://johanhelsing.studio/assets/favicon.png"),
    ..default()
});

Bevy version support

I intend to support the latest bevy release in the main branch.

bevy bevy_web_asset
0.16 0.11, main
0.15 0.10,
0.14 0.9,
0.13 0.8
0.12 0.7
0.9 0.5
0.8 0.4
0.7 0.3
0.6 0.2
0.5 0.1

License

bevy_web_asset is dual-licensed under either

at your option.

Contributions

PRs welcome!

Dependencies

~22–39MB
~728K SLoC