bevy/examples

Examples

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_world

⚠️ Note: for users of releases on crates.io,

Due 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

---

Table of Contents

• The Bare Minimum
  • Hello, World!
• Cross-Platform Examples
  • 2D Rendering
  • 3D Rendering
  • Application
  • Assets
  • Audio
  • Diagnostics
  • ECS (Entity Component System)
  • Games
  • Input
  • Scene
  • Shaders
  • Tools
  • UI (User Interface)
  • Window
• Platform-Specific Examples
  • Android
  • iOS
  • WASM

The Bare Minimum

Hello, World!

Example	Main	Description
hello_world	hello_world.rs	Runs a minimal example that outputs "hello world"

Cross-Platform Examples

2D Rendering

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

3D Rendering

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

Application

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

Assets

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

Audio

Example	File	Description
audio	audio/audio.rs	Shows how to load and play an audio file

Diagnostics

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

ECS (Entity Component System)

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)

Games

Example	File	Description
breakout	game/breakout.rs	An implementation of the classic game "Breakout"

Input

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

Scene

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

Shaders

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)

Tools

Example	File	Description
bevymark	tools/bevymark.rs	A heavy workload to use to see how far Bevy can push your system

UI (User Interface)

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

Window

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

Platform-Specific Examples

Android

Setup

rustup target add aarch64-linux-android armv7-linux-androideabi
cargo install cargo-apk

The 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].

Build & Run

To run on a device setup for Android development, run:

cargo apk run --example android

⚠️ At this time Bevy does not work in Android Emulator.

When 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 = 16

Please reference cargo-apk README for other Android Manifest fields.

Old phones

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

iOS

Setup

rustup target add aarch64-apple-ios x86_64-apple-ios
cargo install cargo-lipo

Build & Run

Using bash:

cd examples/ios
make run

In 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 run

If 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.

WASM

Setup

rustup target add wasm32-unknown-unknown
cargo install wasm-bindgen-cli

Build & Run

Following 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.wasm

Then 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