Guides ‐ Adding Alias Mappings - syd711/vpin-studio GitHub Wiki

Configuring a VPinMAME alias for a VPX (Visual Pinball X) table involves a few steps to ensure that the alias is recognized and works correctly. Here's a step-by-step guide to help you set this up:

Step 1: Identify and change the ROM

First, identify the ROM file associated with the VPX table. This ROM file is typically named something like "cGameName" in the VPX script and is used by VPinMAME to emulate the game's hardware. Use the script editor and replace the "cGameName" value with the desired alias.

In this example, we set the alias for the AC/DC table to acd_170hcPUP.

Step 2: Edit the Alias File

VPinMAME uses an alias file to map ROMs to aliases. This file is named VPMAlias.txt. Edit the file via the editor in the VPinMAME section:

Add the alias: You need to add a line to create an alias for your ROM. The format is ALIAS,ROM where alias is the name you want to use, and ROM is the actual ROM file name.

For example, if your real ROM file is named acd_170hc and you want to create an alias acd_170hcPUP, you would add the following line:

acd_170hcPUP,acd_170hc

Save the changes and close the editor.

Step 3: Test the Table

Just to be sure all changes have been detected properly, ru a table scan to read the updated alias mapping and the updated table script. In the VPinMAME section, you should see the updated alias mapping:

Reload the table overview and run the table: Start the table in VisualPinballX and check if the ROM initializes correctly using the alias. Check also if the optional PUPPack is still resolved correctly.