https://github.com/johanhelsing/bevy_web_asset
Bevy asset loader that transparently supports loading over http(s)
https://github.com/johanhelsing/bevy_web_asset
bevy bevy-plugin rust wasm
Last synced: 10 months ago
JSON representation
Bevy asset loader that transparently supports loading over http(s)
- Host: GitHub
- URL: https://github.com/johanhelsing/bevy_web_asset
- Owner: johanhelsing
- License: apache-2.0
- Created: 2021-09-18T08:06:47.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-05-03T21:21:58.000Z (about 1 year ago)
- Last Synced: 2025-08-14T02:59:24.110Z (11 months ago)
- Topics: bevy, bevy-plugin, rust, wasm
- Language: Rust
- Homepage:
- Size: 106 KB
- Stars: 92
- Watchers: 2
- Forks: 23
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# Bevy Web Asset
[](https://crates.io/crates/bevy_web_asset)
[](https://crates.io/crates/bevy_web_asset)
[](https://docs.rs/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`:
```rust no_run
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.
```rust ignore
let font: Handle = asset_server.load("https://example.com/fonts/quicksand-light.ttf");
```
Or:
```rust ignore
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!