finds.dev

brettchalupa/usagi

A simple 2D game engine for rapid prototyping with Lua, featuring live reload and cross-platform export; this repo is a mirror and development happens at: https://codeberg.org/brettchalupa/usagi

View on GitHubHomepage ↗

★ 877RustUnlicenseupdated Oct 2026

// the take

Usagi is a 2D Lua game engine written in Rust, built around a PICO-8-style 16-color palette and a 320x180 default canvas. It's aimed at solo devs and game-jam participants who want something more capable than PICO-8 (no token limit) but far lighter than Love2D, with live reload and one-command cross-platform packaging baked in.

Hot reload actually preserves running game state — editing code, sprites, a palette, or a font applies without restarting, which most small engines don't bother getting right. `usagi export` produces Linux/macOS/Windows/web builds plus a portable `.usagi` bundle from a single command, removing the packaging grind that kills a lot of jam projects before they ship. The API design reflects real engine experience: fixed-signature `_ex` variants avoid optional-arg soup, GLSL ES shader variants ship separately for web/Raspberry Pi, and Switch controllers get A/B face-button remapping handled transparently instead of leaking platform quirks into user code.

Single maintainer (Brett Chalupa) with no visible team — real continuity risk if you're building something you intend to maintain past a jam. This GitHub repo is explicitly a mirror (development happens on Codeberg, issues redirect there), so the 877 stars/42 forks understate the actual community and anyone judging project health from the GitHub page alone will misjudge it. The scope limits are hard by design: no mobile/VR targets, the tested resolution range is only 320x180 to 640x360 (pause-menu UI breaks outside that), and the README states outright it's not built for medium-to-large polished games — this is a prototyping tool with a ceiling, not a growth path. A couple of sharp edges are documented but easy to trip on: `gfx.get_px` costs roughly 10% of frame time even for a single call (a trap for color-based collision), and the `+=`/`-=` preprocessor is line-anchored and evaluates the left-hand side twice, so `t[f()] += 1` silently calls `f()` twice.

We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
877
Forks
42
Language
Rust
License
Unlicense
Last commit
9 Oct 2026

// nearby

If usagi isn't quite it.

All repos →