gbrs
gbrs is a Game Boy emulator written in Rust, released in version 0.6 by Adam Soutar; the project is only available as source code.
gbrs is a Game Boy emulator written in Rust, designed to accurately reproduce the original hardware. It supports advanced features such as scanline effects (required for games like Road Rash), as well as MBC1, MBC2, and MBC3 (for advanced cartridges), and hardware quirks like the LCD Stat interrupt or the internal Window counter. Game saves and sound management are also implemented.
Although the project is still under development and distributed solely as source code, it offers ports for several graphical backends, including SDL and SFML. While not officially optimized for macOS, its modular architecture allows compilation on Apple Silicon and recent system versions. Experienced users can assemble it via Cargo, adjusting dependencies according to their environment.
Last updated:
Platforms
Architecture
Mac OS X - macOS
64-bit
SDL Library
Download and links
- Download gbrs
- Official website
- Source code 46 GitHub stars
- License : MIT
Version history
0.6
- Ajout de l'émulation précise des cycles de l'écran LCD et correction des erreurs de timing CPU, permettant le bon fonctionnement de Pokémon Red/Blue.
- Implémentation de l'instruction CPU HALT, résolvant un blocage critique dans Pokémon Red/Blue.
- Correction d’un problème ancien dans Dr. Mario lié à l’affichage LCD, le rendant jouable.
- Support ajouté pour le Memory Board Controller 3, élargissant la compatibilité aux jeux mentionnés.
- Amélioration globale de la précision de l’émulation CPU pour des titres spécifiques.
This release improves LCD emulation accuracy, fixes some CPU cycle timing mistakes, and implements the CPU HALT instruction. This combination finally fixes Pokémon Red/Blue! That's a major goal of the project ticked off. The LCD fixes have also fixed a long-running issue with Dr Mario, which now works just fine!
It implements support for Memory Board Controller 3, allowing us to run:
Pokémon Red Pokémon Blue WarioLand 2
0.5
- Correction d’un bug récurrent affichant des lignes de balayage corrompues sur les sprites en double hauteur, améliorant la compatibilité visuelle avec Donkey Kong.
- Ajout du support pour le Memory Board Controller 2, permettant l’exécution de jeux comme Kirby’s Pinball Adventure ou Final Fantasy Legend.
- Correction des problèmes graphiques dans Ayakashi no Shiro, F-1 Race, Golf et Top Ranking Tennis.
This release fixes a long-running bug where corrupted scanlines would appear in double-height sprites. It fixes visual issues in Donkey Kong, among others.
It also implements support for Memory Board Controller 2, allowing us to run:
- Kirby's Pinball Adventure
- Ayakashi no Shiro
- F-1 Race
- Golf
- Final Fantasy Legend
- Top Ranking Tennis
0.4
- Séparation du code en deux crates distinctes : gbrs-sfml-gui (interface utilisateur pour Windows/macOS/Linux) et gbrs-core (émulation Gameboy).
- Mise à jour de gbrs-core pour compiler avec #![no_std], permettant une portabilité accrue vers des systèmes embarqués ou bare metal.
- Préparation d’un portage futur vers la plateforme Playdate grâce à cette modification.
- Aucune nouvelle compatibilité Gameboy ou fonctionnalité émulateur ajoutée.
This version does not implement any new Gameboy compatibility, however, it does make some important changes to the Rust codebase.
First of all, the GUI code for Windows/macOS/Linux (gbrs-sfml-gui) has been separated from Gameboy emulation code (gbrs-core) - splitting the project into two crates.
Second, gbrs-core has been updated to support compiling with #![no_std]. This allows us to port the core Gameboy emulation code to vastly more systems by running on bare metal. The main reason this change has been made is to support an upcoming project for porting gbrs to Playdate.
0.3
- Ajout de l'émulation du câble de liaison Game Boy et d'un bug connu du LCD pour plus d'authenticité matérielle.
- Amélioration de l'émulation de la puce MBC1 avec une gestion plus précise de la RAM.
- Prise en charge complète de Mortal Kombat, Alleyway, Road Rash, Galaxian et Space Invaders en plus des jeux supportés précédemment.
This version implements Gameboy Link Cable emulation, an LCD bug (a bug that exists in original hardware) and more accurate MBC1 chip RAM emulation.
It can now fully play:
- Mortal Kombat
- Alleyway
- Road Rash
- Galaxian
- Space Invaders
on top of all games in the previous release
Note: gbrs is probably compatible with quite a few more games, these are just the ones I'm playing to test it :)
0.2
- Ajout du support des fenêtres et de la gestion des z-fighting pour les sprites.
- Implémentation de la RAM MBC1 et des fichiers de sauvegarde alimentés par batterie.
- Prise en charge de jeux comme Super Mario Land, Link’s Awakening et Donkey Kong.
- Affichage des intros de Mortal Kombat, Dr. Mario et Alleyway.
- Suppression des limitations précédentes (exclusivité de Tetris).
This version implements The window, Sprite z-fighting, MBC1 RAM, battery-backed save files, and more
This allows you to play:
- Super Mario Land
- Super Mario Land 2
- The Legend of Zelda Link's Awakening
- Donkey Kong
- Pac-Man
- Frogger
and can render the intros of:
- Mortal Kombat
- Dr Mario
- Alleyway
Lots more than just Tetris now!
0.1
- Ajout d’un émulateur fonctionnel capable d’exécuter Tetris (sans son).
- Instabilité possible : risque de plantage lors d’écriture vers l’APU pour déboguer.
- Version initiale non garantie pour une utilisation stable en production.
This is a tag to show a version of the emulator that runs. It should run Tetris just fine (without sound).
As I hack on the master branch, it's not guaranteed to remain stable, eg. I may make it panic on events like writing to the APU to track things down easier.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.