Crate app
Expand description
This crate is about everything concerning the highest-level, application layer of a Bevy app.
Modules§
Structs§
- 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.
- 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
. Provides a build ordering to ensure thatPlugin
s which produce/require aResource
are built before/after dependent/dependingPlugin
s.Plugin
s inside the group can be disabled, enabled or reordered. - 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
. - Update
- The schedule that contains app logic. Ideally containing anything that must run once per render frame, such as UI.
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
- 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§
- Create
Plugin Deprecated - A type representing an unsafe function that returns a mutable pointer to a
Plugin
. It is used for dynamically loading plugins. - Interned
AppLabel - A shorthand for
Interned<dyn AppLabel>
.
Derive Macros§
- AppLabel
- Generates an impl of the
AppLabel
trait. - Dynamic
Plugin - Generates a dynamic plugin entry point function for the given
Plugin
type.