9 breaking releases
| 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 |
#1735 in Network programming
862 downloads per month
Used in nano9
91KB
234 lines
Bevy Web Asset
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
- MIT License (./LICENSE-MIT or http://opensource.org/licenses/MIT)
- Apache License, Version 2.0 (./LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
at your option.
Contributions
PRs welcome!
Dependencies
~29–53MB
~859K SLoC