Data-oriented game engine written in Rust
Rust GLSL
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
amethyst_animation Merge remote-tracking branch 'origin/develop' into feature/829/sprite… Aug 13, 2018
amethyst_assets Amethyst 0.8 Update Aug 5, 2018
amethyst_audio Amethyst 0.8 Update Aug 5, 2018
amethyst_config Amethyst 0.8 Update Aug 5, 2018
amethyst_controls Amethyst 0.8 Update Aug 5, 2018
amethyst_core Added LazyBuilder to Named Aug 14, 2018
amethyst_gltf Amethyst 0.8 Update Aug 5, 2018
amethyst_input Amethyst 0.8 Update Aug 5, 2018
amethyst_locale Amethyst 0.8 Update Aug 5, 2018
amethyst_renderer Merge branch 'develop' into feature/829/sprite-render-pass Aug 18, 2018
amethyst_ui Amethyst 0.8 Update Aug 5, 2018
amethyst_utils Amethyst 0.8 Update Aug 5, 2018
book Fix tests for pong-tutorial-02 Aug 18, 2018
docs Merge branch 'develop' into feature/829/sprite-render-pass Aug 18, 2018
examples Merge branch 'develop' into feature/829/sprite-render-pass Aug 18, 2018
src Promote `UiButton` to a fundamental Ui component Jul 27, 2018
.appveyor.yml Revert caching attempts Aug 6, 2018
.gitattributes Fix crlf normalization on extensionless files Mar 8, 2017
.gitignore Update .gitignore for mdbook output directory. Apr 10, 2018
.travis.yml Revert caching attempts Aug 6, 2018
COPYING Move some files from the root directory into docs Mar 12, 2018
Cargo.toml Merge remote-tracking branch 'origin/develop' into feature/829/sprite… Aug 13, 2018
README.md Add a couple of book development instructions Aug 6, 2018
bors.toml Update bors.toml Jan 7, 2018
build.rs Updating specs to 0.10, shred to 0.5, and rayon to 0.8. Using Restric… Oct 8, 2017
rustfmt.toml Formatting with 0.4.2-stable May 31, 2018

README.md

Amethyst

Build Status Crates.io MIT/Apache Join the chat Join us on Discord Lines of Code

What is Amethyst?!

Amethyst is a game engine aiming to be fast and as configurable as possible.

Principles

These principles are what make amethyst unique and competitive in the world of game engines.

  • Massively parallel architecture.
  • Powered by a correct Entity Component System model.
  • Rapid prototyping with RON files for prefabs and an abstract scripting API.
  • Strong focus on encouraging reusability and clean interfaces.

Why Amethyst?

Extreme Multithreading

Amethyst is based over a very powerful parallel ecs called specs. This allows games built with Amethyst to maximize the processing power usage to make it run as smooth and as fast as possible, without the headache of multithread programming.

Clean

By design, the amethyst engine encourages you to write clean and reusable code for your behaviours and data structures, allowing engine users to easily share useful components, thus reducing development time and cost.

Using the ecs architecture, the code of games can be cleanly divided between data and behaviour, making it easy to understand what is going on, even if the game is running on a massive 64 cores processor.

Community

While we may not be feature-packed (yet!), we all strongly believe that the community-oriented side of amethyst will thrive as we move forward!

Features

Please visit the features page for a list of features Amethyst provides.

Documentation

develop docs master docs

Usage

While the engine can be hard to use at times, we made a lot of documentation that will teach you everything you need to use amethyst comfortably!

If you don't understand a part of the documentation, please let us know. Join us on discord or gitter, or open an issue, we are always happy to help!

Getting started

To compile any of the examples run:

$ cargo run --example name_of_example

All available examples are listed under examples.

Our most advanced example is currently called pong. It is a pong game, as you may have guessed it.

$ cargo run --example pong

There are quite a few prototype games that were made with Amethyst. A list will be available soon. While we create this list, feel free to join our discord and ask about which projects are currently being made with Amethyst.

For a full-blown "Hello World" tutorial check out the Getting Started chapter in the book.

Dependencies

If you are compiling on Linux make sure to install the following dependencies:

Ubuntu

$ sudo apt install libasound2-dev libx11-xcb-dev

Fedora

$ sudo dnf install alsa-lib-devel

Building Documentation

You can build the book locally with:

$ cargo install mdbook
$ mdbook build book

If you're actively editing the documentation, it's easiest to run:

$ mdbook serve book

and go to http://localhost:3000. For more information, see the mdBook project.

The text can be found in book/html/index.html. To generate the API documentation locally, do:

$ cargo doc

The API reference can be found in target/doc/amethyst/index.html.

Questions / Help

We do not support anything other than the most recent Rust stable release. Use nightly and beta channels with this project at your own risk.

Please check out the FAQ before asking.

If you have a question, just ask on Discord (most active) or Gitter and we'll help you.

Other places you may want to check out are r/rust_gamedev and #rust-gamedev IRC.

Contributing

We are a community project that welcomes contributions from anyone.

If you're interested in helping out, please read the contribution guidelines file before getting started.

We have a good first issue category that groups all issues or feature request that can be made without having an extensive knowledge of rust or amethyst. Working on those issues is a good, if not the best way to learn.

If you think you are not ready to code yet, you can still contribute by reviewing code written by other members of the community. In fact, code reviews ensures that the code that gets added to amethyst is of the highest quality as possible. Pull requests available for reviews are here.

If for some reason we don't have any open PR or good first issues (that would be a good thing), you can look through the issue tracker.

License

Amethyst is free and open source software distributed under the terms of both the MIT License and the Apache License 2.0.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.