Skip to content

RALibretro

!! This page is wildly out-of-date

RALibretro is a multi-emulator that can be used to develop RetroAchievements.

The "multi-emulation" feature is only possible because it uses libretro cores to do the actual emulation. What RALibretro does is to connect the emulation to the tools used to create RetroAchievements.

WARNING

RALibretro is a Work-in-Progress!!!

Currently the development is going on this repo: https://github.com/RetroAchievements/RALibretro

Here's a list of known issues (feel free to report new issues if you find one): https://github.com/RetroAchievements/RALibretro/issues

Installation Instructions

Just download RALibretro from the Downloads page and unzip it.

Basic Usage

  1. Launch RALibretro.exe
  2. Click on File > Load System, and click on the system you want to emulate
  3. Now go to File > Load Game and choose your ROM. Note: RALibretro currently doesn't accept zipped files!
  4. Now you can create your cheevos or just earn some!

Supported Systems

NOTE: some systems may require system (BIOS) files in the System directory in order to load games correctly.

Here is a list of the systems supported currently:

  • SNES
  • NES
  • Nintendo 64
  • Mega Drive
  • Master System
  • Gameboy
  • Gameboy Color
  • Gameboy Advance
  • PC Engine (TurboGrafx-16/TurboGrafx-CD)
  • Atari Lynx
  • Game Gear
  • Neo Geo Pocket
  • Atari 2600
  • Atari 7800
  • Virtual Boy
  • Neo Geo (Arcade) - new. NOTE: you need to put the neogeo.zip BIOS file on the same directory as the ROMs.
  • Capcom Play System 1, 2 and 3 (Arcade) - new

Keyboard Input

KeyboardaszxdcfvEnterTabgh
RetroPadYXBALRL2R2StartSelectL3R3
SNESYXBALRStartSelect
NESBASwap disk side (FDS)Insert/Eject disk (FDS)StartSelect
Mega DriveAYBCXZStart
Master SystemBAStart
GameGearBAStart
Gameboy [Color]BAStartSelect
Gameboy AdvanceBALRStartSelect
PC EngineIIIRunSelect
Atari LynxBAOption 1Option 2Start
Neo Geo PocketBAStart
Atari 2600oL difficulty bR difficulty bL difficulty aR difficulty aStartSelect
Neo GeoCDABStartCoin
CPS1/2/3*******StartCoin

Note: the buttons for CPS1/2/3 games vary for each game.

Keyboard Shortcuts

  • see overlay: Esc
  • pause emulation: p
  • advance one frame at a time: ; (automatically pauses emulation)
  • fast forward: =
  • fast forward toggle: - (minus signal)
  • Screenshot: PrintScreen

Save/Load state keys

  • Save state current slot: Backspace
  • Load state current slot: F11
  • Load state from slot 1, 2, .., 9, 0: F1, F2, ..., F9, F10
  • Save state to slot 1, 2, .., 9, 10: shift+F1, shift+F2, ..., shift+F9, shift+F10
  • Previous slot: shift+-
  • Next slot: shift++
  • Switch slot: 0, 1, 2,..., 9

Missing Features

How to make AES BIOS work in RALibretro or RetroArch

To make AES BIOS emulation mode work in your emulator:

  1. Make sure your emulator works correctly.

  2. Put neogeo.zip to System directory (RALibretro), or a folder you keep your NeoGeo ROMs (RetroArch).

  3. Make sure the neogeo.zip consist of at least files you can see here:

If you keep only those files, AES mode will be automatically forced for any NeoGeo game (recommended).

Important! The files which are highlighted on this picture (neo-epo.bin and neo-po.bin) are the only one actually related to AES mode, and you probably will need to include them in your archive to make AES mode work for you. neo-po.bin is necessary for japanese-only titles or to make the japanese versions to work, but due to emulation issue it also forces japanese language as default, that's why you will need to remove it to display english in some games.

  1. Load any FBA compatible neo geo ROM. More complete archive (including files needed to run MVS and UniBIOS modes) might need additional configuration to force AES mode:

In RaLibretro: Settings->Emulation->Force Neo Geo Mode->AES

In RetroArch: Command->Menu Toggle->Options->Force Neo Geo Mode->AES

Changelog

Released under the GPL-3 License. There are no copyright-protected ROMs available for download on RetroAchievements.