====== Zen Pinball FX (Steam 2023) ======
----
===== Setting up Pinball FX (steam) =====
These instructions will get Pinball FX Steam version up and running with all the tables and IDs ready to go.
Firstly, you will need to download Pinball FX (and steam if needed) on your PC. It's free to download and comes with some free to play sample tables that you can try out and see if your hardware is up to the task of playing 'nicely'. (Pinball FX requirements seem to be much more than previous FX3). Press O or ESC to bring up options and configure your "settings/control"
To make life easier setting up backglass and DMD, you should copy down the ScreenX/Y positions and height,width settings from your **PinUPPlayer.ini** (located in your **pinupsystem** root folder). For backglass, copy the numbers down from [INFO2] section(see image below), then for FULLDMD users, copy the numbers from the [INFO5] sections, for SLIMDMD(4:1) users, copy the numbers from the [INFO1] section. These numbers will be used to update FX's cabinet mode values during config.
{{:bfb148bab67ecca1c8c9c5c51b318712.png}}
Pinball FX doesn't require you to use any 3rd party tools to rotate screens and supports backglass and dmd windows for multiple montior (cabinet) setups. Once you are running Pinball FX you can go into options/screen and configure (Press the the Letter O (not zero) for options). Go into "Settings/Video" to setup Video options. You can also press esc to bring up menus in certain spots.
You want to setup your video to have "borderless windows" and the rotation needed for your setup. Here's a sample that will work for most default setups:
{{:600d0df168d9d7999c723291948b6966.png}}
**Enabling Cabinet Mode:**
In Pinball FX options menu theres a "Cabinet Support" button, press and then enable cabinet support. You can to then go to each the "DOTMATRIX" and "Backglass" tabs and Enabled each and set the values Width,Height from above and set the Horizontal (xpos) and Vertical(ypos) values that you wrote down prior.
Note: if you have any errors or weird things that lock you out of cabinet mode, or want to set stuff manually. The settings file used by FX is located here (use any text editor). (folder may be diff depends on where you installed steam).
**C:\Program Files (x86)\Steam\steamapps\common\Pinball FX\PinballFX\Mods\Cabinet\Settings.ini**
OK. Run some sample tables and see if DMD is in correct area and YOU WILL HAVE a black window on BG with an ERROR about missing file… that is ok for now as we haven't setup any media yet.
Exit PinballFX and now its time to setup Popper to launch and close Pinbal FX.
----
===== Setting up Popper to Launch Pinball FX. =====
First we need to confirm/know where your PinballFX is installed. In Steam, go to your library tab and right-click on "Pinball FX" and select Manager/Browse Local Files.
{{:27bc72add98a52a1234cfa317926406f.png}}
That will bring up a windows files explorer and you should make note of the locations if you installed steam/pinball fx into 'standard' locations like this.
{{:75ac727d7619f6ab516d5f5142e5432d.png}}
if it looks like above we know that steam.exe is located here. If yours is different then you need to find where your steam.exe is located manually.
**C:\Program Files (x86)\Steam**
Also, if it looks like above that means the Cabinet MODS folder is located here:
**C:\Program Files (x86)\Steam\steamapps\common\Pinball FX\PinballFX\Mods\Cabinet**
This folder is important as this is where you will put the Backglass PNGS for each of your tables. Media links will be available below.
Now we have those two folder locations we can now setup the emulator in Popper.
Go into Popper Setup/Emulators and press the + button to add a new emulator.
{{:d99ec5d9438dd76ea1bb7ceb16e0f745.png}}
Then on launch Setup tab,
Launch Script: (this script will change in future once full command-lines are supported by Zen Pinball FX)
SET ALTPARAM=
if "[ALTMODE]"=="Classic" (SET ALTPARAM=Classic)
if "[ALTMODE]"=="Hotseat2" (SET ALTPARAM=Hotseat_2 )
if "[ALTMODE]"=="Hotseat3" (SET ALTPARAM=Hotseat_3 )
if "[ALTMODE]"=="Hotseat4" (SET ALTPARAM=Hotseat_4 )
if "[ALTMODE]"=="Pro" (SET ALTPARAM=Pro )
if "[ALTMODE]"=="Practice" (SET ALTPARAM=Practice )
START "" "[STARTDIR]Launch\VPXSTARTER.exe" 5 5 20 "PinballFX"
cd /d "[DIREMU]"
START "" "steam.exe" -applaunch 2328760 -Table [?ROM?] -GameMode %ALTPARAM%
Close Script:
"[STARTDIR]LAUNCH\PUPCLOSER.EXE" WINTIT "PinballFX" 4 1
----
===== Adding Games: =====
**Always backup your db before adding many games. Popper Setup and press the Backup DB button…easy!**
Grab the pupgames import file from here: (unzip the file to a temp folder): (Last update June 27th 2024 version)
[[https://www.nailbuster.com/pinupdates/ZenFX_2024_v7.zip|https://www.nailbuster.com/pinupdates/ZenFX_2024_v7.zip]]
go into Popper Setup/Game Manager and filter emulator and select "**Pinball FX**". The list should be blank and you want to right-click on grid and "import new games" from the above pupgames file.
{{:72f93411723da95a14929e8211116777.png}}
Now add a playlist for Pinball FX.
Go to Popper Config/PlayList Config
Add new Playlist "Pinball FX" from root (or wherever you'd like) and go to settings tab and set it to active sql.
Note: this will add all the available Tables for PinballFX. If you only purchased a few then you will need to go through list in games manager and set the **Status **field to 'Inactive' on ones you want to hide, OR you can set the playlist to NOT be active-sql and just add your purchased tables manually to playlist.
{{:88ca0c4092209a4ef32b3104b023c94e.png}}
Select * from Games where EMUID=10 and visible=1 order by GameDisplay
You will most likely need to change EMUID=10 to your Emulator ID in your system. Easy way to see the EMUID of your PinballFX is to use the drop down in playlist form, top-right "filter Emulator" drop down will list all emulators with a #XX represents its ID in system.
{{:1e67cedb55a3d5ce7630cae28ffd4c88.png}}
Save changes on your Playlist.
Note: You can drag/drop the New Playlist to move the display order of playlists in your tree-view. After you move you MUST press the 'save display order" button to save position.
----
===== Adding Media for all Pinball FX Tables. =====
Using the following links you can copy/paste into folders to setup all the Wheels, Backglasses and Playfield Media in one go.
//Special thanks to Hawkeyez88 for helping create the Wheel-Images,and Brian HasKell for Background images sourcing. //
**Wheels**: [[https://mega.nz/file/7INCgLja#ukfk3wnbm2MGllbQEjxLVz3gzKyuV_cEbG9yFfpqveo|https://mega.nz/file/7INCgLja#ukfk3wnbm2MGllbQEjxLVz3gzKyuV_cEbG9yFfpqveo]]
Copy all the PNGS into your Pinball FX wheel folder. Easy way to get there, in media manager, select one of your Pinball FX Games in the gamelist. Then right-click on the WHEELIMAGE box and select "open explorer". That will bring up windows file explorer where all your wheels for PinballFX… paste all wheel pngs (tableXX.png…etc) into this folder. Thats It.
**Backglass (3 screen Layout)**: [[https://mega.nz/file/vEtR2IgJ#ixBByT2BBU-abW9kX3oQMYjPlHWu9e1FiO-WwXeD5RE|https://mega.nz/file/vEtR2IgJ#ixBByT2BBU-abW9kX3oQMYjPlHWu9e1FiO-WwXeD5RE]]
Use the same idea to copy/paste all your backglass images in one go. In the example above with wheel images, you right-click on your backglass box and "open explorer" and then paste them all.
**Backglass (2 screen layout, dmd on backglass)**: [[https://mega.nz/file/fMsR0CAL#WUbzhvOUrxJ61bqLhb5ZvutVf6IymKUJ34ctN-psM2c|https://mega.nz/file/fMsR0CAL#WUbzhvOUrxJ61bqLhb5ZvutVf6IymKUJ34ctN-psM2c]]
Follow the same instructions above for 3 screen layout to copy all the backglass images in one go.
PlayField Videos: not available yet, check back or record your own within Popper yourself, its easy :)
**Important:** For now, we want to keep all graphics during gameplay controller by PinballFX. That means PinballFX will control and display the DMD and BackGlass pngs within PinballFX (not using any sort of keep-display-on in Popper). In order for PinballFX to have media to display on the Backglass you must copy TABLE_XX.png files into its cabinet folder. So using the same media zip above for backglass images, you will copy the backglass pngs into the PinballFX cabinet folder: Location is same folder we found above:
**C:\Program Files (x86)\Steam\steamapps\common\Pinball FX\PinballFX\Mods\Cabinet**
Thats it. Make sure you do not set any Keep-Displays-ON in Popper for PinballFX as fullDMD and backglass is being drawn by PinballFX.
note: When PFX displays a 4:1 dmd on your FULLDMD monitor it will center it and you will have black-bars on top and bottom. You still cannot use Popper-Media to fill that as PFX draws ON-TOP the entire display. There maybe a external solution that will draw a overlay (with 4:1 punched through) to make FULLDMD look nicer with 4:1 dmds. Check back in future this page.
===== Controller/Plunger/Nudging in Pinball FX. =====
Still gathering info from community…some have success using Steam to map their controller, other have mentioned to use X360ce, must be 64-bit version and IMO use [[https://www.x360ce.com/files/x360ce_x64.zip|v3.2]] of x360ce ([[https://www.x360ce.com/|website]]) and place the files into the folder:
**C:\Program Files (x86)\Steam\steamapps\common\Pinball FX\PinballFX****\Binaries\Win64**
or wherever the **PinballFX-Win64-Shipping.exe** is located for you.
===== Switching between FULLDMD and 4:1 DMD on the fly =====
see here: [[https://www.nailbuster.com/wikipinup/doku.php?id=zen_fx_dmd_options|https://www.nailbuster.com/wikipinup/doku.php?id=zen_fx_dmd_options]]
===== Adding future games to FX when released =====
The pupgames fx file may be dated and not contain #'s and tables that FX releases in the future. You can wait to see till an updated pupgames is available or you can simply add them manually.
To add manually to Popper you need to know the new table id # that FX released. Hopefully FX/somewhere will post this ID#.
- Create a new permanent zenfolder somewhere on your drive.
- Set in Popper "FX Emulator Setup" Games Folder to point to folder in step 1 (also keep the extension pxp)
- Go to folder in step1 and manually create a text file and rename that file to tabe_876.pxp (876 is the new ID that zen needs to tell us)
- Scan and add games in Popper Conifg to FX emulator (exactly like a VPX table). Go to game and update the GameDisplay/other info, and **ROM** field. NOTE: FX uses the ROM field for launching. So you need to change the ROM field on this new game record to just the number (ex. 876).
Test Launching. In future you just need to start from step 3 for each new game released.