User Tools

Site Tools


This is an old revision of the document!

Trouble Shooting Pup-Packs

PuP-Packs are a combination of videos/media and config files to work with tables so that the media will play during gameplay.

There are actually 3 different methods Pup-Pack authors can choose to get it working.

1> table script (example: stranger things SE edition). this is where total control of the PinUP Player system is controlled by vpx table script. You DO NOT use pinuppackeditor.exe to customize these tables, in fact if you try and create a b2spup file with these tables you will be screwing up the puppack config.

2>b2splugin. This is where the puppack grabs events from table like 'switch 13' is triggered. You can then have video/sound play when that switch is triggered. This is great as it involves no table script changes and can be distributed without any care about which table version or table script is running. It works solely on the romevents. Limitation is that it is difficult to make a really 'top-quality' puppack using just romevents. Table script interface give you more 'fine-tuning' than just rom events.

3>PuPCapture: this is a great way and usually the best to use now if you don't know table script PuP interface. Using Freezy DMD DLL interface v1.7.1 or newer PinUP will 'scan/match' frames and trigger events that way. This allows a lot of great flexibility like knowing when multi-ball starts/ends, jackpots… all without knowing rom events/switch #s. etc.

I would suggest watching this video if you haven't seen it before. It will go through how to setup and even troubleshoot puppacks. :

ok. regardless of the method. to install a puppack you need to unzip/copy the rom_folder_name to your PuPVideos subfolder of PinUPSystem.

it will look something like this for trn_174h puppack


in this folder is where the media is (you should NOT have it like this: c:\PinUpSystem\PuPVideos\trn_174h\trn_174h… that would be WRONG)

Ok, so assuming you followed the PinUP System install videos on this site and placed the puppacks. Starting/Launching the tables should work automatically.

Most important: Make sure you have Freezy Setup to latest v.1.7.1 or newer. See Here:

BUT here are some things you need to check if things don't work.


Make sure your B2S is set to allow plugins: right-click on a backglass and make sure these settings are set like this:

You should also press the plugin settings and make sure is says PinUP Player 'active' with no errors. (you will need to restart vpx editor/table after you change settings)

Other items:

Make sure you have dmddevice.ini setup correctly and is located in your vpinmame root folder!. see:

For PuPCapture tables you need to make sure 'Use External' is set when you press F1 (vpinmame) setup within game.

If your videos looks scaled or shifted, then make sure ALL your monitors in windows are set to 100%dpi (no scaling).

MAC Users. Did you unzip/zip/copy the pupfolders from a MAC/Ios computer? if so check in windows that the hidden files that MAC uses didn't get copied into your PUPVIdoes. (enable hidden files in WINDOWS and if you see like 0 KB mp4 files… you must remove all hidden/MAC files from PUPVideos if found)


Verify your Windows screens are setup like above. Your playfield must be left, and other screens to the right-only. No pupscreens should be above or below your playfield. Verify that all your PuP Displays have no negative positions for xpos, ypos and width and height don't cause the display to bleed onto multiple screens.

my directb2s backglass is overtop the pup-pack/player?”. Almost every PuP-Pack (see each packs install text) will require that you DO NOT have a directb2s backglass file enabled for that table. b2s screens will always go 'over' puppacks and screw up layering so you need to rename/delete/move the tables xxx.directb2s file. NOTE: if b2s server doesn't find an exact tablename.directb2s it will auto-scan/find another directb2s file matching ONLY the first 6 characters. This means that if you rename your existing directb2s file that you make the first 6 characters different. A good practice you may find is to name your PUP Table VPX table like “PuP Bugs Bunny.vpx”

One thing to check for for Packs that use PuPCapture. That using a different language than the author's PuPCapture will mean that they won't match and PuP Videos won't show. So if author of pack used engish version of ROM then french words on rom won't match.

Also, you may think you have a PuP-Pack working but could be missing 80% of the videos. A PuP-Pack can use a combination of rom_events and PuPCapture frames. so you may only be seeing the rom_events videos.

Start the table you may be having a problem with. then exit the table.

go to you vpinmame folder and examine the PUPLOG.TXT file. (this file is created each time a table is launched).

Here a good sample of what Avatar will look like:

20180712 13:16:18 Open called
20180712 13:16:18 Set Game Name thread avr_200
20180712 13:16:18 Start Thread Matching
20180712 13:16:18 create PuPCap
20180712 13:16:18 Init Game name:avr_200
20180712 13:16:18 Create Object Display
20180712 13:16:18 imagedir:C:\VISUAL~1\Tables\PINUPP~1\PuPVideos\avr_200\PuPCapture
20180712 13:16:18 num images 49
20180712 13:16:22 Free Object Display

if you don't have a puplog.txt file then you are not configured correctly.

Make sure there are no blocked dlls in your vpinmame folder like the 'dmddevicepup.dll'.

Having certain programs running in the background can also cause issues as they may interfere with VLC or prevent Overlays from displaying. Try closing out other programs / processes to see if that helps resolve any issues. Some reports of Logitech Gaming Software installed may cause issues, can try uninstall Logitech software to see if that helps. Another possible item was a Remote Desktop Sharing agent running. So best to disable all items to check and enable one-by-one to see if it helps.

also, if you are NOT using freezy dmddevice.dll, like perhaps you are using luckys' pin2dmd dmddevice.dll then you will not be able to use any puppacks that use PuPCapture (most will in the future).


If you have video stuttering or artifacts with PuP-Packs with VPX… you most likely don't have VSYNC properly setup in VPX. Set “FPS Limiter/VSYNC” to 1, and “Maximum Pre-Rendered Frames” to 1 in VPX Video Options. This can also be set per-table in the Table's “User Customization” options, so check that as well.

Check that you aren't using PinAffinity (a tool for pinball that directs cpu/cores to pinball apps). This util will affect performance of either vpx or Pinup during gameplay.

Don't have a Topper? some packs may have the Topper setting to force-on, which may slow down your system. Run pinuppackeditor.exe and load up the Pack and set the topper to 'off' manually.

try this: exit everything/all apps. run in pinupsystem the pinuppacktester.exe and load up the pack rom. put task-manager on your playfield monitor, and send all sorts of D# events and see what type of cpu/gpu usage you get. (this will only work on pupcaputre packs)

Also, other VPX Videos settings can cause issues in VPX if your system is not able to handle running VPX and a some of the more demanding PuP-Packs. Things like brute force AA, Ambient Occlusion, and the Reflection options can severely affect performance, and its a good idea to disable those options, unless you have a high end system. The following is a good reference for how you should have your VPX video setting for good performance, using exclusive fullscreen (change the resolution for your screen):

Now that you know the basics of getting PuPPacks up and runnings… watch the videos here to get to know all the customized features you can use with PinUpPlayer.

When I close a table with a PuP-Pack the media continues playing (won't close) when I return to frontend.

Some things to try:

  • pinupmenu.exe needs to be run as admin (and nothing else in PinupSystem folder)
  • UltraDMD tables. Some of these tables don’t have a proper closing or exit part added to the table’s script
  • you may have something else causing an error in the background that you may not notice.
  • SAM (Stern) tables and at91jit can cause issues for some people and cause crashing
  • the PuP-Pack may be too much for your system to handle, so it didn’t exit out properly after having some kind of crash.
  • FX3 tables using dmdext and pup / doflinx can’t have dmdext run as admin, or the pup-pack won’t close out when exiting the table.

With Popper make sure your VPX exit key is not the same as Popper Exit Emulator Key.

If it happens only on some tables, it could be a problem with the VPX Table script not closing out B2S properly.

Open up VPX Table Script and look for a sub like this. You want to make sure it has Controller.Stop line in there somewhere. If Sub doesn't exists you may have to add it.

Sub table1_Exit
End Sub

If you still cannot cleanly close-out of PuP-Packs then try this pupb2s driver for vpx:|

puppack_troubleshoot.1557444591.txt.gz · Last modified: 2019/05/09 19:29 by pinupadmin