PUP Packs - dekay/vpinball-wiki GitHub Wiki

PuP Packs adds media contents to tables. More info on the product page.

[!NOTE] PuP Packs do not work at all on the iOS or Android builds of Visual Pinball at this time as discussed here. PuP support is only partially implemented in the Standalone versions: some tables are playable but many will have issues. This gist explains the issues.

Add PuP Packs to an Existing Table

VPinball will search for PuP Packs in a pupvideos directory in the same directory as the *.vpx file.

When a PUP Pack archive has been downloaded, the first thing to do is locate the root directory of pup media files. This is usually a directory containing a bunch of *.bat files. This directory must be copied into the pupvideos one created before.

For example, given the following archive content:

Futurama PuP and media pack.zip
  Instructions/
    Instruction.png
  puppack/
    futurama/
      Backglass/
        newbackglass2.png
      Option 1 - Backglass DMD Separate.bat
      Option 2 - FullDMD on Backglass.bat

The entire puppack/futurama directory should be extracted into pupvideos, giving the following structure:

table.vpx
pupvideos/
  futurama/
    Backglass/
    Option 1 ...
    ...

The last thing to do is configure this pack according to your screen settings. PUP Packs generally offers several options in the form of *.bat files to execute. In non-windows systems, you will need to read those files to manually apply the appropriate commands. In the example above, the Option 2 - FullDMD on Backglass.bat tells us:

rem echo off
xcopy /y "PuP-Pack_Options\Option 2 - FullDMD on Backglass\*"
del /Q PuPDesktopPunch.exe
del /Q PuPInit.bat

This tells us to copy all files in pupvideos/futurama/PuP-Pack_Options\Option 2 - FullDMD on Backglass/ into pupvideos/futurama. Once all this is done, the default settings in VPinballX.ini should be enough to display this PUP Pack.