egor 0.5.0

Why Egor?

Egor is dead simple, lightweight and highly cross-platform; the same code runs native and on the web via WASM. It avoids heavy abstractions and uses RAII-style builders; configure with method chaining, submission happens on Drop

Built from modular, reusable crates, Egor provides engine-grade fundamentals like rendering, input, math & hot-reload while deliberately avoiding game-specific concepts such as ECS, sprites and scenes. It comes with sane defaults and a custom runtime with first-class native and web targets, sharing the same APIs and execution model

Features

• Modular & Extensible – pick modules, integrate easily with minimal boilerplate
• (Textured) Primitives - batched rectangles & basic shapes
• Camera/World Transforms - world-to-screen projection, zoom/pan
• Text/Fonts - simple text rendering
• Input Handling - keyboard & mouse support
• Math Utilities – vectors, matrices & helpers for 2D calculations
• Hot-Reload (Optional) - live updates with the hot_reload feature

Platform Support

[!NOTE] Mobile (Android/iOS) isn't (intended to be) supported & neither is touch input

Getting Started

Add egor to your project:

cargo add egor

Example:

let mut position = Vec2::ZERO;

App::new()
    .title("Egor Stateful Rectangle")
    .run(move |gfx, input, timer| {
        let dx = input.key_held(KeyCode::ArrowRight) as i8
            - input.key_held(KeyCode::ArrowLeft) as i8;
        let dy =
            input.key_held(KeyCode::ArrowDown) as i8 - input.key_held(KeyCode::ArrowUp) as i8;

        position += vec2(dx as f32, dy as f32) * 100.0 * timer.delta;

        gfx.rect().at(position).color(Color::RED);
    })

To see more of egor in action, check out demos/

[!TIP] Running a demo for WASM? You’ll need to move index.html into a demo, or just use the included run.sh script (see usage). It simplifies running native, WASM & hot-reload builds

Running a Native Build

Simply run cargo:

cargo run

Running a WASM Build

Run trunk (defer to Trunk docs for setup):

trunk serve

Try Out Subsecond Hot-reloading

Compile with the hot_reload feature enabled. Hot reload will automatically wrap AppHandler::update when the feature is active

Run dioxus-cli (defer to Dioxus CLI docs for setup):

dx serve --hot-patch

[!NOTE] Subsecond hot-reloading is experimental; native is working

Contributing

egor is moving fast.. Got an idea, bugfix, or question? Check out some issues, open a new one, drop a PR, or come hang in Discord

egor is maintained with ❤️ by Open Source Force