Game Boy Advance (mGBA)Link

BackgroundLink

mGBA is an emulator for running Game Boy Advance games. It aims to be faster and more accurate than many existing Game Boy Advance emulators, as well as adding features that other emulators lack. It also supports Game Boy and Game Boy Color games.

Author/LicenseLink

The mGBA core has been authored by

  • endrift

The mGBA core is licensed under

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

ExtensionsLink

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

  • .gb
  • .gbc
  • .gba

DatabasesLink

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

BIOSLink

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

Filename Description md5sum
gba_bios.bin Game Boy Advance BIOS - Optional a860e8c0b6d573d191e4ec7db1b1e4f6

Warning

In order for the Game Boy Advance BIOS to be used, the 'Use BIOS file if found' core option must be set to On.

FeaturesLink

Frontend-level settings or features that the mGBA core respects.

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

DirectoriesLink

The mGBA core's directory name is 'mGBA'

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

Frontend's Save directory

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

Frontend's State directory

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

Geometry and timingLink

  • The mGBA core's core provided FPS is (FPS)
  • The mGBA core's core provided sample rate is 32768 Hz
  • The mGBA core's core provided aspect ratio is (Ratio)

Core optionsLink

The mGBA 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.

  • Solar sensor level [mgba_solar_sensor_level] (0 to 10 in increments of 1. 0 is default.)

    Can be used for games that employed the use of a solar sensor on their cartridges.

  • Allow opposing directional input [mgba_allow_opposing_directions] (Off/On)

    Self-explanatory.

  • Use BIOS file if found [mgba_use_bios] (Off/On)

    Uses a Game Boy Advance BIOS present in RetroArch's system directory. Look at the BIOS section for more information.

  • Skip BIOS intro [mgba_skip_bios] (Off/On)

    Skips the BIOS intro when a Game Boy Advance BIOS present in RetroArch's system directory is used. The 'Use BIOS file if found' core option must be set to On for proper operation.

Skip BIOS intro - Off

  • Idle loop removal [mgba_idle_optimization] (Remove Known/Detect and Remove/Don't Remove)

    Awaiting description.

  • Frameskip [mgba_frameskip] (0 to 10 in increments of 1. 0 is default)

    Choose how much frames should be skipped to improve performance at the expense of visual smoothness.

ControllersLink

The mGBA 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 - There's no reason to switch to this.

Rumble supportLink

Rumble only works in the mGBA core when

  • The content being ran has rumble support. (e.g. Cartridges with a Rumble Pak)
  • The frontend being used has rumble support.
  • The joypad device being used has rumble support.

Controller tablesLink

JoypadLink

User 1 Remap descriptors RetroPad Inputs
B
Turbo B
Select
Start
Up
Down
Left
Right
A
Turbo A
L
R
Turbo L
Turbo R
Darken Solar Sensor
Brighten Solar Sensor

CompatibilityLink

Please file game bugs on the issue tracker here

See alsoLink

GBALink

GB/GBCLink