一个专注于可移植性的 2D Rust 游戏引擎。
Emerald is designed to be as lightweight as possible, while remaining a fully-featured and cross-platform game engine.
The api is simple and powerful, giving you direct access to physics, audio, graphics, game worlds, and asset loading.
--- Work in progress ---
let my_sprite = emd.loader()
.sprite("my_sprite.png")
.unwrap();
let my_audio = emd.loader()
.sound("my_sound.wav")
.unwrap(); let entity = emd.world().spawn((Transform::from_translation((0.0, 0.0))));
let body_handle = emd.world().physics().build_body(
entity,
RigidBodyBuilder::dynamic()
);
emd.world().physics().build_collider(
body_handle,
ColliderDesc::cuboid(6.0, 6.0)
);
// You can alternatively build both the entity and body at once.
let (entity, body_handle) = emd.world()
.spawn_with_body(
(Transform::from_translation((0.0, 0.0))),
RigidBodyBuilder::dynamic()
)?;
emd.world()
.physics()
.step();You decide when physics steps! This makes it very easy to "pause" the game without needing to alter any data.
The default method to draw the game is to draw all of the entities in the current world. However, you can write your own draw function if you need to do more!
fn draw(&mut self, mut emd: Emerald) {
emd.graphics().begin();
emd.graphics().draw_world();
emd.graphics().render();
}let my_sound = emd.loader().sound("sounds/my_song.ogg")?;
emd.audio().mixer("background_music")?.play_and_loop(my_sound);Emerald uses the Entity Component System paradigm for creating, managing, and updating game entities.
Emerald uses Hecs under the hood for fast entity iteration, and a remarkably clean query Api.
More detailed features can be found in the Hecs documentation.
for (id, (sprite, mut position)) in emd.world().query::().iter() {
position.x += 10.0;
}Emerald has built in aseprite loading and rendering. Simply load in the file, then tell it which animations to play.
let mut aseprite = emd.loader().aseprite("my_sprite.aseprite").unwrap();
aseprite.play("some_aseprite_animation");
emd.world().spawn((aseprite, Position::zero()));Alternatively, Emerald can load a sprite sheet exported from aseprite.
let mut aseprite = emd.loader()
.aseprite_with_animations("my_texture.png", "my_animation.json").unwrap();Export settings
cargo build --target wasm32-unknown-unknown
In order to keep a clean, simple API, and avoid network requests for assets. Emerald takes the approach of packing all necessary assets into the WASM binary.
This same method can be used to pack all assets into the game binary regardless of which platform you target.
Use the pack_asset_bytes function to load data into the engine.
…Add following to Cargo.toml and load assets as usual:
[package.metadata.android]
assets = "YOUR_ASSETS_DIRECTORY/"暂无开放 Issues,或尚未同步最近议题。