#cargo

macro roast2d_derive

Roast2D derive macros

1 unstable release

0.0.1 Sep 29, 2024

#1199 in #cargo


Used in roast2d

MIT license

3KB

Roast2D

Crates.io Docs CI

Roast2D is a rapid development 2D game engine written in Rust. Inspired by high_impact.

I wrote an article explaining why Roast2D was made

Features

  • Non ECS, just built-in entity with trait extension
  • Simple physics and collision detection
  • LDTK level editor integration
  • Multi-platform (via SDL2 and WebAssembly)

Examples

  • An mini ping-pong game shows the basic usage
  • A 2D platformer prototype balloon game shows how to integrate with LDTK, kira (audio) and support web platform.

Usage

Run example:

cargo run --example demo

Add roast2d to Rust project:

cargo add roast2d

Roast2D supports multiple backends:

SDL2

SDL2 is the default backend when you build for Linux / Mac / Windows.

Make sure the SDL2 library is installed on your machine before developing. This document can help to install SDL2.

WebAssembly

WebAssembly backend is implement with web canvas interface, you must make sure the game can build with wasm32-unknown-unknown target. Ensure you have wasm-pack installed, and use wasm-pack build to build project.

To render the game, ensure you provide a <canvas> element with the id #roast-2d-canvas.

License

The source code is licensed under MIT.

Dependencies

~230–670KB
~16K SLoC