These examples demonstrate the main features of Bevy and how to use them.
To run an example, use the command cargo run --example <Example>, and add the option --features x11 or --features wayland to force the example to run on a specific window compositor, e.g.
cargo run --features wayland --example hello_worldDue to changes and additions to APIs, there are often differences between the development examples and the released versions of Bevy on crates.io.
If you are using a release version from crates.io, view the examples by checking out the appropriate git tag, e.g., users of 0.3 should use the examples on https://github.com/bevyengine/bevy/tree/v0.3.0/examples
If you have cloned bevy's repo locally, git checkout with the appropriate version tag.
git checkout v0.3.0
| Example | Main | Description |
|---|---|---|
hello_world |
hello_world.rs |
Runs a minimal example that outputs "hello world" |
| Example | Main | Description |
|---|---|---|
contributors |
2d/contributors.rs |
Displays each contributor as a bouncy bevy-ball! |
sprite_sheet |
2d/sprite_sheet.rs |
Renders an animated sprite |
sprite |
2d/sprite.rs |
Renders a sprite |
texture_atlas |
2d/texture_atlas.rs |
Generates a texture atlas (sprite sheet) from individual sprites |
| Example | File | Description |
|---|---|---|
3d_scene |
3d/3d_scene.rs |
Simple 3D scene with basic shapes and lighting |
load_gltf |
3d/load_gltf.rs |
Loads and renders a gltf file as a scene |
msaa |
3d/msaa.rs |
Configures MSAA (Multi-Sample Anti-Aliasing) for smoother edges |
parenting |
3d/parenting.rs |
Demonstrates parent->child relationships and relative transformations |
spawner |
3d/spawner.rs |
Renders a large number of cubes with changing position and material |
texture |
3d/texture.rs |
Shows configuration of texture materials |
z_sort_debug |
3d/z_sort_debug.rs |
Visualizes camera Z-ordering |
| Example | File | Description |
|---|---|---|
custom_loop |
app/custom_loop.rs |
Demonstrates how to create a custom runner (to update an app manually). |
empty_defaults |
app/empty_defaults.rs |
An empty application with default plugins |
empty |
app/empty.rs |
An empty application (does nothing) |
headless |
app/headless.rs |
An application that runs without default plugins |
logs |
app/logs.rs |
Illustrate how to use generate log output |
plugin_group |
app/plugin_group.rs |
Demonstrates the creation and registration of a custom plugin group |
plugin |
app/plugin.rs |
Demonstrates the creation and registration of a custom plugin |
return_after_run |
app/return_after_run.rs |
Show how to return to main after the Bevy app has exited |
thread_pool_resources |
app/thread_pool_resources.rs |
Creates and customizes the internal thread pool |
| Example | File | Description |
|---|---|---|
asset_loading |
asset/asset_loading.rs |
Demonstrates various methods to load assets |
custom_asset |
asset/custom_asset.rs |
Implements a custom asset loader |
hot_asset_reloading |
asset/hot_asset_reloading.rs |
Demonstrates automatic reloading of assets when modified on disk |
| Example | File | Description |
|---|---|---|
audio |
audio/audio.rs |
Shows how to load and play an audio file |
| Example | File | Description |
|---|---|---|
custom_diagnostic |
diagnostics/custom_diagnostic.rs |
Shows how to create a custom diagnostic |
print_diagnostics |
diagnostics/print_diagnostics.rs |
Add a plugin that prints diagnostics to the console |
| Example | File | Description |
|---|---|---|
ecs_guide |
ecs/ecs_guide.rs |
Full guide to Bevy's ECS |
event |
ecs/event.rs |
Illustrates event creation, activation, and reception |
hierarchy |
ecs/hierarchy.rs |
Creates a hierarchy of parents and children entities |
parallel_query |
ecs/parallel_query.rs |
Illustrates parallel queries with ParallelIterator |
startup_system |
ecs/startup_system.rs |
Demonstrates a startup system (one that runs once when the app starts up) |
| Example | File | Description |
|---|---|---|
breakout |
game/breakout.rs |
An implementation of the classic game "Breakout" |
| Example | File | Description |
|---|---|---|
char_input_events |
input/char_input_events.rs |
Prints out all chars as they are inputted. |
gamepad_input_events |
input/gamepad_input_events.rs |
Iterates and prints gamepad input and connection events |
gamepad_input |
input/gamepad_input.rs |
Shows handling of gamepad input, connections, and disconnections |
keyboard_input_events |
input/keyboard_input_events.rs |
Prints out all keyboard events |
keyboard_input |
input/keyboard_input.rs |
Demonstrates handling a key press/release |
mouse_input_events |
input/mouse_input_events.rs |
Prints out all mouse events (buttons, movement, etc.) |
mouse_input |
input/mouse_input.rs |
Demonstrates handling a mouse button press/release |
touch_input_events |
input/touch_input_events.rs |
Prints out all touch inputs |
touch_input |
input/touch_input.rs |
Displays touch presses, releases, and cancels |
| Example | File | Description |
|---|---|---|
properties |
scene/properties.rs |
Demonstrates Properties (similar to reflections in other languages) in Bevy |
scene |
scene/scene.rs |
Demonstrates loading from and saving scenes to files |
| Example | File | Description |
|---|---|---|
mesh_custom_attribute |
shader/mesh_custom_attribute.rs |
Illustrates how to add a custom attribute to a mesh and use it in a custom shader |
shader_custom_material |
shader/shader_custom_material.rs |
Illustrates creating a custom material and a shader that uses it |
shader_defs |
shader/shader_defs.rs |
Demonstrates creating a custom material that uses "shaders defs" (a tool to selectively toggle parts of a shader) |
| Example | File | Description |
|---|---|---|
bevymark |
tools/bevymark.rs |
A heavy workload to use to see how far Bevy can push your system |
| Example | File | Description |
|---|---|---|
button |
ui/button.rs |
Illustrates creating and updating a button |
font_atlas_debug |
ui/font_atlas_debug.rs |
Illustrates how FontAtlases are populated (used to optimize text rendering internally) |
text_debug |
ui/text_debug.rs |
An example for debugging text layout |
text |
ui/text.rs |
Illustrates creating and updating text |
ui |
ui/ui.rs |
Illustrates various features of Bevy UI |
| Example | File | Description |
|---|---|---|
clear_color |
window/clear_color.rs |
Creates a solid color window |
multiple_windows |
window/multiple_windows.rs |
Creates two windows and cameras viewing the same mesh |
window_settings |
window/window_settings.rs |
Demonstrates customizing default window settings |
rustup target add aarch64-linux-android armv7-linux-androideabi
cargo install cargo-apkThe Android SDK must be installed, and the environment variable ANDROID_SDK_ROOT set to the root Android sdk folder.
When using NDK (Side by side), the environment variable ANDROID_NDK_ROOT must also be set to one of the NDKs in sdk\ndk\[NDK number].
To run on a device setup for Android development, run:
cargo apk run --example androidWhen using Bevy as a library, the following fields must be added to Cargo.toml:
[package.metadata.android]
build_targets = ["aarch64-linux-android", "armv7-linux-androideabi"]
target_sdk_version = 29
min_sdk_version = 16Please reference cargo-apk README for other Android Manifest fields.
Bevy by default targets Android API level 29 in its examples which is the Play Store's minimum API to upload or update apps. Users of older phones may want to use an older API when testing.
To use a different API, the following fields must be updated in Cargo.toml:
[package.metadata.android]
target_sdk_version = >>API<<
min_sdk_version = >>API or less<<rustup target add aarch64-apple-ios x86_64-apple-ios
cargo install cargo-lipoUsing bash:
cd examples/ios
make runIn an ideal world, this will boot up, install and run the app for the first
iOS simulator in your xcrun simctl devices list. If this fails, you can
specify the simulator device UUID via:
DEVICE_ID=${YOUR_DEVICE_ID} make runIf you'd like to see xcode do stuff, you can run
open bevy_ios_example.xcodeproj/which will open xcode. You then must push the zoom zoom play button and wait for the magic.
The Xcode build GUI will by default build the rust library for both
x86_64-apple-ios, and aarch64-apple-ios which may take a while. If you'd
like speed this up, you update the IOS_TARGETS User-Defined environment
variable in the "cargo_ios target" to be either x86_64-apple-ios or
aarch64-applo-ios depending on your goal.
Note: if you update this variable in Xcode, it will also change the default
used for the Makefile.
rustup target add wasm32-unknown-unknown
cargo install wasm-bindgen-cliFollowing is an example for headless_wasm. For other examples in wasm/ directory,
change the headless_wasm in the following commands and edit examples/wasm/index.html
to point to the correct .js file.
cargo build --example headless_wasm --target wasm32-unknown-unknown --no-default-features
wasm-bindgen --out-dir examples/wasm/target --target web target/wasm32-unknown-unknown/debug/examples/headless_wasm.wasmThen serve examples/wasm dir to browser. i.e.
basic-http-server examples/wasm| Example | File | Description |
|---|---|---|
hello_wasm |
wasm/hello_wasm.rs |
Runs a minimal example that logs "hello world" to the browser's console |
headless_wasm |
wasm/headless_wasm.rs |
Sets up a schedule runner and continually logs a counter to the browser's console |
assets_wasm |
wasm/assets_wasm.rs |
Demonstrates how to load assets from wasm |
winit_wasm |
wasm/winit_wasm.rs |
Logs user input to the browser's console. Requires the bevy_winit features |