LuaGB

Emulator 0.1.1

LuaGB is a Game Boy emulator written in Lua, developed by Zeta0134, and is offered here in version 0.1.1 for macOS.

This software no longer receives updates. Its last known release dates from January 25, 2019. Check that it still works with your version of macOS.

LuaGB is a Game Boy (DMG) and Game Boy Color (GBC) emulator fully written in Lua, designed for a modular and portable approach. It targets environments compatible with Lua 5.2+ and the "bit" library, offering a flexible structure around an independent Game Boy module. Although its interface currently relies on Love2D (a Lua-based game framework), its architecture allows for theoretical portability to other platforms.

On macOS, its usage requires an installation of Love2D (version 0.11.2 or compatible) and Lua. The emulator supports key features such as cycle-approximate graphical replication, 32 kHz audio, multiple palettes (DMG mode), SRAM saves, and game states. Debugging tools (VRAM, audio, IO, disassembler) and an integrated file manager (software-rendered) facilitate technical exploration. However, some advanced features (such as Super Game Boy support or serial transfer) are either missing or still under development. The interface is controlled via Love2D, with navigation inspired by the original Game Boy.

Last updated:

Platforms

Architecture

Mac OS X - macOS Mac OS X - macOS Intel x86 Intel x86 64-bit 64-bit

Download and links

Version history

0.1.1
  • Ajout du support pour le General Purpose DMA et le HBlank DMA, essentiel pour certains jeux CGB populaires.
  • Optimisation des paramètres LuaJIT et réorganisation du code pour améliorer significativement les performances.
  • Routage audio via QueueableSource, réduisant les sauts, claquements et latence en mode plein écran.
  • Passage à la version Love 11.2 comme cible principale pour l'émulateur.
  • Correction de problèmes mineurs liés à l'unpacking et utilisation accrue de FFI pour des gains de vitesse.

This is a patch release of LuaGB, incorporating some major performance improvements from the community, as well as a small mix of bug fixes and one new feature. I've chosen to drop the alpha designation from this release, as at this point the emulator is reasonably stable and plays a wide variety of games correctly.

Notable Changes

  • Now targets Love 11.2
  • LuaJIT settings optimized for a rather hefty performance boost. Credit to @nico-abram, @TannerRogalsky and @meepen for the suggestions.
  • Less unpack, more FFI. Several small speed improvements from light code reorganization
  • Audio now routes through QueueableSource, greatly reducing skips, pops, and latency when running fullspeed
  • Proper support for General Purpose and HBlank DMA, needed by a few popular CGB games

A word of warning: I no longer have access to a Macintosh, so I can't test the OSX build. I'm providing it anyway in the hopes that it continues to be useful, but I can't give it any sort of seal of approval. Pull requests welcome if I've buggered it up in some way.

0.1.0-alpha
  • Émulateur Game Boy (Color) entièrement écrit en Lua, fonctionnel mais performant de manière limitée.
  • Utilisation du framework Love2D pour une compatibilité multiplateforme (Windows, macOS, Linux).
  • Interface simple : glisser-déposer les jeux dans un dossier dédié avant de relancer l’émulateur.
  • Mode débogage activable via la touche D pour les utilisateurs expérimentés.
  • Absence de bugs majeurs connus, mais pas de test exhaustif sur l’ensemble des jeux.
  • Documentation détaillée disponible dans le fichier README.md pour les instructions d’utilisation.

This is the first alpha release of LuaGB! This is a fully functional Gameboy (Color) emulator written in pure Lua. It remains not terribly fast but, I'm still fairly happy with the performance. I decided to release it in its current form to establish a stable base upon which to grow the project, and compare performance benchmarks to in the future. It is free of major bugs as far as I'm aware, though I can't test with every game ever made.

The release build uses the awesome Love2D framework to run the emulator on Windows, Mac OSX, and Linux platforms. For Linux, you'll need love 0.10.2 installed, either from your distribution's repositories, or from source. https://love2d.org/

Check out the README.md for detailed instructions. The tl;dr: click on the folder icon, copy your games into the folder that pops up, then restart the emulator. Press D for debug mode if you're adventurous.

Enjoy! Bug reports are welcome, screenshots especially so.

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum