shura

shura is a safe, fast and cross-platform 2D component-based game framework written in rust. shura helps you to manage big games with it's scene managing, group system and component system which is designed to easily share components between projects (therefore allowing for a ecosystem of components). shura has everything your 2D game needs such as physics, controller input, audio, easy extensible rendering, serializing, deserializing, text rendering, gui, animations and many more. See the features section for all of shura's features.

shura is currently in an early version and things might change in the future or don't work as intended. Feel free to create an issue if you encounter bugs, have feedback or have questions.

Getting started

To see some examples head to the /examples directory or run cargo run --release --example bunnymark

Get started by copying the template. The template includes the library, some introduction and has some additional configuration to make sure your game runs on all supported platforms.

OR:

Add the following to your Cargo.toml:

[dependencies]
shura = "0.3.0"

A good way to learn shura is through the provided examples or through reading the code documentation.

Features

• Managing multiple independent scenes.

• Easy to use component system with a group system to ensure fast manageable 2D games in massive levels

• Group system that acts like a chunk system to organize components and manage big worlds

• Support for postprocessing of your renders

• Easy to configure camera scaling, to ensure your game is responsive and works on all sort of screens

• Physics simulations directly implemented into the component system through rapier (feature flag 'physics')

• Window Management with winit

• Cross-platform extendable rendering with wgpu

• Input handling for touch, mouse and keyboard and controller with gilrs (feature flag 'gamepad')

• Text rendering inspired by wgpu_text (feature flag 'text')

• Audio playback with rodio (feature flag 'audio')

• Easily create GUI's with egui (feature flag 'gui')

• Serializing and serializing of scenes and groups with serde and bincode

• Animations inspired by bevy_tweening (feature flag 'animation')

• Logging on all Platforms with env_logger and a modified verison of wasm_logger (feature flag 'log')

Cross-platform

shura is currently only tested on Windows 10 / 11, Linux, Android and on the web with WASM. macOS and iOS are currently untested, but are likely to work.

The template uses run-wasm to run on the web and cargo-apk to run on android.

Android

When compiling for android make sure the following is added in the Cargo.toml:

[lib]
crate-type = ["cdylib"]
path = "src/main.rs"