Rom Mapping

Description

• This feature allows you to use alternate rom and/or archive filenames, different than what's defined in your database (xml).
• Main use of this is so you can use an official HyperList xml and match it up with your, using Tosec as an example, tosec-named ISOs
• With the Launch Menu enabled, you can present the user with a choice of slightly different versions of roms to choose from. For example, USA, Spanish, Translated-Japanese, hacked, etc.
• Backgrounds for the menu are pulled from your "Media\Backgrounds" folders.

Rom Mapping ini(s)

• Found at ".\Settings\SystemName\Rom Mapping\*.ini". Ini(s) can be named whatever you want.
• You need to create the ini file(s) if you want to use this feature. HyperLaunch will not create these for you. I suggest one ini file for each naming schema (tosec, trurip, redump, custom, etc..)
• Rom_Extension still needs to include the extension of the rom inside the archive (ex. iso) and the extension of the archive (ex. 7z)
• For each rom you want to remap, create a [Section] in this ini. The name of the section must match the game name sent to HyperLaunch (your rom name in your xml).
• The Alternate_Archive_Name should point to the filename (w/o the extension) of the rom you want to load instead.
• If you only want to define one alternate rom to look for, create a key Alternate_Rom_Name
• If you need to define multiple rom names to look for, create multiple keys like this: Alternate_Rom_Name_1, Alternate_Rom_Name_2, Alternate_Rom_Name_3, etc.
• Be careful, the more inis you have in your folder, the longer it will take to create the table as it has to scan each one and verify any matching sections and every alternate name will have an I/O check if it exists on your drive.

Scenario 1:

You simply want to use another rom's naming schema that doesn't match HyperList's No-Intro style and that naming schema uses the same exact filename inside and out of the archive.

[Sega Rally 2 (USA)]

Alternate_Archive_Name=Sega Rally 2 v1.003 (1999)(Sega)(NTSC)(US)[!]

Scenario 2:

You want to use another rom's naming schema that doesn't match HyperList's No-Intro style and that naming schema uses a different filename inside the archive than what the archive filename uses.

[Sega Rally 2 (USA)]

Alternate_Archive_Name=Sega Rally 2 v1.003 (1999)(Sega)(NTSC)(US)[!]

Alternate_Rom_Name=Sega Rally 2 (Sega)(NTSC)(US)[!]

Scenario 3:

Remap your database name to an uncompressed rom name. You do not need to define an Alternate_Archive_Name, simply define an Alternate_Rom_Name instead:

[Sega Rally 2 (USA)]

Alternate_Rom_Name=Sega Rally 2 (Sega)(NTSC)(US)[!]

Scenario 4:

You want to build a specific list of roms for the launch menu. Set Show_All_Roms_In_Archive to false and create a detailed section like this:

[Super Mario World (USA)]

Alternate_Archive_Name=Super Mario World

Alternate_Rom_Name_1=Super Mario World (1991)(Nintendo)(US)[b]

Alternate_Rom_Name_2=Super Mario World (1991)(Nintendo)(US)

Alternate_Rom_Name_3=Super Mario World (1991)(Nintendo)(US)[h]

Alternate_Rom_Name_4=Super Mario World (1991)(Nintendo)(US)[h2]

Alternate_Rom_Name_5=Super Mario World (1991)(Nintendo)(US)[t]

Alternate_Rom_Name_6=Super Mario World (1991)(Nintendo)(US)[tr de]

Alternate_Rom_Name_7=Super Mario World (1991)(Nintendo)(US)[tr el]

Scenario 5:

You want to show a list of all roms available inside the Alternate_Archive_Name for the launch menu. Set Show_All_Roms_In_Archive to true and create a simple section like this:

[Super Mario World (USA)]

Alternate_Archive_Name=Super Mario World

Scenario 6:

You want to show a list of all MAME Clone roms that don't actually exist in a folder or their names are not known in the launch menu and your front end is only showing parents. Set 7z_Enabled to false, SkipChecks to Rom Only, Rom Mapping to true, and Launch Menu to true. Now for each Parent game, list all the alternate roms as the clones. This method also allows you to show a list of alternate roms along with the rom listed in your database.

[puckman]

Alternate_Rom_Name_1=pacmanbl

Alternate_Rom_Name_2=pacmanbla

Alternate_Rom_Name_3=pacheart

Alternate_Rom_Name_4=pacman

Alternate_Rom_Name_5=pacmod

Note: The romExtension that gets sent to the module is the same one sent to HyperLaunch at launch. If your rom was a zip, the clone extension will be zip. It is impossible to look for an extension when this method does not look for another rom file. If you need to assign a different extension, it needs to be done in the module.

Bonus Scenario (same as 1):

Use normal artwork and database names for ZiNc while still launching the emu correctly. Roms must still be named with numbers:

[Aqua Rush]

Alternate_Archive_Name=63

Ini Keys

(These keys can be found in the Global HyperLaunch.ini and the system's HyperLaunch.ini)