Supports bevy v0.12.1. Made as I got tired of writing the boilerplate for the way I liked to structure projects.
- Input management ready to go with
leafwing-input-manager
ron
and 2d/3d assets ready to load- Automatic window resizing on wasm
- Loading states courtesy of
bevy_asset_loader
- Settings
ron
set up and ready for application use - wasm friendly
- Scalable file structure
You'll also probably want a physics library (bevy_xpbd_2d/3d
) and UI (egui
),
but those aren't included since they're not always a requirement of every game,
and there alternatives to egui.
To run with asset hot reloading, use
cargo run --features bevy/file_watcher
- components
- plugins (private system groups)
- resources (and assets)
- states
- util (+public systems)
Couple of important points:
- The project uses its own
prelude
. Our game types are so commonly needed that the pre-made folders are publicly exported in aprelude
mod. You should use this often, because it saves a lot of trouble (use crate::prelude::*
). - I postfix the type of thing that something is, except for components, e.g. "GameAsset", "MyResource", "AppState". Components do not follow this pattern because they are so frequently needed, and can be made obvious in systems without the additional keyword. I find Resources and States are slightly harder to intuit, even though they derive certain things. Idk. Theres some other reasons I can't articulate.
- Most of the game logic resides in
plugins
. Most systems are meant to run in groups of some kind, so they're actually private functions within plugin files. The only thing that is exposed is thePlugin
, which is then consumed by aPluginGroup
. Those groups are by defaultCorePlugins
andClientPlugins
. This is to make separation easier for, e.g. servers. (Imagine a client app that usesClientPlugins
and a dedicated server app that just usesCorePlugins
). If you actually want to reuse a system across different plugins, it probably should go inutil
as a helper system. - All components go in
components
, yeah. Resources/assets inresources
. States instates
.