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: 5 days 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 (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-02-24T14:02:52.000Z (10 months ago)
• Last Synced: 2024-03-23T14:03:13.052Z (9 months ago)
• Topics: bevy, bevy-plugin, rust, wasm
• Language: Rust
• Homepage:
• Size: 91.8 KB
• Stars: 59
• Watchers: 3
• Forks: 15
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# Bevy Web Asset

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

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

[![crates.io](https://img.shields.io/crates/d/bevy_web_asset.svg)](https://crates.io/crates/bevy_web_asset)

[![docs.rs](https://img.shields.io/docsrs/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.14|0.9, main     |

|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!