If you like Rusty Engine, please sponsor me on GitHub or on Patreon, or take one of my courses. 💖
Rusty Engine is a simple, 2D game engine for those who are learning Rust. Create simple game prototypes using straightforward Rust code without needing to learning difficult game engine concepts! It works on macOS, Linux, and Windows. Rusty Engine is a simplification wrapper over Bevy, which I encourage you to use directly for more serious game engine needs.
Questions, bug reports, and contributions are most welcome!
RoadRace.mp4
- Asset pack included (sprites, music, sound effects, and fonts)
- Sprites (2D images)
- Use sprites from the included asset pack, or bring your own
- Collision detection with custom colliders
- Audio (music & sound effects)
- Looping music
- Multi-channel sound effects
- Text
- 2 fonts included, or bring your own
- Input handling (keyboard, mouse)
- Timers
- Custom game state
- Window customization
The following courses use Rusty Engine in their curriculum:
- Ultimate Rust 2: Intermediate Concepts on Udemy (the sequel to Ultimate Rust Crash Course)
- Rust in 3 Weeks conducted live on O'Reilly Online approximately once each quarter.
If you are using Linux or Windows Subsystem for Linux 2, please visit Bevy's Installing Linux Dependencies page and follow the instructions to install needed dependencies.
Here are three different ways to download the assets (pick any of them--it should end up the same in the end):
- Clone the
rusty_engine
repository and copy/move theassets/
directory over to your own project - Download a zip file or tarball of the
rusty_engine
repository, extract it, and copy/move theassets/
directory over to your own project. - On a posix compatible shell, run this command inside your project directory:
curl -L https://github.com/CleanCut/rusty_engine/archive/refs/heads/main.tar.gz | tar -zxv --strip-components=1 rusty_engine-main/assets
Add rusty_engine
as a dependency
# In your [dependencies] section of Cargo.toml
rusty_engine = "3.0.0"
Write your game!
// in src/main.rs
use rusty_engine::prelude::*;
// Define a struct to hold custom data for your game (it can be a lot more complicated than this one!)
struct GameState {
health: i32,
}
// Initialize the engine with your custom struct
rusty_engine::init!(GameState);
fn main() {
// Create a game
let mut game = Game::new();
// Set up your game. `Game` exposes all of the methods (but not fields) of `EngineState` as well.
let sprite = game.add_sprite("player", SpritePreset::RacingCarBlue);
sprite.scale = 2.0;
game.audio_manager.play_music(MusicPreset::Classy8Bit, 1.0);
// Add one or more functions with logic for your game. When the game is run, the logic
// functions will run in the order they were added.
game.add_logic(game_logic);
// Run the game, with an initial state
let initial_game_state = GameState { health: 100 };
game.run(initial_game_state);
}
// Your game logic functions can be named anything, but the first parameter is always a
// `&mut EngineState`, and the second parameter is a mutable reference to your custom game
// state struct (`&mut GameState` in this case). The function returns a `bool`.
//
// This function will be run once each frame.
fn game_logic(engine_state: &mut EngineState, game_state: &mut GameState) -> bool {
// The `EngineState` contains all sorts of built-in goodies.
// Get access to the player sprite...
let player = engine_state.sprites.get_mut("player").unwrap();
// Rotate the player...
player.rotation += std::f32::consts::PI * engine_state.delta_f32;
// Damage the player if it is out of bounds...
if player.translation.x > 100.0 {
game_state.health -= 1;
}
// Returning `true` means the next logic function in line should be run.
true
}
Run your game with cargo run --release
!
See also the game scenarios, code examples and the API documentation
All software contributions are assumed to be dual-licensed under MIT/Apache-2. All asset contributions must be under licenses compatible with the software license, and explain their license(s) in a README.md
file in the same directory as the source files.
All assets included with this game engine have the appropriate license described and linked to in a README.md
file in the same directory as the source files. In most cases, the license is CC0 1.0 Universal--meaning you may do whatever you wish with the asset.
One notable exception is some of the music files, which are under a different license and include specific attribution requirements that must be met in order to be used legally when distributed. Please see this README.md
file for more information.
Distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See license/APACHE and license/MIT.