Game Boy / Game Boy Color (Gambatte)Link

Contribute to this documentationLink

In order to propose improvements to this document, visit its corresponding source page on github. Changes are proposed using "Pull Requests."

There is a To-Do list for libretro/docs here

You can submit suggestions or issues regarding documentation at the libretro/docs issue tracker or in our forum thread.

BackgroundLink

Gambatte is an accuracy-focused, open-source, cross-platform Game Boy Color emulator written in C++. It is based on hundreds of corner case hardware tests, as well as previous documentation and reverse engineering efforts.

Why use this core?Link

Awaiting description.

How to get and install the Gambatte core:Link

  • Start up RetroArch. Inside the main menu, go to 'Online Updater'.

  • Just to make sure we have the latest info files, select 'Update Core Info FIles'. Wait until this is done. Then, select 'Core Updater'.

  • Browse through the list and select 'Game Boy / Game Boy Color (Gambatte)'.

After this has finished downloading, the core should now be ready for use!

How to start (after installation):Link

  • Go back to RetroArch's main menu screen. Select 'Load Content'.

  • Browse to the folder that contains the content you want to run.

  • Select the content that you want to run.

  • If you are asked which core to select, choose 'Game Boy / Game Boy Color (Gambatte)'.

The content should now start running!

AuthorsLink

  • Sinamas

See alsoLink

GB/GBCLink

LicenseLink

A summary of the licenses behind RetroArch and its cores have found here.

The Gambatte core is licensed under

ExtensionsLink

Content that can be loaded by the Gambatte core have the following file extensions:

  • .gb
  • .gbc
  • .dmg

DatabasesLink

RetroArch database(s) that are associated with the Gambatte core:

BIOSLink

Required or optional firmware files go in RetroArch's system directory.

Filename Description md5sum
gb_bios.bin Game Boy BIOS - Optional 32fbbd84168d3482956eb3c5051637f5
gbc_bios.bin Game Boy Color BIOS - Optional dbfce9db9deaa2567f6a84fde55f9680

Attention

The 'Use official bootloader' core option must be set to On in order for these BIOS files to be used.

FeaturesLink

RetroArch-level settings or features that the Gambatte core respects.

Feature Supported
Restart
Screenshots
Saves
States
Rewind
Netplay ✔ (not link-cable emulation)
Core Options
RetroAchievements
RetroArch Cheats
Native Cheats
Controls
Remapping
Multi-Mouse
Rumble
Sensors
Camera
Location
Subsystem
Softpatching
Disk Control
Username
Language
Crop Overscan

DirectoriesLink

The Gambatte core's directory name is 'Gambatte'

The Gambatte core saves/loads to/from these directories.

RetroArch's Save directory

  • 'content-name'.srm (Cartridge battery save)

RetroArch's State directory

  • 'content-name'.state# (State)

Geometry and timingLink

  • The Gambatte core's internal FPS is (FPS)
  • The Gambatte core's internal sample rate is (Rate)
  • The Gambatte core's core provided aspect ratio is (Ratio)

Custom palettes for Game Boy gamesLink

The GB Colorization core option must be set to custom.

Create a folder called "palettes" in RetroArch's system directory. Then, you can place custom palette files (.pal) inside the "palettes" folder

You can define different palettes for specific games by creating a .pal file in the "palettes" folder with "INTERNALROMNAME.pal" or "rom-name.pal". If no specific palette is found for a ROM then the default palette is used.

You can also define a palette to be used for all Game Boy games by creating a .pal file in the "palettes" folder named "Default.pal"

Custom palettes can be created from the GUI in standalone Gambatte

Core optionsLink

The Gambatte core has the following option(s) that can be tweaked from the core options menu. The default setting is bolded.

Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.

  • GB Colorization (Off/auto/internal/custom)

Colorizes Game Boy games.

GB Colorization - Off

GB Colorization - auto

  • Internal Palette (GBC - Blue/GBC - Brown/GBC - Dark Blue/GBC - Dark Brown/GBC - Dark Green/GBC - Grayscale/GBC - Green/GBC - Inverted/GBC - Orange/GBC - Pastel Mix/GBC - Red/GBC - Yellow/Special 1/Special 2/Special 3)

Select which internal color palette for GB Colorization is going to be used. GB Colorization must be set to internal.

Internal Palette - GBC - Blue

Internal Palette - GBC - Brown

Internal Palette - GBC - Dark Blue

Internal Palette - GBC - Dark Brown

Internal Palette - GBC - Dark Green

Internal Palette - GBC - Grayscale

Internal Palette - GBC - Green

Internal Palette - GBC - Inverted

Internal Palette - GBC - Orange

Internal Palette - GBC - Pastel Mix

Internal Palette - GBC - Red

Internal Palette - GBC - Yellow

Internal Palette - GBC - Special 1

Internal Palette - GBC - Special 2

Internal Palette - GBC - Special 3

  • Color Correction (On/Off)

Darkens Game Boy Color games to match the original hardware output.

Color Correction - On

Color Correction - Off

  • Emulated Hardware (restart) (Auto/GB/GBC/GBA)

Choose which hardware is emulated Game Boy, Game Boy Color, or Game Boy Advance.

  • Use official bootloader (restart) (if available) (On/Off)

Enables support for using official Game Boy and Game Boy Color bootloaders with startup logos. Check the BIOS section to see what files are needed.

Game Boy bootloader

Game Boy Color bootloader

  • Gameboy Link Mode: (Not Connected/Network Server/Network Client)

Awaiting description.

  • Network Link Port: (56400-56420)

Awaiting description.

  • Network link server add: (0-255)

Awaiting description.

  • Network link server add: (0-255)

Awaiting description.

  • Network link server add: (0-255)

Awaiting description.

  • Network link server add: (0-255)

Awaiting description.

ControllersLink

Device typesLink

The Gambatte core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s):

User 1 device typesLink

  • None - Doesn't disable input.
  • RetroPad - Joypad
  • RetroPad w/Analog - Joypad

Controller tablesLink

Joypad and analog device type tableLink

User 1 Input descriptors RetroPad Inputs
B
Select
Start
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
A

CompatibilityLink

Game Issue
Command Master Crashes on start. Unemulated MBC7 mapper.
Game Boy Camera Crashes on start. Unemulated Pocket Camera mapper.
Game de Hakken!! Tamagotchi - Osutchi to Mesutchi Crashes on start. Unemulated TAMA5 mapper.
Kirby Tilt 'n' Tumble Crashes on start. Unemulated MBC7 mapper.
Net de Get: Mini-Game @ 100 Crashes on start. Unemulated MBC6 mapper.
Pocket Family GB2 Crashes on start. Unemulated HuC3 mapper.
Robopon: Sun/Star/Moon Version Crashes on start. Unemulated HuC3 mapper.