Skip to content
Snippets Groups Projects
Louis Capitanchik's avatar
f02f96a1

Bevy 2D Template

Includes

  • Workspace configuration w/ assets dir
  • Splash screen
  • Websockets
  • High level audio player
  • Basic component based follow-camera setup
  • Convenience loader for assets
  • Asset loading state to preload all assets
  • Gitlab CI template based on Bevy Builder

Usage

Write some code, ya dig?

This project is set up for a multi-crate bevy game, but will work equally well if just using a single crate for your game. game_core is the location of your entry point, assets are placed at the root of the workspace in the assets folder.

Update the splash screen by replacing assets/splash.png - it is scaled by default to fill the shortest screen side; you can include empty space in your splash image as a simple way of changing the padding. assets/splash_sting.mp3 will be played during the splash screen.

If you need to pre-process files to generate your assets, update the Makefile assets command so that Gitlab CI will package them properly.

Includes websocket based multiplayer building blocks, using micro_bevy_remote_events

Comes with a Gitlab CI configuration that will build releases for web, Windows and Linux. It will also publish a Gitlab pages site with the web version automatically.

Commands

This project uses a Makefile to define some commands to get things going.

To run the game locally on linux, get things set up by running make setup-x11 or make setup-wayland depending on your requirements.

make run will run the desktop version of the game, while make run-web will run the game in your web browser. The web version requires trunk to be installed (cargo install trunk).

Building the game for desktop will use a docker container to manage dependancies, but will mount your workspace to perform the build. make build-linux and make build-windows can be run on any platform with docker installed, perfect for cross-compilation without juggling dependencies. make build-web

License

The code source files found in this repository are covered by the license found in the LICENSE file

The logo found in assets/splash.png is licensed under the following license for use only within the context of this project.

Asset creators are listed in CREDITS with any relevant licenses

Microhacks Logo by Microhacks Ltd is licensed under CC BY-NC-ND 4.0