PinEvent Guide (for TerryRed's releases on Future Pinball)

[TerryRed]

 

 

What is PinEvent V2?

 

I created PinEvent V2 so I could have a complete feature set and quality standard for my own table releases on Future Pinball. When you get a PinEvent V2 tables, you'll know exactly the features it will have and support.

 

PinEvent V2 features:

 

• DOF (direct output framework) for cabinet feedback and lighting
• Night mode (turn off DOF noise makers at night)
• Pinup Player / PuP-Packs
• PUP DMD for a dazzling modern display for scores, text and videos
• PUP SSF (surround sound feedback) and 3D positional ball rolling
• PUP Stream which can stream the PUP DMD display into FP directly
• no need for additional apps to control DOF or PuP
• TILT BOB support for analogue nudge
• optional PinEvent V2 global settings
• optional custom PinEvent V2 settings per table
• works in ALL modes (Desktop, Cabinet, VR)

 

 

What is PinEvent V2 used with?

 

• All of TerryRed's PinEvent V2 releases for Future Pinball

 

 

PinEvent V2 features are all optional:

 

• PinEvent V2 tables work in all setups (Desktop, Cabinet, VR)
• they don’t require additional files to be able to run
• you only need DOF and Pinup Player installed if you wish to use those features

 

Why was PinEvent V2 created?

 

• Future Pinball restricted the usage of external applications with tables. This made it difficult to add DOF and PUP support to Future Pinball tables
• PinEvent V2 uses the new COM Extensions plug-in for BAM (made by Nailbuster and ravarcade) that allows Future Pinball to "directly" access DOF and Pinup Player and be able to use ALL their features!
• as a result I was able to make a new script / command standard for myself to add DOF / PUP / SSF features to any Future Pinball table

 

 

What does PinEvent V2 do?

 

PinEvent V2 will manage and control DOF, PUP SSF, PUP DMD, PUP Stream, TILT BOB, and Night Mode features.

 

 

I don't have a cabinet, or I don't use PuP or DOF. Do I need PinEvent V2 files or extra programs, if I just want to play a table that has PinEvent V2?

 

No. The new PinEvent V2 code allows the table to simply work for "everyone" like any other FP-BAM table.

 

 

Example of PinEvent V2 on Sonic Pinball Mania, showing the PuP-Pack being used for the backglass, and for the PUP DMD display.

 

 

 

 

 

==========================================================================

 

 

DISCLAIMER

 

Please DO NOT use the name PinEvent in your table mods or code

 

• “PinEvent” refers to my own table releases only
• “PinEvent” has specific features and updates that represent my own work
• please do not use the name “PinEvent” when referring to PUP or DOF mods of a FP table
• I don’t want any confusion
• I will not give support to any mods of PinEvent tables or code
• I will only give support and add updates to my own PinEvent releases

 

PinEvent V2 tables and mods

 

You are free to mod PinEvent tables, but please consider the following:

 

•  some PinEvent tables may be an update to a table from someone else who may not want their creations converted to or used on another program such as Visual Pinball. This can be confirmed at the top of the table script
• if modding, please wait a long while after I release a table, and ask me first as I am always adding updates and fixes
• I may make changes to both the DOF config and the pup-pack in the future which will no longer be compatible with older table versions
• PinEvent tables have complex control code for PUP and DOF
• table mods may be used by some people in a cabinet with expensive feedback and lighting hardware. If you can’t test all of these features, then you could be allowing the table to cause unknown damage to the cabinet or hardware!
• I will not recognise any mods as “PinEvent” tables, and will not give support for them. I will direct ALL support to you
• I worked VERY hard to create a standard of “quality” and “support” for my releases. Please respect that.

 

Please DO NOT modify my DOF configs for PinEvent tables on DOF Config Tool

 

• I have VERY specific DOF configs that are designed to work with PinEvent updates only!
• you can make your own DOF changes on your own Private config
• DO NOT submit changes from your private DOF config for Public consideration! (if there is a problem on one of my tables, please message me)
• I specifically added separate “PinEvent only” configs so that everyone is free to use the normal FP configs to mod other FP tables for DOF

 

You CAN add PuP and DOF to your own tables or mods (you don’t need PinEvent code)

 

• here is an All In One Example table and Tutorial that includes everything you need to add FizX physics, FLEEP sounds, DOF, PUP SSF and Ball Rolling sounds to your own FP tables easily!

 

https://pinballnirvana.com/forums/threads/all-in-one-example-table-fizx-fleep-ball-rolling-pup-ssf-dof-easy-to-add.21983/

 

 

TerryRed

 

 

 

============================================================================================================

 

 

 

****** PinEvent Guide ******

Created by: TerryRed

Version: 3.0, Oct 2023


What is included?

 

• PinEvent V2 Guide
• PinEvent_V2_Settings.txt (for global settings)

 

This guide is now completely updated:

 

• I now have all my guides and tutorials in PDF format
• this new guide has been created to be used with the FP and BAM Essentials AIO package
• all my guides and tutorials are now only included with the FP and BAM Essentials AIO package

 

 

You can download the FP and BAM Essentials AIO package here:

 

https://vpuniverse.com/files/file/14807-future-pinball-and-bam-essentials-all-in-one-complete/

 

A video tutorial that walks you through this guide can be seen here:
 

Chapters

00:00 Start
01:20 What is PinEvent?
04:28 PinEvent features
07:19 How does PinEvent work?
10:31 PinEvent Lite
11:21 Disclaimer
13:03 Requirements (for DOF, PUP, etc)
16:13 Windows, Defender, Security issues
17:57 PinEvent Settings
20:12 PinEvent Custom Table Settings
21:35 Pinup Player
26:09 PUP SSF
29:06 Future Pinball Backbox problems (the evil villain for FP PuP-Packs)
34:40 TILT BOB
37:21 DMDExt
40:22 PUPDMD
42:19 PuP-Pack Options
49:34 PUP Stream
54:46 PUP Stream setup
56:52 PUP Stream quick demo
1:01:34 How to install PinEvent table and PuP-Pack
1:04:40 PinEvent TABLE OPTIONS (in table script)
1:07:53 Popper options (to disable FP Backbox and DOFLinx, run DMDExt, etc)
1:16:05 Start FP BAT files (no front-end, disable FP Backbox, run DMDExt, etc)
1:17:32 Debugger features
1:19:56 Tables MUST use correct PuP-Pack version!
1:22:11 Closing

 

 

 

 

Edited December 6, 2023 by TerryRed

[chriss4198]

So excited for this!! Thanks for all ur hard work as usual. You create piece of art…

[TerryRed]

The first PinEvent V2 table and PuP-Pack is now available!


Sonic Pinball Mania - 1.2 PinEvent V2

Get the new 1.2 table update and new PuP-Pack here (when site admins approve it):
 

https://vpuniverse.com/files/file/9345-sonic-pinball-mania-pinevent-v2/

EVERYONE using PinEvent V2 features (DOF, PUP SSF, PUP DMD) MUST read the new install instructions included in the table's zip file!

 

 

 

[CaptainPower]

Thanks Terry, for all of the hours of fun your projects have given me!!

 

Take off eh

 

 

[TerryRed]

Blue vs Pink - BAM Edition (PinEvent V2) - Future Pinball

 

1.2 PinEvent V2 update and PuP-Pack - now available!

 

The second PinEvent V2 table and PuP-Pack is here.

 

This is my BAM Edition mod of this classic "original" FP table that gives it all new lighting, shadowmaps, ambient shows, ray cast shadows, newer physics, fleep sounds, new inserts, and more. This table update will work for everyone. Make sure you are properly setup and updated for FP-BAM first. Then install the table and play it like any other FP-BAM table. If you want to use PinEvent V2 features (DOF, PUP SSF, PUP DMD), then you need to read and follow the install instructions included with the table.

 

 

Table and PuP-Pack can be downloaded here (when available):

 

 

 

[TerryRed]

Sonic Pinball Mania

 

1.3 update

- added option to disable the Shield's SlowMotion (the slow motion made the game unplayable for some users - 5 fps, etc)
- updated Install Instructions
- added new info relevant to the new version of Baller Installer

 

Available once site admins approve.

 

 

 

[TerryRed]

PinEvent V2 Guide - 1.1 update

- updated various bits of the Guide
- added new information relevant to new version of Baller Installer
- updated FAQ

 

 

[TerryRed]

PinEvent V2 tables - new table updates (Future Pinball)

 

All PinEvent V2 tables have now been updated with the latest FizX updates and some hotfixes. These are the last updates I will be doing for a long time, as now I will be focused on working on Silent Hill.... and recovering from heart surgery.

 

 

These are the newest updates for all PinEvent V2 tables:

 

Blue Vs Pink - BAM Edition (1.8 - PinEvent V2, FizX)

F-14 Tomcat - AfterBurner (1.5 - PinEvent V2, FizX)

Halloween - Big Bloody Mike (1.6 - PinEvent V2, FizX)

Jaws - Bigger Boat Edition (1.3 - PinEvent V2, FizX)

Junkyard Cats - Bam Edition (1.7 - PinEvent V2, FizX)

Retroflair - BAM Edition (1.8 - PinEvent, FizX)

Sonic Pinball Mania (1.6 - PinEvent V2, FizX)

Star Wars DSA - Galactic Edition (1.3 - PinEvent V2, FizX)

 

- updated FizX physics code to change how ball ID's are handled to prevent conflicts

- updated FizX physics code for more efficient Rubber bounce handling

- updated Ball Rolling Sound code to change how ball ID's are tracked to prevent conflicts

- removed old PUPRollingUpdateTimer commands that are no longer used (would give an error if PinEvent Settings were forced to be disabled)

- other various fixes

 

 

Important! Please Read!

 

- ALL these new updates REQUIRE the latest BAM 1.5-357 or higher!

- patch both FP and BAM for 4 GB access after updating BAM, to be sure they are both patched

- FizX v2.0 no longer uses the older 8K Physics Ball! Do not use it anymore!

- install the 1K Physics Ball model now! (as default.zip in BAM folder, NOT the balls folder!)

- if using PUP features, you MUST install the "newest" PuP-Pack included with the table zip, or PUP features won't work!

 

 

If you installed Baller Installer and UPDATED it to the new Jan 2023 update, then you "should" be fully updated and ready for these new table updates!

 

 

Follow the Install Instructions (and its FAQ) included with the table if you are not sure you are updated correctly... have FP settings setup correctly (important)... or if having any problems.

 

 

New table updates are available when approved by site admins:

 

https://vpuniverse.com/files/category/5-future-pinball-tables/

 

 

 

 

 

 

 

 

 

 

 

[ManWorkingHere]

What about Pup pack videos and text that do not appear in proper orientation when playing just the PinEvent table using FPloader, or, when using Pinup Popper to launch?

 

 

Background

- My cabinet has 3 screens/monitors.

- I read the PinEvent guide and am checking that each of these steps are followed:

 

- ALL these new updates REQUIRE the latest BAM 1.5-357 or higher!

- patch both FP and BAM for 4 GB access after updating BAM, to be sure they are both patched

- install the 1K Physics Ball model now! (as default.zip in BAM folder, NOT the balls folder!)

- if using PUP features, you MUST install the "newest" PuP-Pack included with the table zip, or PUP features won't work!

 

Situation

- Pup pack media does not consistently display rightside up.

 

Where should I focus my troubleshooting?

 

I have not used PuP packs before PinEvent v2. 

 

 

 

 

and this table example too

 

[TerryRed]

38 minutes ago, ManWorkingHere said:

What about Pup pack videos and text that do not appear in proper orientation when playing just the PinEvent table using FPloader, or, when using Pinup Popper to launch?

 

 

Background

- My cabinet has 3 screens/monitors.

- I read the PinEvent guide and am checking that each of these steps are followed:

 

- ALL these new updates REQUIRE the latest BAM 1.5-357 or higher!

- patch both FP and BAM for 4 GB access after updating BAM, to be sure they are both patched

- install the 1K Physics Ball model now! (as default.zip in BAM folder, NOT the balls folder!)

- if using PUP features, you MUST install the "newest" PuP-Pack included with the table zip, or PUP features won't work!

 

Situation

- Pup pack media does not consistently display rightside up.

 

Where should I focus my troubleshooting?

 

I have not used PuP packs before PinEvent v2. 

 

 

 

 

and this table example too

 

 

 

You most likely have some of your screens in Windows set to "flipped" which will cause these kind of issues. Nothing can be done from the table / PinEvent V2's end to fix that. You need to set those displays so they are not flipped.

 

If you are running the table from FPLoader.exe and not from Popper... if you still have the FP Backbox and Arcade mode settings enabled (in FP video settings), then that may mess up things because the FP Backbox may block the backbox or may shift around positions if the FP Backbox resolution is not set to match your desktop resolution.

 

Also... you MUST have your PUP FullDMD displays set to a 16x9 ratio! This is required, or the text won't scale correctly. That's why everyone uses 16x9 monitors in their FullDMD in their cabinets. You can still set the pup FullDMD display to a 16x9 ratio resolution, and have small black bars left on the screen... but at least the pup-pack will look correct as intended.

[ManWorkingHere]

On 5/12/2023 at 7:22 PM, TerryRed said:

First, thanks for offering help on a problem that you cannot see:

 

 

You most likely have some of your screens in Windows set to "flipped" which will cause these kind of issues. Nothing can be done from the table / PinEvent V2's end to fix that. You need to set those displays so they are not flipped.

=> All screens upright.  The imagery shows everything displayed properly, just not the content in the DMD.

 

If you are running the table from FPLoader.exe and not from Popper... if you still have the FP Backbox and Arcade mode settings enabled (in FP video settings), then that may mess up things because the FP Backbox may block the backbox or may shift around positions if the FP Backbox resolution is not set to match your desktop resolution.

=> I did check this using Popper and using FPLoader.  Pup-pack content is showing, just not upright.  Testing using just FPLoader to keep things simpler now.

 

Also... you MUST have your PUP FullDMD displays set to a 16x9 ratio! This is required, or the text won't scale correctly. That's why everyone uses 16x9 monitors in their FullDMD in their cabinets. You can still set the pup FullDMD display to a 16x9 ratio resolution, and have small black bars left on the screen... but at least the pup-pack will look correct as intended.

=> I went out and bought a small, widescreen monitor from Facebook Marketplace for $15.  You can see it to the side of the cab.

=> Same problem displaying video content upside down.

 

I thought the video issue would be the version of VLC as I read elsewhere.  I did not see any guide on keeping VLC at a certain version.  I use VLC for other reasons on the cab so I downgraded the version, cleraed APPdata settings, and still get upside video when showing Pup-pack video.

 

Playing video via VLC outside of FP works fine.

 

Went out and bought widescreen monitor using 16x10 scaling

 

 

 

Text is fine, just not showing across the widescreen monitor

 

 

 

This jet is actually upside down

 

[TerryRed]

22 hours ago, ManWorkingHere said:

 

I thought the video issue would be the version of VLC as I read elsewhere.  I did not see any guide on keeping VLC at a certain version.  I use VLC for other reasons on the cab so I downgraded the version, cleraed APPdata settings, and still get upside video when showing Pup-pack video.

 

Playing video via VLC outside of FP works fine.

 

Went out and bought widescreen monitor using 16x10 scaling

 

 

 

Text is fine, just not showing across the widescreen monitor

 

 

 

This jet is actually upside down

 

 

 

Be sure you don't have any of the pup displays set to rotate by 180, 90, etc

 

 

[ManWorkingHere]

1 hour ago, TerryRed said:

 

 

Be sure you don't have any of the pup displays set to rotate by 180, 90, etc

 

 

 

 

That was the issue!   My DMD setting was set to 180 as you surmised.

 

In my context of Windows support, I thought you meant the display settings in Windows itself.  In your context focused on Pinup support, you meant checking Pinup displays set to None for the Rotation.

 

 

Thanks for straightening out, literally, my display issue, Terry!

 

 

Matt

[TerryRed]

1 hour ago, ManWorkingHere said:

 

 

That was the issue!   My DMD setting was set to 180 as you surmised.

 

In my context of Windows support, I thought you meant the display settings in Windows itself.  In your context focused on Pinup support, you meant checking Pinup displays set to None for the Rotation.

 

 

Thanks for straightening out, literally, my display issue, Terry!

 

 

Matt

 

 

I actually meant, check both.... but its been a long while since someone changed that in pinup settings... so you at least helped to narrow it down.

[TerryRed]

Do NOT use Windows 8 Compatibility!

 

In the past, previous Windows updates caused Future Pinball to crash for some people. The easy solution was to set FPLoader.exe to Windows 8 Compatibility. Newer Windows updates and newer BAM updates have long since solved that issue.

 

In my guides, I have only ever recommended to set this to FPLoader.exe "if having crashing issues". Since that is no longer the case, I no longer recommend that as even an option. If you are having crashing issues, update your Windows, update your GPU drivers, sound drivers, etc. (disable the Nihamic driver / services if you have them installed, as it causes problems)

 

I have found that enabling Windows 8 compatibility causes FP-BAM to have serious performance issues! (ball stuttering, etc) Make sure you do NOT have this set on either FuturePinball.exe or FPLoader.exe (and in BAM Open VR folder if using that)

 

[TerryRed]

 

****** PinEvent Guide ******

Created by: TerryRed

Version: 3.0, Oct 2023


What is included?

 

• PinEvent V2 Guide
• PinEvent_V2_Settings.txt (for global settings)

 

This guide is now completely updated:

 

• I now have all my guides and tutorials in PDF format
• this new guide has been created to be used with the FP and BAM Essentials AIO package
• all my guides and tutorials are now only included with the FP and BAM Essentials AIO package

 

 

You can download the FP and BAM Essentials AIO package here:

 

https://vpuniverse.com/files/file/14807-future-pinball-and-bam-essentials-all-in-one-complete/

 

 

A video tutorial that walks you through this guide can be seen here:
 

Chapters

00:00 Start
01:20 What is PinEvent?
04:28 PinEvent features
07:19 How does PinEvent work?
10:31 PinEvent Lite
11:21 Disclaimer
13:03 Requirements (for DOF, PUP, etc)
16:13 Windows, Defender, Security issues
17:57 PinEvent Settings
20:12 PinEvent Custom Table Settings
21:35 Pinup Player
26:09 PUP SSF
29:06 Future Pinball Backbox problems (the evil villain for FP PuP-Packs)
34:40 TILT BOB
37:21 DMDExt
40:22 PUPDMD
42:19 PuP-Pack Options
49:34 PUP Stream
54:46 PUP Stream setup
56:52 PUP Stream quick demo
1:01:34 How to install PinEvent table and PuP-Pack
1:04:40 PinEvent TABLE OPTIONS (in table script)
1:07:53 Popper options (to disable FP Backbox and DOFLinx, run DMDExt, etc)
1:16:05 Start FP BAT files (no front-end, disable FP Backbox, run DMDExt, etc)
1:17:32 Debugger features
1:19:56 Tables MUST use correct PuP-Pack version!
1:22:11 Closing