Skip to content
Branch: master
Find file Copy path
Find file Copy path
1 contributor

Users who have contributed to this file

92 lines (68 sloc) 4.87 KB


How to build

From the root of the repository, run make -j5 -C src/burner/libretro


Use clrmamepro (which runs fine on linux with wine and on mac with crossover) to build valid romsets with dats from the dats directory. Don't report issues if you didn't build a valid romset. Also, i don't provide a "parent-only" dat file, because i don't recommend using only parent roms (some don't work, and some clones are really different from their parent)

Emulating consoles

You can emulate consoles (with specific romsets, dats are also in the dats directory) by prefixing the name of the roms with XXX_ and removing the zip|7z extension, or using the --subsystem XXX argument in the command line, here is the list of available prefixes :

  • CBS ColecoVision : cv
  • MSX 1 : msx
  • Nec PC-Engine : pce
  • Nec SuperGrafX : sgx
  • Nec TurboGrafx-16 : tg
  • Sega GameGear : gg
  • Sega Master System : sms
  • Sega Megadrive : md
  • Sega SG-1000 : sg1k
  • ZX Spectrum : spec


Samples should be put under SYSTEM_DIRECTORY/fbneo/samples


Copy hiscore.dat to SYSTEM_DIRECTORY/fbneo/


We don't have a convenient tool like the MAME OSD, instead we use the retroarch api to customize mappings, you can do that by going into Quick menu > Controls. For those who don't want to fully customize their mapping, there are 2 convenient presets you can apply by changing the "device type" for a player in this menu :

  • Classic : it will apply the original neogeo cd "square" mapping in neogeo games, and use L/R as 5th and 6th button for 6 buttons games like Street Fighter II.
  • Modern : it will apply the King of fighters mapping from Playstation 1 and above in neogeo fighting games, and it will use R1/R2 as 5th and 6th button for 6 buttons games like Street Fighter II (for the same reason as the neogeo games), this is really convenient for most arcade sticks.

Frequently asked questions

Where can i find the XXX roms ?

We don't provide links for roms. Google is your friend.

Game XXX is not launching, why ?

It is either not supported or you have a bad rom. Build a valid romset with clrmamepro as said above. There is also a few games marked as not working, try one of their clones.

Game XXX has graphical glitches, why ?

Most likely the same as above, make sure you have the right romset. If the problem persist, write a report with a screenshot and the name of the platform you are using.

Game XXX runs slowly, why ?

Your hardware is probably too slow to run the game with normal settings. Try the following :

  • Check if there is a speedhack dipswitch in the core options, set it to "yes".
  • Try setting a value for frameskip in core options.
  • Try disabling rewind, runahead, and anything related to the savestates system in retroarch.
  • Try lowering audio settings in the core options.
  • If it is not enough, upgrade or overclock your hardware.

Game XXX has choppy sound, why ?

Most likely for the same reason as above.

Game XXX runs faster in MAME2003/MAME2010, why ?

This is not MAME, we are using different code. Overall, FB Alpha is slower than old MAME version but more accurate and less buggy. This libretro port also support various features which are usually buggy or absent in MAME cores (netplay, rewind, retroachievements, ...). It takes some resources.

Cheat code doesn't work, why ?

There should be partial support through the new API relying on main ram exposition.

Neogeo CD doesn't work, why ?

There are several things to know :

  • You need a copy of and in your libretro system directory
  • You need to add --subsystem neocd to the command line
  • Supported format are ccd/sub/img iso (trurip), and single file MODE1/2352 bin/cue (use utilities like "CDmage" to convert your iso if needed)

You can convert your unsupported isos by following this tutorial :

  • Get CDMage 1.02.1 (freeware & no ads)
  • File > Open > select your iso (NB : for multi-track, select the .cue file, not the .iso file)
  • File > Save As > write the name of your new file
  • Make sure you select MODE1/2352 in the second drop-down
  • Press OK, wait for the process to finish (a few seconds on my computer), and it’s done !

Killer instinct won't work, why ?

There are several things to know :

  • It is only running at playable speed on x86_64 (other arch will basically need a cpu at 4Ghz because they lack a mips3 dynarec), and the core needs to be built like this to enable this dynarec : make -j5 -C src/burner/libretro USE_X64_DRC=1
  • If your rom is at ROM_DIRECTORY/, you'll need the uncompressed disc image at ROM_DIRECTORY/kinst/kinst.img
  • To get the uncompressed disc image, you'll need to use the chdman tool from MAME on the chd from mame, the command looks like this : chdman extracthd -i kinst.chd -o kinst.img
You can’t perform that action at this time.