Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amethyst/space-menace
An action 2D platformer made with Amethyst game engine
https://github.com/amethyst/space-menace
2d-platformer-game amethyst game-dev rust showcase
Last synced: about 12 hours ago
JSON representation
An action 2D platformer made with Amethyst game engine
- Host: GitHub
- URL: https://github.com/amethyst/space-menace
- Owner: amethyst
- License: mit
- Created: 2019-05-25T21:57:22.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-20T22:29:56.000Z (almost 2 years ago)
- Last Synced: 2024-08-21T21:27:24.027Z (3 months ago)
- Topics: 2d-platformer-game, amethyst, game-dev, rust, showcase
- Language: Rust
- Homepage:
- Size: 25.1 MB
- Stars: 180
- Watchers: 11
- Forks: 32
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Space Menace
![](demo.gif)
An action 2D platformer made with the [Amethyst](https://amethyst.rs/) game engine.
This is my _firstish_ attempt at a game (I did write a basic snake game some time back). Through this project, I aim to get better at coding in [Rust](https://www.rust-lang.org/), get familiar with the Amethyst game engine and start learning game development in general. I also hope that this project will help other Amethyst and game dev beginners like me in some way or the other.
Currently, it is a :warning:**WORK IN PROGRESS**:warning: and there is still a lot to be done before it reaches a playable state. Also, the code is far from perfect and there is a lot of scope for improvement. I will keep enhancing the code incrementally, as I go along.
## Configure Cargo.toml
The default render target feature is set to `metal` for macOS users.
```toml
# Cargo.toml[features]
default = ["metal"]
metal = ["amethyst/metal"]
vulkan = ["amethyst/vulkan"]
```If you are on Windows or Linux, you will have to set that default to `vulkan`:
```toml
# Cargo.toml[features]
default = ["vulkan"]
# ...
```## Running the game
**Note:** This game requires Rust nightly
```bash
# Clone the repo
git clone https://github.com/amethyst/space-menace.git
cd space-menace# Set the toolchain to nightly for the current directory
rustup override set nightly# Run
cargo run —release
```## Game controls
Use the `left arrow` key and `right arrow` key to move the player and the `up arrow` key to jump. Use `spacebar` to fire.
## Features:
- [x] Basic map using [Tiled](https://www.mapeditor.org/)
- [x] Animation using prefabs (Main character run, jump, shoot, etc.)
- [x] Basic 2D physics (gravity, velocity, collision detection, etc.)
- [x] Lazy spawning of entities
- [x] Parallax
- [ ] One complete level (enemies, full map, etc.)
- [ ] Start, Pause and Game Over screens
- [ ] Game mechanics / rules (points, lives, etc.)
- [ ] Audio
- [ ] Consider [nphysics](https://nphysics.org/) integration (using [specs-physics](https://github.com/amethyst/specs-physics/))
- [ ] Documentation
- [ ] TestsMore details about the features, **roadmap** and the game in general can be found [here on Amethyst's discourse](https://community.amethyst.rs/c/showcase/space-menace).
## Contributions:
Any and all kinds of contributions are more than welcome, whether it be feature implementation, bug fix, art assets creation, documentation, issue logging or simply ideas, suggestions and feedback.If you are new to Rust or Game Development and are looking for issues to get started, I have added few [good first issues](https://github.com/amethyst/space-menace/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).
In case you have any doubts or have an idea / feedback that you want to discuss, feel free to [log an issue](https://github.com/amethyst/space-menace/issues/new) or drop me a message on Discord. You can find me on the [Amethyst channel](https://discord.gg/amethyst).
## Credits / Thanks:
- The awesome Amethyst community for helping me out whenever I got stuck. Special thanks to Ben, doomy, JoshMcguigan, Alve, azriel, Dispersia, Moxinilian, torkleyy, Jojolepro, kel, jaynus, Frizi.
- [ansimuz](https://ansimuz.itch.io/) for all the cool assets used in this game.