Table of contents
Covered platforms
The MAME core in BizHawk is currently Arcade-only, however we may add other MAME systems in the future.
Loading ROMs
MAME ROMs don't come as singular game image files, but as .zip packages, and you do not need to unpack them. Just run them directly in BizHawk. However, there are some nuances.
ROM set types
MAME ROM sets are usually organized in 2 different ways: merged and split. Merged sets contain base (parent) game files in the main .zip, and clone game files inside that .zip in additional folders. Split sets have every game packaged individually, parent or clone, in separate .zip files.
Naming
MAME determines which game you want to run by the game's short name you provide as an argument. Even inside its graphical user interface it will only recognize ROMs that come in individual .zip (or .7z) files or folders inside it's
roms directory, and those packages and folders must also be named after their respective games.
As a result, we have to inform BizHawk's MAME core which game to run by the name of the .zip package we're launching.
So if you want to run a parent machine, you just launch it as a normal ROM in BizHawk. But for anything more complicated, there are 2 main ways.
Multiple game packages
- Rename the package after the clone game you need to run and put all the needed files inside.
- If you've managed to run a game, you can check which files are mandatory by clicking the icon in the bottom right corner of the BizHawk window (dump status report).
- You can't put other .zip files inside, you have to unpack them into folders with the same names, or directly into the main .zip.
- Go to Tools -> Multi-disk Bundler, create a .xml named after your clone game, and add all the required .zip packages to the list (.chd files too, if needed), and launch that .xml file in BizHawk.
ROM info
ROM info is available in the Dump Status Report dialog that can be accessed by pressing the icon in the bottom left corner of the BizHawk window.
The icon itself (along with its tooltip) also indicates whether there is something to worry about with your ROM.
- Red exclamation mark is displayed when there are severe problems (original MAME indicates them via the red background in game selection menus):
- If the machine is considered "NOT WORKING" according to MAME
- If there are any unimplemented features
- If some of the ROMs in the set is known to be a bad dump (unless a newer set has a good dump, there's nothing a user can do to fix this)
- Orange question mark is displayed
- When there are imperfectly emulated features (original MAME indicates them via the orange background in game selection menus)
- If a multidisk bundle was loaded and no issues were found with the ROM
- If some of the ROMs doesn't have a known good dump
- Green checkmark is shown if there are no issues.
Machine settings
BIOS can be selected in the Arcade -> Settings menu, but if BIOS files come as a separate ROM set, you need to use the above method to load them alongside the main game.
DIP switches and other settings are in the same menu.
Troubleshooting
If you find a game with buttons not mapped ("!" in input display), tell us the game.
For crashes and other bugs, please report them on our GitHub.