From Quickplay
Jump to: navigation, search


Please look in your "qp/tools/MAME PERL script" folder for the Perl file, and then follow these instructions. Won't take long....the result is great!

Setting Up MAME with QuickPlay

[updated July 2014] MAME has got to be the trickiest thing to setup in QuickPlay - so I've threatened for a long time to do a walkthrough. This guide is for using Qrfax's Perl script with all the correct things done in the right order to make everything work (if you're using my pre- made Mame romdata.dat then you can pretty much skip stages 3 to 6). We want everything in QP to be easy, and most things are, but in the case of MAME I think this full guide is necessary

Install ActivPerl

So, I installed activperl from HERE and followed Orfax's method for creating my own MAME database. All worked great, but over time Orfax hasn't updated his script. So I have, doing things like making sure it works with 7zip roms, and it works with a fully merged set. You need to install ActivePerl to run Orfax's script (its about 60 meg and there really is nothing to do except install - just accept any defaults and leave it sitting there or you can uninstall it after doing this if you want). DAT your sets with CLRMAMEPRO - e.g.: If you want the CHD's to work they must be in correctly named folders in your Mame Roms directory ie: make sure you've datted your set properly in CLRMAMEpro. Basically MAME / MAMEUI has to know where everything is and work before you do this, because all QP does is pass the MAME name to MAME/MAMEUI (QP calls this %ROMMAME% an example is: 1941)

The main script is in the Quickplay_Mame_Romdata_Script folder. Again you NEED to install ActivePerl to run it. The script can EITHER work only on roms you have scanned in your QuickPLay romdata, or it can output everything in the MAME XML you give it. You are given a choice. If you have a FULLY MERGED Mame set you have no choice but to run the latter. Go for all if you're unsure which to run, then the output will be just like looking at 'all' in MAMEUI or similar. - full instructions written by Orfax are with the script - including how to generate the Mame XML. But please also consider that you'll eventually probably want to massage your "all" XML using: THIS METHOD

Picture Guide

And here is a pic list of instructions to doing this yourself - and my end result which I'm very happy with... Feel free to ask questions in the forums if you're stuck on any of this, we check it often

Download the latest E-Find

Make sure you're using the latest available EFind posted in the Efind download section. To install it just overwrite the EFind folder in the QP folder, also overwrite system.ini in the Dats folder. Make sure the Efind is looking in the right location for MAME, tick any MAME or MAMEUI exe's it finds and select to add the emulator(s) to QP (select overwrite if you want to nuke all your QP emulators and find them again (I just tick everything and do this every time personally- if you're worried I can confirm QP doesn't use windows registry at all so just copy the entire QP folder before you start changing emu's and use the alternaive if something goes wrong, or copy it back where it was - its tiny...

Make a MAME folder

In order to get MAME roms in the ROMS window you first need a QP 'folder' for MAME. You can right click in the left pane or do it from the menu.

Place ROMdata in folder

Great you have a folder for mame. If you're going to just use the ROMdata posted here just put that file in eg: C:\EMU\Quickplay\data\mame (this is the windows location of the folder you've just setup) and skip to step 7. If you want to make the romdata yourself, your new folder means you can right click in the roms pane and 'scan for ROMs' -but first:

Scan roms directory

Scan for ROMS in the ROMS pane - set it up like'll then see a whole load of ROMS in the roms pane, but they are called after the filename. Ignore it for now.

Copy catver.ini, nplayers.ini and languages.txt

7 Copy hitsory and info from MAME folder get catver and nplayers from net.png
see the two files catver.ini and nplayers.ini here? They are two easily findable MAME support files from the NET - HERE and HERE - I also recently added support for Mame Languages.txt HERE - get the latest and put them in this location in the QP folder (where there are two versions of these files - you want the non-32 ones i.e.: the ones NOT for Mame itself - so the ones JUST called catver.ini , nplayers.ini and languages.ini). Then select 'scan current folder with catver.ini' and 'scan current folder with nplayers.ini' from the Arcade menu in QP - this will fill in version and player info in the ROMDATA (you'll see them appear for games in the roms window there). It's important to do this now because Orfax's script wants this info to make a full set of info for each game (If you're going to use a pre-made ROMdata file like I've posted here you can ignore all this, its already in there). Then "scan current folder with languages.ini" - this will take a lot longer because the source file is not so patient.

Make XML

Ok so here we have the perl script - So QP's 'rename MAME ROMS' menu item just leads you to that script. This is why you need activePerl. Just exit QP and go to the folder you just setup (its in QP's data folder so C:\EMUS\QP\DATA\MAME) and copy out the romdata.dat -copy it to the folder with Orfax's script in it, and follow Orfax's readme to get the Mame.xml in that folder too). Quick tip for Windows 7 - if you 're in a folder and you want to run command line window from there, hold shift when no file is selected and right click: one of the options is 'open command line here' - do it and type that in (replace the MAME.exe text with whatever your MAME.exe is called). The XML file will be produced - put that in the folder with Orfax's script and Romdata, or you can follow the other advice at to get useless Roms out of your Mame XML (personally I prefer to do both and have both "full" and "selection" QP folders for Mame, but its up to you.

Run the perl script

rename the ROMDATA file asin the screen and then run the perl script like this (you did install ActivePerl right?)

Put empty ROMS in MAME folder

Depending on which option you chose, the script may have made a subdir in its own folder called empty roms. If you want ALL the games in Mame, or if you have a fully-merged set, please move this folder to your Mame/Roms directory, and begin the scanning process in Quickplay from scratch again to get back to this point. That will give you ALL the games.

Place romdata in folder

The script creates ROMdat.dat - put that back in the QP MAME folder you setup.Now you have ROMS and ROM info

Link to History and Info

7 link to history and info.png
QP needs history.dat and mameinfo.dat usually in MAMEUI's main directory, or available via here and here so link to the folder containing them in the arcade section in Media Panel - now you can get the MAME text. (note these have to be unzipped at the minute - we are looking at getting the zip support working for these files).

Add the MAME assets to QP's media panel

7 link to history and info.png
To start seeing the extra stuff you need to go into the QP media panel and start pointing to things in the 'arcade' section

Add icons path in folder options

Although in QP you setup the majority of extras in the media panel, ICONS are a per-folder thing - so you need to tick that box in the last tab of folder options (right click on the folder to get the folder options) and point to where the ICONS are (I'd recommend extracting his ICONS instead of pointing to the Zip as its a bit faster)

Final Product

The result is very good - well worth the effort! This WILL work in QuickPlay itself very soon without the need for the Perl script.