| Both sides previous revision Previous revision Next revision | Previous revision |
| systems:vpinball [2025/03/29 11:42] – [Table] toccata10 | systems:vpinball [2026/10/24 14:36] (current) – [Per Table folder organisation (V44)] fix table formatting again flyhigh32 |
|---|
| ===== All Paths ===== | ===== All Paths ===== |
| |
| ==== Per Table folder organisation (V39+) ==== | ==== Per Table folder organisation (V44) ==== |
| | Virtual Pinball is very flexible and provides support for alternative, optional features (alternate sound effects, colorized Dot Matrix Displays, etc) that may be separate from the main table download. These features are contained in files that are separate downloads and best organized in separate folders within that for the table. The recommended folder organization for use within Batocera **v44+** is shown below. (See also [[https://github.com/dekay/vpinball-wiki/wiki/File-Layout#the-main-table-folder| Dekay's unofficial vpinball wiki]]) |
| |
| Virtual Pinball is very flexible and provides support for alternative, optional features (alternate sound effects, colorized Dot Matrix Displays, etc) that may be separate from the main table download. These features are contained in files that are separate downloads and best organized in separate folders within that for the table. The recommended folder organization for use within Batocera **v39+** is shown below. | ^ Folder ^ Description ^ |
| | | /userdata/roms/vpinball/<table_name> | The VPX and any associated ''.directb2s'' or ''.vbs'' files. Any associated ''.UltraDMD'' folders should also be in this folder. Note: All file names (''.directb2s'', ''.vbs'') should match the ''.vpx'' file name exactly. | |
| | | /userdata/roms/vpinball/<table_name>/pinmame/roms | The PinMAME ROM of the table (in ''.zip'' format). (eg: ''userdata/roms/vpinball/AC-DC LUCI Premium (Stern 2013)/pinmame/roms/acd_170h.zip''). You will need to create this directory for those tables that require ROMs as they are a separate download from the table itself. Alternatively, you can put all your PinMAME ROMs in the PinMAME directory [[#pinmame|as described here]]. | |
| | | /userdata/roms/vpinball/<table_name>/altcolor | Optional Serum colorizations directory <rom_name>/<rom.cRZ> (eg: ''userdata/roms/vpinball/AC-DC LUCI Premium (Stern 2013)/altcolor/acd_170h/acd_170h.cRZ''). Create this directory as needed. Note that VP Standalone only supports the Serum (.crz) colorization format. Other colorization formats (.pac, .vni, etc) are closed source and not supported. | |
| | | /userdata/roms/vpinball/<table_name>/altsound | Optional alternative sound packages directory <rom_name>/<sound files> (eg: ''userdata/roms/vpinball/Batman (Data East 1991)/altsound/btmn_106''). Create this directory as needed. | |
| | | /userdata/roms/vpinball/<table_name>/music | The table's music files, if any. Create this directory for those tables where a separate download for the music files is required (e.g. ''Halloween 1978-1981 (Original 2022) 1.03.vpx'') | |
| | | /userdata/roms/vpinball/<table_name>/pinmame/nvram | PinMAME NVRAM (Non Volatile Memory with Pinball settings) | |
| | | /userdata/roms/vpinball/<table_name>/pupvideos | Pup Pack directory <rom_name> (eg: ''userdata/roms/vpinball/Tron Legacy (Stern 2011)/pupvideos/trn_174h''). You will need to create this directory if the Pup Pack is a separate download and not included with the table itself. | |
| | | /userdata/system/configs/vpinball | This directory is created automatically by Batocera for the ''VPinballX.ini'' configuration file and associated log files. If you have a problem getting a table to run, check the ''vpinball.log'' file in this directory. | |
| | ==== Per Table folder organisation (V39-43.1) ==== |
| |
| ^ Folder ^ Description ^ | ^ Folder ^ Description ^ |
| [[https://www.vpforums.org/index.php?showtopic=38669#entry388038|https://www.vpforums.org/index.php?showtopic=38669#entry388038]] | [[https://www.vpforums.org/index.php?showtopic=38669#entry388038|https://www.vpforums.org/index.php?showtopic=38669#entry388038]] |
| |
| For non DMD tables, the options are configured through Dip switches. Vpinball standalone version doesn't support pressing ''[F6]'' to display a window with the options. The DIP switche values must be changed by editing the ''.vbs'' file. eg. In the Fathom table, you can have 5 balls per play instead of 3 by changing this part: | For non DMD tables, the options are configured through Dip switches. Vpinball standalone version doesn't support pressing ''[F6]'' to display a window with the options. A way to access dip switches settings (and many more...) is to use the very powerful [[https://github.com/francisdb/vpxtool/|vpxtool]]. Most of the time, a description with what each dip switch does is also included directly in the ''.vbs'' file, where they can be edited. eg. In the Fathom table, you can have 5 balls per play instead of 3 by changing this part: |
| |
| <code> | <code> |
| |
| More information on what each Dip switch does is found in the table's user manual. | More information on what each Dip switch does is found in the table's user manual. |
| |
| Another way to access dip switches settings (and many more...) is to use the very powerful [[https://github.com/francisdb/vpxtool/|vpxtool]] | |
| |
| ===== Customizing the Table ===== | ===== Customizing the Table ===== |
| |
| * DOFlink to control toys (addressable LEDs, shakers...) | * DOFlink to control toys (addressable LEDs, shakers...) |
| * SFF and multi-output sound systems | * SFF and multi-output sound systems |
| | |
| | Even if SFF is not fully supported yet, you can still use multiple sound cards. For example, on my pincab, I have two sound cards: one for the backglass music and sound effects, and one for the ball and bumper "physical" sounds. I can list all the sound outputs supported by VPinballX by logging into Batocera and running: |
| | <code> |
| | # /usr/bin/vpinball/VPinballX_GL -listsn |
| | 2025-06-14 15:18:37.153 INFO [10019] [VPApp::InitInstance@926] Starting VPX - v10.8.0 Final (Rev. 9999 (unknown), linux OpenGL 64bits) |
| | 2025-06-14 15:18:37.154 INFO [10019] [VPApp::InitInstance@929] Settings file was loaded from /userdata/system/.vpinball/VPinballX.ini |
| | 2025-06-14 15:18:37.154 INFO [10019] [VPApp::InitInstance@930] m_logicalNumberOfProcessors=4 |
| | 2025-06-14 15:18:37.154 INFO [10019] [VPApp::InitInstance@931] m_szMyPath=/usr/bin/vpinball/ |
| | 2025-06-14 15:18:37.154 INFO [10019] [VPApp::InitInstance@932] m_szMyPrefPath=/userdata/system/.vpinball/ |
| | 2025-06-14 15:18:37.154 INFO [10019] [VPApp::InitInstance@980] Available sound devices: |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 1: name=Default, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 2: name= USB Audio: USB Audio, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 3: name=HDA Intel PCH: ALC221 Analog, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 4: name=HDA NVidia: LG TV, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 5: name=HDA NVidia: HDMI 1, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 6: name=HDA NVidia: HDMI 2, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 7: name=HDA NVidia: HDMI 3, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 8: name=HDA Intel HDMI: HDMI 0 *, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 9: name=HDA Intel HDMI: HDMI 1, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 10: name=HDA Intel HDMI: HDMI 2, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 11: name=Default Audio Device, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 12: name=Rate Converter Plugin Using Samplerate Library, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 13: name=Rate Converter Plugin Using Speex Resampler, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 14: name=Open Sound System, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 15: name=PipeWire Sound Server, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 16: name=PulseAudio Sound Server, enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 17: name=Plugin using Speex DSP (resample, agc, denoise, echo, dereverb), enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 18: name=Plugin for channel upmix (4,6,8), enabled=1 |
| | 2025-06-14 15:18:37.171 INFO [10019] [VPApp::InitInstance@985] id 19: name=Plugin for channel downmix (stereo) with a simple spacialization, enabled=1 |
| | </code> |
| | |
| | In my case, I want to use my default speakers for the backglass music and effects, which is managed by PipeWire Sound Server (''id 15'' above) and my other USB sound card for the ball and bumper physical effects with ''id 2'' above. I can edit the ''batocera.conf'' file and add: |
| | |
| | <code> |
| | vpinball.vpinball_sounddevice=2 |
| | vpinball.vpinball_sounddevicebg=15 |
| | </code> |
| | |
| |
| For earlier Batocera **v39** and lower, this is not supported. A pinball and Batocera fan shared information about how to tweak Batocera **v39** for pincabs [[https://gist.github.com/jsm174/19e9841174dada68d01026b2763f0f06|at this location]]. | For earlier Batocera **v39** and lower, this is not supported. A pinball and Batocera fan shared information about how to tweak Batocera **v39** for pincabs [[https://gist.github.com/jsm174/19e9841174dada68d01026b2763f0f06|at this location]]. |