A Bevy game template

Template for a Game using the awesome Bevy engine featuring out of the box builds for Windows, Linux, macOS, and Web (WASM).

Since Bevy is in heavy development, there regularly are unpublished new features or bug fixes. If you like living on the edge, you can use the branch bevy_main of this template to be close to the current state of Bevy's main branch

What does this template give you?

basic setup with a slim main function and your game as a Bevy plugin in a library
small example game (warning: biased; e.g., split into a lot of plugins and using bevy_kira_audio for sound)
easy setup for running the web (cargo run --target wasm32-unknown-unknown) and the native version (cargo run)
workflow for GitHub actions creating releases for Windows, Linux, macOS, and Web (WASM) ready for distribution
- push a tag in the form of v[0-9]+.[0-9]+.[0-9]+* (e.g. v1.1.42) to trigger the flow

How to use this template?

Click "Use this template" on the repository's page
Look for ToDo to use your own game name everywhere
Update the icons as described below
Start coding 🎉
- Start the native app: cargo run
- Start the web build: cargo run --target wasm32-unknown-unknown
  - requires wasm-server-runner: cargo install wasm-server-runner
  - requires wasm32-unknown-unknown target: rustup target add wasm32-unknown-unknown
  - this will serve your app on a free port

You should keep the credits directory up to date. The release workflow automatically includes the directory in every build.

Updating the icons

Replace build/windows/icon.ico (used for windows executable and as favicon for the web-builds)
Replace build/macos/icon_1024x1024.png with a 1024 times 1024 pixel png icon and run create_icns.sh (make sure to run the script inside the macos directory) - Warning: sadly this seems to require a mac...

Getting started with Bevy

You should check out the Bevy website for links to resources and the Bevy Cheat Book for a bunch of helpful documentation and examples. I can also recommend the official Bevy Discord server to keep up to date with the development and get feedback + help from other Bevy users.

Known issues

Audio in web-builds can have issues in some browsers. This seems to be a general performance issue and not due ot the audio itself (see bevy_kira_audio/#9).

License

This project is licensed under CC0 1.0 Universal except some content of assets and the Bevy icons in the build directory (see Credits). Go crazy and feel free to show me whatever you build with this (@nikl_me).