Expand description
This crate is about everything concerning the highest-level, application layer of a Bevy app.
Re-exports§
pub use ctrlc;
Modules§
- prelude
- The app prelude.
Macros§
- plugin_
group - A macro for generating a well-documented
PluginGroup
from a list ofPlugin
paths.
Structs§
- Animation
- Animation system set. This exists in
PostUpdate
. - App
App
is the primary API for writing user applications. It automates the setup of a standard lifecycle and provides interface glue for plugins.- First
- Runs first in the schedule.
- Fixed
First - Runs first in the
FixedMain
schedule. - Fixed
Last - The schedule that runs last in
FixedMain
- Fixed
Main - The schedule that contains systems which only run after a fixed period of time has elapsed.
- Fixed
Main Schedule Order - Defines the schedules to be run for the
FixedMain
schedule, including their order. - Fixed
Post Update - The schedule that runs after the
FixedUpdate
schedule, for reacting to changes made in the main update logic. - Fixed
PreUpdate - The schedule that contains logic that must run before
FixedUpdate
. - Fixed
Update - The schedule that contains most gameplay logic, which runs at a fixed rate rather than every render frame.
For logic that should run once per render frame, use the
Update
schedule instead. - Last
- Runs last in the schedule.
- Main
- The schedule that contains the app logic that is evaluated each tick of
App::update()
. - Main
Schedule Order - Defines the schedules to be run for the
Main
schedule, including their order. - Main
Schedule Plugin - Initializes the
Main
schedule, sub schedules, and resources for a givenApp
. - Panic
Handler Plugin - Adds sensible panic handlers to Apps. This plugin is part of the
DefaultPlugins
. Adding this plugin will setup a panic hook appropriate to your target platform: - Plugin
Group Builder - Facilitates the creation and configuration of a
PluginGroup
. - Post
Startup - The schedule that runs once after
Startup
. - Post
Update - The schedule that contains logic that must run after
Update
. For example, synchronizing “local transforms” in a hierarchy to “global” absolute transforms. This enables thePostUpdate
transform-sync system to react to “local transform” changes inUpdate
without theUpdate
systems needing to know about (or add scheduler dependencies for) the “global transform sync system”. - PreStartup
- The schedule that runs before
Startup
. - PreUpdate
- The schedule that contains logic that must run before
Update
. For example, a system that reads raw keyboard input OS events into anEvents
resource. This enables systems inUpdate
to consume the events from theEvents
resource without actually knowing about (or taking a direct scheduler dependency on) the “os-level keyboard event system”. - RunFixed
Main Loop - Runs the
FixedMain
schedule in a loop according until all relevant elapsed time has been “consumed”. - Schedule
Runner Plugin - Configures an
App
to run itsSchedule
according to a givenRunMode
. - Spawn
Scene - The schedule that contains scene spawning.
- Startup
- The schedule that runs once when the app starts.
- SubApp
- A secondary application with its own
World
. These can run independently of each other. - SubApps
- The collection of sub-apps that belong to an
App
. - Terminal
CtrlC Handler Plugin Non-WebAssembly - Gracefully handles
Ctrl+C
by emitting aAppExit
event. This plugin is part of theDefaultPlugins
. - Update
- The schedule that contains any app logic that must run once per render frame.
For most gameplay logic, consider using
FixedUpdate
instead.
Enums§
- AppExit
- An event that indicates the
App
should exit. If one or more of these are present at the end of an update, the runner will end and (maybe) return control to the caller. - Plugins
State - Plugins state in the application
- RunFixed
Main Loop System - Set enum for the systems that want to run inside
RunFixedMainLoop
, but before or after the fixed update logic. Systems in this set will run exactly once per frame, regardless of the number of fixed updates. They will also run under a variable timestep. - RunMode
- Determines the method used to run an
App
’sSchedule
.
Traits§
- AppLabel
- A strongly-typed class of labels used to identify an
App
. - DynEq
- An object safe version of
Eq
. This trait is automatically implemented for any'static
type that implementsEq
. - Plugin
- A collection of Bevy app logic and configuration.
- Plugin
Group - Combines multiple
Plugin
s into a single unit. - Plugins
- Types that represent a set of
Plugin
s.
Type Aliases§
- Interned
AppLabel - A shorthand for
Interned<dyn AppLabel>
.
Derive Macros§
- AppLabel
- Generates an impl of the
AppLabel
trait.