| Both sides previous revision Previous revision Next revision | Previous revision |
| systems:gb [2021/11/27 10:39] – header fix atari | systems:gb [2021/12/11 11:22] (current) – [RetroArch] correct mesen-s name atari |
|---|
| |
| * **Emulator:** [[#retroarch|RetroArch]] | * **Emulator:** [[#retroarch|RetroArch]] |
| * **Cores available:** [[#libretro_gambatte|gambatte]], [[#libretro_mgba|mgba]], [[#libretro_vba-m|vba-m]], [[#libretro_mesens|mesens]] | * **Cores available:** [[#libretro:_gambatte|libretro: Gambatte]], [[#libretro:_mgba|libretro: mGBA]], [[#libretro:_vba-m|libretro: VBA-M]], [[#libretro:_mesens|libretro: MesenS]] |
| * **Folder:** ''/userdata/roms/gb'' | * **Folder:** ''/userdata/roms/gb'' |
| * **Accepted ROM formats:** ''.gb'', ''.zip'', ''.7z'' | * **Accepted ROM formats:** ''.gb'', ''.zip'', ''.7z'' |
| |
| No Game Boy emulator in Batocera needs a BIOS file to run. | No Game Boy emulator in Batocera needs a BIOS file to run. |
| | |
| | If you'd like to use a BIOS for instance to see the game boot animation: |
| | |
| | ^ MD5 checksum ^ Share file path ^ Description ^ |
| | | ''32fbbd84168d3482956eb3c5051637f5'' | ''bios/gb_bios.bin'' | Game Boy BIOS | |
| |
| ===== ROMs ===== | ===== ROMs ===== |
| Place your Game Boy ROMs in ''/userdata/roms/gb''. | Place your Game Boy ROMs in ''/userdata/roms/gb''. |
| |
| To play Game Boy games in their Super Game Boy mode, place your roms into the ''roms/sgb'' folder. | To play Game Boy games in their Super Game Boy mode, place your ROMs into the ''roms/sgb'' folder. |
| |
| To play two virtually linked Game Boy instances for multiplayer games, refer to [[systems:gb2players|GB2Players]]. | To play two virtually linked Game Boy instances for multiplayer games, refer to [[systems:gb2players|GB2Players]]. |
| |
| ===== Emulators ===== | ===== Emulators ===== |
| |
| ==== libretro/gambatte ==== | |
| |
| 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. The accuracy of the emulator is among the highest and is based off numerous reverse engineering tests and document studies. | |
| |
| We use the latest [[https://github.com/libretro/opera-libretro|libretro]] core. See the [[https://docs.libretro.com/library/gambatte/|official documentation]] for more information. | |
| |
| ==== RetroArch ==== | ==== RetroArch ==== |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| ^ Settings that apply to all cores of this emulator || | ^ Settings that apply to all cores of this emulator || |
| | **GRAPHICS BACKEND ''gb.gfxbackend''** | Choose your graphics rendering\\ => OpenGL ''opengl'', Vulkan ''vulkan''. | | | **GRAPHICS API ''gb.gfxbackend''** | Choose which graphics API library to use. Vulkan is better, when supported.\\ => OpenGL ''opengl'', Vulkan ''vulkan''. | |
| | **AUDIO LATENCY ''gb.audio_latency''** | Audio latency in milliseconds, turn it up if you hear crackles\\ => 256 ''256'', 192 ''192'', 128 ''128'', 64 ''64'', 32 ''32'', 16 ''16'', 8 ''8''. | | | **AUDIO LATENCY ''gb.audio_latency''** | Audio latency in milliseconds, turn it up if you hear crackles\\ => 256 ''256'', 192 ''192'', 128 ''128'', 64 ''64'', 32 ''32'', 16 ''16'', 8 ''8''. | |
| | **THREADED VIDEO ''gb.video_threaded''** | Improves performance at the cost of latency and more video stuttering. Use only if full speed cannot be obtained otherwise.\\ => On ''true'', Off ''false''. | | | **THREADED VIDEO ''gb.video_threaded''** | Improves performance at the cost of latency and more video stuttering. Use only if full speed cannot be obtained otherwise.\\ => On ''true'', Off ''false''. | |
| |
| === libretro/gambatte === | === libretro: Gambatte === |
| | |
| | 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. The accuracy of the emulator is among the highest and is based off numerous reverse engineering tests and document studies. |
| | |
| | We use the latest [[https://github.com/libretro/gambatte-libretro|libretro]] core. See the [[https://docs.libretro.com/library/gambatte/|official documentation]] for more information. |
| |
| == libretro/gambatte configuration == | == libretro: Gambatte configuration == |
| |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| | **COLORIZATION ''gb.gb_colorization''** | Set the Game Boy palettes to use\\ => Off ''none'', GB - Smart Coloring ''GB - SmartColor'', GB - DMG ''GB - DMG'', GB - Light ''GB - Light'', GB - Pocket ''GB - Pocket'', GB - Black and White ''GB - Disabled'', GBC - Blue ''GBC - Blue'', GBC - Brown ''GBC - Brown'', GBC - Dark Blue ''GBC - Dark Blue'', GBC - Dark Brown ''GBC - Dark Brown'', GBC - Dark Green ''GBC - Dark Green'', GBC - Grayscale ''GBC - Grayscale'', GBC - Green ''GBC - Green'', GBC - Inverted ''GBC - Inverted'', GBC - Orange ''GBC - Orange'', GBC - Pastel Mix ''GBC - Pastel Mix'', GBC - Red ''GBC - Red'', GBC - Yellow ''GBC - Yellow'', SGB - 1A ''SGB - 1A'', SGB - 1B ''SGB - 1B'', SGB - 1C ''SGB - 1C'', SGB - 1D ''SGB - 1D'', SGB - 1E ''SGB - 1E'', SGB - 1F ''SGB - 1F'', SGB - 1G ''SGB - 1G'', SGB - 1H ''SGB - 1H'', SGB - 2A ''SGB - 2A'', SGB - 2B ''SGB - 2B'', SGB - 2C ''SGB - 2C'', SGB - 2D ''SGB - 2D'', SGB - 2E ''SGB - 2E'', SGB - 2F ''SGB - 2F'', SGB - 2G ''SGB - 2G'', SGB - 2H ''SGB - 2H'', SGB - 3A ''SGB - 3A'', SGB - 3B ''SGB - 3B'', SGB - 3C ''SGB - 3C'', SGB - 3D ''SGB - 3D'', SGB - 3E ''SGB - 3E'', SGB - 3F ''SGB - 3F'', SGB - 3G ''SGB - 3G'', SGB - 3H ''SGB - 3H'', SGB - 4A ''SGB - 4A'', SGB - 4B ''SGB - 4B'', SGB - 4C ''SGB - 4C'', SGB - 4D ''SGB - 4D'', SGB - 4E ''SGB - 4E'', SGB - 4F ''SGB - 4F'', SGB - 4G ''SGB - 4G'', SGB - 4H ''SGB - 4H'', Special 1 ''Special 1'', Special 2 ''Special 2'', Special 3 ''Special 3'', Special 4 (TI-83 Legacy) ''Special 4 (TI-83 Legacy)'', TWB64 - Pack 1 ''TWB75 - WonderSwan'', TWB64 - Pack 2 ''TWB76 - Yellow Banana''. | | | **COLORIZATION ''gb.gb_colorization''** | Set the Game Boy palettes to use\\ => Off ''none'', GB - Smart Coloring ''GB - SmartColor'', GB - DMG ''GB - DMG'', GB - Light ''GB - Light'', GB - Pocket ''GB - Pocket'', GB - Black and White ''GB - Disabled'', GBC - Blue ''GBC - Blue'', GBC - Brown ''GBC - Brown'', GBC - Dark Blue ''GBC - Dark Blue'', GBC - Dark Brown ''GBC - Dark Brown'', GBC - Dark Green ''GBC - Dark Green'', GBC - Grayscale ''GBC - Grayscale'', GBC - Green ''GBC - Green'', GBC - Inverted ''GBC - Inverted'', GBC - Orange ''GBC - Orange'', GBC - Pastel Mix ''GBC - Pastel Mix'', GBC - Red ''GBC - Red'', GBC - Yellow ''GBC - Yellow'', SGB - 1A ''SGB - 1A'', SGB - 1B ''SGB - 1B'', SGB - 1C ''SGB - 1C'', SGB - 1D ''SGB - 1D'', SGB - 1E ''SGB - 1E'', SGB - 1F ''SGB - 1F'', SGB - 1G ''SGB - 1G'', SGB - 1H ''SGB - 1H'', SGB - 2A ''SGB - 2A'', SGB - 2B ''SGB - 2B'', SGB - 2C ''SGB - 2C'', SGB - 2D ''SGB - 2D'', SGB - 2E ''SGB - 2E'', SGB - 2F ''SGB - 2F'', SGB - 2G ''SGB - 2G'', SGB - 2H ''SGB - 2H'', SGB - 3A ''SGB - 3A'', SGB - 3B ''SGB - 3B'', SGB - 3C ''SGB - 3C'', SGB - 3D ''SGB - 3D'', SGB - 3E ''SGB - 3E'', SGB - 3F ''SGB - 3F'', SGB - 3G ''SGB - 3G'', SGB - 3H ''SGB - 3H'', SGB - 4A ''SGB - 4A'', SGB - 4B ''SGB - 4B'', SGB - 4C ''SGB - 4C'', SGB - 4D ''SGB - 4D'', SGB - 4E ''SGB - 4E'', SGB - 4F ''SGB - 4F'', SGB - 4G ''SGB - 4G'', SGB - 4H ''SGB - 4H'', Special 1 ''Special 1'', Special 2 ''Special 2'', Special 3 ''Special 3'', Special 4 (TI-83 Legacy) ''Special 4 (TI-83 Legacy)'', TWB64 - Pack 1 ''TWB75 - WonderSwan'', TWB64 - Pack 2 ''TWB76 - Yellow Banana''. | |
| |
| === libretro/mgba === | === libretro: mGBA === |
| |
| 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 supports Game Boy and Game Boy Color games. | 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 supports Game Boy and Game Boy Color games. |
| |
| == libretro/mgba configuration == | == libretro: mGBA configuration == |
| |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| | **FRAMESKIP ''gba.frameskip_mgba''** | Skip frames to improve performance (smoothness)\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | | | **FRAMESKIP ''gba.frameskip_mgba''** | Skip frames to improve performance (smoothness)\\ => 0 ''0'', 1 ''1'', 2 ''2'', 3 ''3'', 4 ''4'', 5 ''5'', 6 ''6'', 7 ''7'', 8 ''8'', 9 ''9'', 10 ''10''. | |
| |
| === libretro/vba-m === | === libretro: VBA-M === |
| |
| VBA-M is a Game Boy Advance emulator with the goal to improve upon VisualBoyAdvance by integrating the best features from the various builds floating around. It also supports Game Boy, Game Boy Color and Super Game Boy (borders, palette). | VBA-M is a Game Boy Advance emulator with the goal to improve upon VisualBoyAdvance by integrating the best features from the various builds floating around. It also supports Game Boy, Game Boy Color and Super Game Boy (borders, palette). |
| |
| == libretro/vba-m configuration == | == libretro: VBA-M configuration == |
| |
| ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ | ^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^ |
| | **SENSOR SENSITIVITY (TILT) ''gba.tilt_sensitivity''** | For Gyro-enabled games (bound to right analog stick)\\ => 10 ''10'', 15 ''15'', 20 ''20'', 25 ''25'', 30 ''30'', 35 ''35'', 40 ''40'', 45 ''45'', 50 ''50'', 55 ''55'', 60 ''60'', 65 ''65'', 70 ''70'', 75 ''75'', 80 ''80'', 85 ''85'', 90 ''90'', 95 ''95'', 100 ''100'', 105 ''105'', 110 ''110'', 115 ''115'', 120 ''120''. | | | **SENSOR SENSITIVITY (TILT) ''gba.tilt_sensitivity''** | For Gyro-enabled games (bound to right analog stick)\\ => 10 ''10'', 15 ''15'', 20 ''20'', 25 ''25'', 30 ''30'', 35 ''35'', 40 ''40'', 45 ''45'', 50 ''50'', 55 ''55'', 60 ''60'', 65 ''65'', 70 ''70'', 75 ''75'', 80 ''80'', 85 ''85'', 90 ''90'', 95 ''95'', 100 ''100'', 105 ''105'', 110 ''110'', 115 ''115'', 120 ''120''. | |
| |
| === libretro/MesenS === | === libretro: Mesen-S === |
| |
| Technically a SNES emulator, MesenS supports Game Boy via the Super Game Boy (or at least, an emulated version of it). Requires the appropriate BIOS files to function. | Technically a SNES emulator, Mesen-S supports Game Boy via the Super Game Boy (or at least, an emulated version of it). Requires the appropriate BIOS files to function. |
| |
| ROMs placed in the ''roms/sgb'' folder will appear in the SNES's game list, opening them from here will start the Game Boy game as if though you were playing it from the Super Game Boy. How neat! | ROMs placed in the ''roms/sgb'' folder will appear in the SNES's game list, opening them from here will start the Game Boy game as if though you were playing it from the Super Game Boy. How neat! |
| Here are the default Game Boy's controls shown on a [[:configure_a_controller|Batocera Retropad]]: | Here are the default Game Boy's controls shown on a [[:configure_a_controller|Batocera Retropad]]: |
| |
| {{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/nes.png }} | {{https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/nes.png}} |
| |
| ===== Troubleshooting ===== | ===== Troubleshooting ===== |