DatFiles

If you want to use ClrMamePro with other emulators you can write a DatFile or - if the emulator has an option to create a romlist- modify the engine.cfg.  DatFiles for a lot of emulators can be already found on my homepage.

It's easy to write a datfile for a different emulator. Just take a look at M.A.M.E.'s -listinfo output. ClrMamePro parses the following tags:

Standard tags:

set, name, cloneof, description, rom (name, size, crc, crc32, md5), sample, sampleof, year and manufacturer

The order and the case doesn't matter ! The space between a tagname and its attribute or a '(' or ')' is important. The description name has to be in quotation marks. If you're using quotation marks within a name, use '\"'.

Example:

set (
name pacman
cloneof pacman
description "PuckMan (Japan set 1)"
rom ( name namcopac.6e size 4096 crc fee263b3 md5 3f84d78d59147b9b3c816da72110e55f)
sample shot.wav
sampleof galaxian
)


ClrMamePro is able to read ROMCenter DatFiles, too. Use them on your very own risk. ROMCenter is (C) by Eric Bole-Feysot.

ClrMamePro specific tags

ClrMamePro uses some datfile flags. These are:

game (
...
    rebuildto namco\english
...
)

rebuilds the files of this set to: rebuilderdestinationpath + "namco/english"

Some profiler specific settings


Engine.cfg

Normally you shouldn't modify engine.cfg !!! If you want to add a new emulator or new biosroms, you should contact me. But anyway...here is a short description of the engine.cfg syntax:

engine ( )

Each engine starts with this keyword. Be sure to keep spaces between the keyword and the brackets.

 

name

Name of the current engine. This name will be displayed in the settings window.

 

cachefile

Filename of the cache-file in the <clrmamepro>\cache folder.

 

command

Parameter for the binary to produce a romlist. E.g. MAME.EXE produces a romlist when calling MAME.EXE -listinfo. If no command keyword is given, the engine will be a datfile engine. The enginename isn't a binary and will be handled as a pure datfilename.

 

ignore x

Mean that keyword x is ignored while parsing the romlist data. E.g. you can forbid the usage of samples by: 'ignore sampleof' and 'ignore samples'. For a list of possible values of x look at 'replace x y'.

 

replace x y

Means that special keywords x in the romlist will be replaced by new keywords y. For example: replace crc32 crc will replace crc32 tags with crc. Of course you can only replace keywords. Available keywords for y are:

cloneof
description
game
name
crc
mp5
romname
size
rom
sampleof
sample
manufacturer
year
resource
biosname
biosdescription
bioscrc
biosromname
biossize
biosrom
biosmp5
biosmanufacturer
diskimage
diskimagename
diskimagechd_md5

Example:

The current MAME engine looks like this:

engine (
name MAME
cachefile _mamedat
command -listinfo
)