| 📰 Title: | Usagi | 🕹️ / 🛠️ Type: | Tool |
|---|---|---|---|
| 🗃️ Genre: | Development | 👁️ Visual: | 2D |
| 🏷️ Category: | Development ➤ Engine ➤ 2D ➤ Misc. | 🏝️ Perspective: | Third person |
| 🔖 Tags: | Development; 2D engine; Prototyping; RAD; Lua; Multi-platform | ⏱️ Pacing: | Real Time |
| 🐣️ Approx. start: | 2026-02-28 | 👫️ Played: | Single |
| 🐓️ Latest: | 2026-05-29 | 🚦 Status: | 05. Tested & Working (status) |
| 📍️ Version: | Latest: 1.0.0 // Dev: 0b8c5f0 | ❤️ Like it: | 7. ⏱️ (untested|fct test) |
| 🏛️ License type: | 🕊️ Libre | 🎀️ Quality: | 1. 🏆️⭐⭐⭐⭐⭐ (perfect) |
| 🏛️ License: | Unlicense | ⭐ (temporary): | |
| 🐛️ Created: | 2026-05-30 | 🐜️ Updated: | 2026-05-30 |
| 📦️ Package name: | ..... 📦️ Arch: | ||
|---|---|---|---|
| 📄️ Source: |  |
..... 📦️ RPM: | |
| ⚙️ Generic binary: | |
..... 📦️ Deb: | |
| 🌍️ Browser version: | ..... 📦️ AppImage: | ||
| 📱️ Mobile support: | ..... 📦️ Flatpak: | ||
| 🧹️ Not use: | ..... 📦️ Snap: |
| 💡 Lights on: | 🚧️ Some work remains to be done: | ||
|---|---|---|---|
| 📰 What's new?: | 💥️ New | 💭️ New version published (to be updated): | |
| 🦣️ Awaiting publication on Mastodon: | 🎨️ Significant improvement: | ||
| 🦺️ Work in progress: | 🎖️ This work: |  |
|
| 📰 Previous News: | 👫️ Contrib.: | goupildb | |
| 🎰️ ID: | 16581 |
| 📜️[en]: | A simple, libre, multiplatform 2D game engine for rapid prototyping. It allows pixel art games to be created using Lua 5.5. It is a compact, fixed API offering everything needed to create an excellent 2D game, including live updating, multiplatform export with a single command, a pause menu with built-in control remapping, and easy data saving (a single function for saving the state and loading the game as a Lua table). Much like PICO-8-style machines, its constraints (320x180 resolution, default 16x16 sprite grid, a single sprites.png file for textures) stimulate creativity. | 📜️[fr]: | Un moteur de jeu 2D simple, libre et multiplateforme pour le prototypage rapide. Il permet de créer des jeux en pixel art avec Lua 5.5. C'est une API compacte et figée offrant tout ce qu'il faut pour créer un excellent jeu en 2D, et notamment la mise à jour en direct, l'exportation multiplateforme en une seule commande, un menu de pause avec remappage des commandes intégré, la sauvegarde facile des données (une seule fonction pour la sauvegarde d'état et le chargement du jeu sous forme de table Lua). A la manière des machines de type PICO-8, ses contraintes (résolution de 320x180, grille de sprites par défaut de 16x16, un seul fichier sprites.png pour les textures) stimulent la créativité. |
|---|
🏝️ Trailer: (202605),
🦉️From Devs: (202604),
🐹️ From Users: GameFromScratch (202605), jrondev (202605),
📰 Progress: (1.0/202605),
🕯️ How To: (202605),
🏡️ Website & videos
• Website: [Homepage] [Dev site] [Features/About] [Screenshots]
• Videos: t(202605) gd(202604) gu(202605) gu(202605) r(202xxx) lp(202xxx) ht (202605) ht[fr](202xxx) ht[de](202xxx) ht[ru](202xxx) ht[pl](202xxx) ht[cz](202xxx) ht[sp](202xxx) ht[pt](202xxx) ht[it](202xxx) ht[tr](202xxx)]
• Doc: [WIKI] [FAQ]
• Updates: [RSS] / [Changelog 1(news/blog) 2(release notes) 3(tags) 4(commits)]
💰 Commercial
• [Support their work (Donate)]
🍩️ Resources
• (empty, license): [Homepage] [Dev site] 🎬️ g(202xxx)
🛠️ Technical informations
[PCGamingWiki] [MobyGames]
🦣️ Social
Devs (Usagi Team 1 2 [fr] [en]): [Site 1 2] [Chat] [mastodon] [Bluesky] [PeerTube] [YouTube] [PressKit] [Interview 1(202xxx) 2(202xxx)]
Devs (Brett Chalupa (brettchalupa) 1 2 [fr] [en]): [Site 1 2 3 4] [Chat] [mastodon] [Bluesky] [PeerTube] [YouTube] [PressKit] [Interview 1(202xxx) 2(202xxx)]
The Project: [Blog] [Chat] [Forums] [mastodon] [Bluesky] [PeerTube] [YouTube] [PressKit] [Lemmy] [reddit] [Discord]
🐝️ Related
📦️ Misc. repositories
[Repology] [pkgs.org] [Generic binary] [Arch Linux / AUR] [openSUSE] [Debian/Ubuntu] [Flatpak] [AppImage(author's repo)] [Snap] [PortableLinuxGames]
🕵️ Reviews
[HowLongToBeat] [metacritic] [OpenCritic] [iGDB]
🕊️ Source of this Entry: [GameFromScratch (20260528)]
🦣️ Social Networking Update (on mastodon)
🕵 1.0.0: ⏱️
🛠️ Title: Usagi
🦊️ Idea:A simple, libre 2D game engine for rapid prototyping
🏡️ https://usagiengine.com
🐣️ https://github.com/brettchalupa/usagi
🔖 #LinuxGameDev #LibreEngine #2D
📦️ #Libre #Bin
📕️ https://lebottinlinux.vps.a-lec.org/LO.html
🥁️ Update: 1.0.0
⚗️ Major release(Stable)🍎️
📌️ Changes: https://usagiengine.com/changelog
📰1.0 https://www.youtube.com/embed/H93_BXi19SQ
🦣️ From: https://mastodon.gamedev.place/@GameFromScratch/116652807911557107
🛜️ https://github.com/brettchalupa/usagi/releases.atom
🏝️ https://www.youtube.com/embed/ajQyN-cBm-A
🦉️ https://www.youtube.com/embed/byp3rKd626M
🐹️ https://www.youtube.com/embed/yGW1M1LbnLc
🐹️ https://www.youtube.com/embed/efAJFWdw4tU
🕯️https://www.youtube.com/embed/?list=PL0qDutCc8IQhkbS53etm9xV06XgEb4BEN
🕶️ The project icon
📚️ Usagi is a simple, libre, multiplatform 2D game engine for rapid prototyping. It allows pixel art games to be created using Lua 5.5. It is a compact, fixed API offering everything needed to create an excellent 2D game, including live updating, multiplatform export with a single command, a pause menu with built-in control remapping, and easy data saving (a single function for saving the state and loading the game as a Lua table). Much like PICO-8-style machines, its constraints (320x180 resolution, default 16x16 sprite grid, a single sprites.png file for textures) stimulate creativity.
📜️ "A simple, libre 2D game engine for rapid prototyping" 📜️
Usagi - Simple 2D Game Engine for Rapid Prototyping
Usagi is a 2D game engine for making pixel art games in Lua 5.5. It features live reload, single-command cross-platform export, and a pause menu with input remapping built in.
Usagi is free software made by Brett Chalupa and dedicated to the public domain. Support development of the engine by buying me a coffee.
Features
✅️ Live reload. usagi dev watches your code and assets; saves apply without losing game state. Tweak a sprite in your editor and see it update instantly.
✅️ One-command export. usagi export packages your game for Linux, macOS, Windows, and the web.
✅️ Pause menu, free. Built-in pause menu with sfx and music volume, fullscreen toggle, and per-game keyboard + gamepad remapping.
✅️ Easy save data. One function to save and load your game state as a Lua table.
✅️ Small, fixed API. You can't do everything, but you've got what you need to make a great 2D game.
✅️ Constraints to inspire creativity. 320x180 default resolution, 16x16 default sprite grid, a single sprites.png for textures.
✅️ Bring your own sound effects, sprite editor, and music tools.
Un moteur libre de jeu 2D simple, pour le prototypage rapide, par la Usagi Team, initié par Brett Chalupa (brettchalupa).
En Rust/Lua.
Usagi est un moteur de jeu 2D simple, libre et multiplateforme pour le prototypage rapide. Il permet de créer des jeux en pixel art avec Lua 5.5. C'est une API compacte et figée offrant tout ce qu'il faut pour créer un excellent jeu en 2D, et notamment la mise à jour en direct, l'exportation multiplateforme en une seule commande, un menu de pause avec remappage des commandes intégré, la sauvegarde facile des données (une seule fonction pour la sauvegarde d'état et le chargement du jeu sous forme de table Lua). A la manière des machines de type PICO-8, ses contraintes (résolution de 320x180, grille de sprites par défaut de 16x16, un seul fichier sprites.png pour les textures) stimulent la créativité.
Usagi - Moteur de jeu 2D simple pour le prototypage rapide
Usagi est un moteur de jeu 2D permettant de créer des jeux en pixel art avec Lua 5.5. Il propose la mise à jour en direct, l'exportation multiplateforme en une seule commande et un menu de pause avec remappage des commandes intégré.
Usagi est un logiciel libre créé par Brett Chalupa et dédié au domaine public. Soutenez le développement du moteur en m'offrant un café.
Fonctionnalités
✅️ Rechargement en direct. usagi dev surveille votre code et vos ressources ; les sauvegardes s'appliquent sans perte de l'état du jeu. Modifiez un sprite dans votre éditeur et voyez-le s'actualiser instantanément.
✅️ Exportation en une seule commande. usagi export compile votre jeu pour Linux, macOS, Windows et le Web.
✅️ Menu de pause, libre. Menu de pause intégré avec réglage du volume des effets sonores et de la musique, bascule plein écran et remappage du clavier et de la manette par jeu.
✅️ Sauvegarde facile des données. Une seule fonction pour enregistrer et charger l'état de votre jeu sous forme de table Lua.
✅️ API compacte et figée. Vous ne pouvez pas tout faire, mais vous disposez de tout ce qu'il faut pour créer un excellent jeu en 2D.
✅️ Des contraintes pour stimuler la créativité. Résolution par défaut de 320x180, grille de sprites par défaut de 16x16, un seul fichier sprites.png pour les textures.
✅️ Apportez vos propres effets sonores, votre éditeur de sprites et vos outils musicaux.
⚙️ Installation à partir du binaire
⛓️ Installation à partir du binaire classique :
• Un binaire statique est disponible, décompressez le livrable, et rendez son binaire exécutable (clic droit sous votre gestionnaire de fichier).
📄️ Installation à partir du source
• Source non testé.
🚀️ LANCEMENT DU MOTEUR
▸ Classique :
• Si vous l'avez installé à partir d'un paquet / dans l'un des répertoires système : [Alt+F2] usagi ou $ usagi
• Ou, rendez son binaire exécutable (clic droit sous votre gestionnaire de fichier) et cliquez dessus, ou dans le répertoire où se trouve le binaire lancez : $ ./usagi
💡 Nota : si vous l'avez installé via votre gestionnaire de paquets et ne connaissez pas le nom précis du binaire, sélectionnez le paquet dans votre gestionnaire, et dans l'onglet “Fichiers” recherchez son nom dans l'arborescence d'installation (le binaire est généralement installé dans /usr/bin/).
● 📜️ Préambule :
⚬ 1ere édition : le 30 mai 2026 sous Manjaro. Par : goupildb. ⏱️ Durée du test : 2 minutes. 🎯️ Objectif : Initialisation de l'entrée et test binaire de fonctionnement.
● 🫕️ Installation :
‣ (✔ v. 1.0.0) Binaire classique : FONCTIONNEL.
🟢️ Il est très facile à installer et à lancer grâce au binaire fourni.
● 🧪️ Tests effectués :
▸ 🧫️ Conditions du test, objectif(s)
‣ 🔍️ (v. 1.0.0) : ✔ tested
‣ ◀️ Test binaire de fonctionnement : ✔ tested
⚪️ Ce test a pour objectif de vérifier que le jeu/outil démarre,
● 🧪️ Tests effectués :
▸ 🎲️ Résultat des tests
‣ 🔍️ (v. 1.0.0) :
‣ ◀️ Test binaire de fonctionnement :
🟢️ Visiblement il/elle fonctionne bien.
⚪️ Je n'ai pas les compétences pour un test sérieux.
$ ./usagi
Rapid 2D game prototyping with Lua
Usage: usagi
Commands:
run Run a game (no live-reload). Defaults to the current directory
dev Run a game with live-reload on save. F5 resets state. Defaults to the current directory
init Bootstrap a new project (main.lua, .luarc.json, .gitignore, LSP stubs, embedded docs). Defaults to the current directory
tools Open the Usagi tools window (jukebox, tile picker). Defaults to the current directory
templates Inspect or wipe the local template cache
export Export a game as shippable artifacts (zips per platform + `.usagi` bundle). Defaults to the current directory
update Update the usagi binary in place to the latest GitHub release
refresh Re-sync engine-managed files (USAGI.md, meta/usagi.lua, .luarc.json) from the running engine version. Interactive by default; never touches main.lua or .gitignore
font Font asset commands
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
● 🧭️ Conclusion :
🕵️ Impression globale : 👍️
❤️ Like it: ⏱️ (untested|fct test)
🎀️ Quality: 🏆️⭐⭐⭐⭐⭐ (perfect)
🟢️ Une alternative au moteur LÖVE et au moteur PICO-8 et autres dérivés pour du prototypage et le développement de jeux 2D en basse résolution.
👏️ ❤️ Un grand bravo et merci (notamment pour la version Linux !) à son/ses auteur(s) !