Skip to content
A restaurateur simulation game, written in Rust and using Amethyst
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Amethyst 2D Starter

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!


  • Clone the repository
git clone
cd amethyst-starter-2d
  • Build and run the project
cargo run

For Mac Users

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.toml file and changing

default = ["vulkan"]


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/ reference gfx-rs issue

For Linux Users

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
    Contains the window configuration (size, title).

  • src/
    Creates the render graph, adds the required bundles, builds the game data with our own state and finally, starts the game's main event loop.

  • src/
    Implements the main game state. In the on_start hook, the camera is initialized, and the sprites that will be drawn are loaded and their entities created.
    In the handle_event hook, we print any keys that were pressed and close the window if the user presses escape or the OS requests that we quit.

You can’t perform that action at this time.