Seed project for 2D games
This project template will get you from 0 to drawing something on the screen in no time. If you're looking for a more in-depth introduction to the engine, please have a look at our book!
This project template also includes a small example of how to draw UI, see in state.rs for createuiexample().
git clone https://github.com/amethyst/amethyst-starter-2d.git cd amethyst-starter-2d
cargo run
This starter uses vulkan as a renderer by default. You'll want to change the backend to use
metal, which can be done by opening the
Cargo.tomlfile and changing
[features] default = ["vulkan"]
to
[features] default = ["metal"]
If using OSX and Metal you will require full XCode installed from the Appstore in order to compile metal shaders. After install you may be required to run this command
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developerreference gfx-rs issue
You might need to install some dependencies. Please refer to this section of the README for more details.
This project contains the minimum amount of code needed to draw sprites to the screen. Here's a small summary of what you'll find in the source files:
resources/display_config.ron
src/main.rs
src/state.rs
on_starthook, the camera is initialized, and the sprites that will be drawn are loaded and their entities created.
handle_eventhook, we print any keys that were pressed and close the window if the user presses escape or the OS requests that we quit.