Differences

This shows you the differences between two versions of the page.

--- systems:fpinball [2021/06/23 18:14] – removed v31 warning, because it is the new stable version igno2k
+++ systems:fpinball [2025/10/12 16:24] (current) – Removed from 42 onwards lbrpdx
@@ Line 1: / Line 1: @@
+<WRAP group>
+<WRAP round box twothirds column>
+{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/fpinball.svg?nolink&460 }}
 ===== Future Pinball =====
-[[https://futurepinball.com/|Future Pinball]] is a pinball simulator, written for Windows, and running in Batocera Linux through Wine. That's a reason why it is only available for Batocera PC.
+<WRAP center round important>
+Future Pinball has been removed from Batocera 42 onwards. For pinball simulation, look at [[vpinball|Visual Pinball X]], a Linux-native alternative.
+</WRAP>
-It's a simulator for both original tables and re-creations of existing physical pinball tables, using Microsoft Visual Basic to implement all the table logic. The physics and overall graphics of Future Pinball make it feel closer to a physical pinball than an arcade game, as it's usually the case with pinball games that are available with console emulators.
+[[https://futurepinball.com/|Future Pinball]] is a pinball simulator, written for Windows, and running in Batocera Linux through WINE. That's a reason why it is only available for Batocera PC.
+It's a simulator for both original tables and re-creations of existing physical pinball tables, using Microsoft Visual Basic to implement all the table logic. The physics and overall graphics of Future Pinball make it feel closer to a physical pinball than an arcade game, as it's usually the case with pinball games that are available with console emulators.
 All 3D graphics objects are rendered in real time, and you can change the view point at any given time (see controls below). As a consequence, it requires a PC with sufficient GPU power. It can still run well on recent Intel integrated GPUs.
@@ Line 9: / Line 17: @@
 {{ :emulators:fpinball.png?nolink&600 |}}
-==== Tables ====
+<WRAP center round important>
+It is recommended to use **btrfs** or **ext4** for ''/userdata/'' as WINE [[https://wiki.winehq.org/FAQ#Does_Wine_run_on_all_Unix_filesystems.3F|explains on their FAQ]] that some games won't run on a non-Linux native file system.
+</WRAP>
-Future Pinball tables are distributes as ''.fpt'' files. In many cases, a pinball table is fully contained in the ''.fpt'' file, but for some tables, you need additional files (fonts, music) that are distributed as side '.fpl' files, sitting next to the ''.fpt'' file.
+<WRAP center round help>
+In Batocera **v32** and higher there is a bug where WINE cannot run applications/games stored on a NAS. This can be worked around by not using a NAS for your saves folder.
+</WRAP>
-The ''.fpt'' file is the main one that is loaded by Batocera to start your pinball game. Just put it into the ''/userdata/roms/fpinball'' directory. You can store tables in their own sub-folders if you wish.
+This system scrapes metadata for the "fpinball" group(s) and loads the ''fpinball'' set from the currently selected theme, if available.
+</WRAP>
+<WRAP third column>
+{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/fpinball.png?nolink&350 |}}
+</WRAP>
+</WRAP>
-==== Controls ====
+==== Quick reference ====
+  * **Emulator:** [[#fpinball|fpinball]]
+  * **Folder:** ''/userdata/roms/fpinball''
+  * **Accepted ROM formats:** ''.fpt''
+===== BIOS =====
+^ MD5 checksum ^ Share file path ^ Description ^
+| ''65a8ebf870420316a939ac44fd4c731d'' | ''bios/wsh57/scripten.exe'' | |
+===== Tables =====
+Future Pinball tables are distributed as ''.fpt'' files. In many cases, a pinball table is fully contained in the ''.fpt'' file. These kinds of tables can simply be placed in ''/userdata/roms/fpinball/''.
+<code>
+roms/
+└─ fpinball/
+   └─ my-cool-table.fpt
+</code>
+For some other tables, additional files (fonts, music) are required, which are distributed as side ''.fpl'' files. These tables must have their ''.fpt'' and all other associated files in a subfolder of their own, separate from the other tables. For example, ''roms/fpinball/my-cool-table/'' which contains all the files.
+<code>
+roms/
+└─ fpinball/
+   └─ my-cool-table/
+      ├─ custom-font.font
+      ├─ my-cool-table.fpt
+      └─ background-music.mp3
+</code>
+The ''.fpt'' file is the main one that is loaded by Batocera to start your pinball game. It will decide the name that appears in EmulationStation.
+Tables:
+[[https://www.vpforums.org/]]
+[[http://www.pinsimdb.org/]]
+===== Configuration =====
+Standardized features available to all cores of this emulator: ''fpinball.videomode'', ''fpinball.videomode'', ''fpinball.ratio'', ''fpinball.bezel'', ''fpinball.bezel_stretch'', ''fpinball.hud'', ''fpinball.bezel.tattoo'', ''fpinball.bezel.tattoo_corner'', ''fpinball.bezel.tattoo_file'', ''fpinball.bezel.resize_tattoo''
+===== Controls =====
+Here are the default Future Pinball's controls shown on a [[:configure_a_controller|Batocera Retropad]]:
+{{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/fpinball.png }}
 ^ Button  ^ Action       ^
@@ Line 28: / Line 91: @@
 | North   | Pause / High scores |
 | D-Pad   | Shake the pinball (left, right, up/front) |
-| Hotkey + start | Quit, as usual |
+| ''[HOTKEY]'' + ''[START]'' | Quit, as usual |
+Controls can be manually configured from the config app. Press ''[F1]'' on the system list and navigate to Applications > ''fpinball-config''.
+===== Troubleshooting =====
+==== Future Pinball fails to launch ====
+The quickest way to debug is to try launching the table in the standalone config app. Press ''[F1]'' on the system list and navigate to Applications > ''fpinball-config''. A more descriptive error message may appear.
+Some tables may require certain system libraries to exist in the main folder, similar to some other applications running under [[systems:windows|WINE]].
+If the solution is not obvious, maybe the files for the table have become corrupted over time. Try deleting ''saves/fpinball'' and then launch the table again to regenerate them.
+==== My controls have issues ====
+Open the config app and on the top right, disable all but the first controller. Then try again.
+==== Further troubleshooting ====
+As this is an application running under WINE, [[systems:windows#troubleshooting|its troubleshooting section]] and [[systems:steam#proton|the Proton troubleshooting section]] can apply here too.
+For further troubleshooting, refer to the [[:support|generic support pages]].