This is the documentation the latest work-in-progress version of MPF!

This is the documentation for MPF 0.56, which is the “dev” (next) release of MPF that is a work-in-progress. This is probably ok, and means you’ll be on the latest, cutting-edge version of MPF.

However, if you want a more stable version, select the v:stable version from the lower-left corner of this page, which is the most recent version that is not getting new updates.

If you are new to MPF, we have recently rewritten the installation process which only applies to this “latest” 0.56, so you probably want to stay here because the prior installation process doesn’t work on the latest OS and Python versions.

Plungers & Ball Launch Devices

Related Config File Sections

A Plunger is a type of ball device. MPF supports mechanical (traditional “spring” plungers), coil-fired plungers, and combo auto/manual plungers.

Here are the options:

Since there are so many different options, you need to first identify which type of plunger or ball launch system your machine has. So look at the following pictures to match up what you have, and then follow the specific links to see how to configure MPF to use it in your machine.

Option 1: Spring plunger with ball switch

The most “traditional” style plunger is a spring-powered mechanical plunger lane. In modern machines, there’s a switch at the bottom of the plunger lane which is activated by a ball sitting in the plunger lane waiting to be plunged.

Here’s an example of this from a Pin*Bot machine:


If you have this type of spring-powered plunger with a switch that’s active when a ball is sitting in it ready to be plunged, follow the Mechanical (spring) plungers guide to configure it in MPF.

Option 2: Spring plunger with no ball switch

Older pinball machines (typically those that only have one ball) have what appear to be traditional plungers like in Option 1, but if you look closely, you’ll notice that there is no switch which is active when the ball is sitting in the plunger lane.

Here’s an example of this from Gottlieb Big Shot:


If you have this type of spring-powered plunger with no switch that’s active when a ball is sitting in it ready to be plunged, follow the Plunger lanes with no ball switch guide to configure it in MPF.

Option 3: Combo spring plunger with coil-fired autolauncher

Many modern machines have a combination-style plunger which combines a mechanical spring-powered plunger with an autolauncher coil. These types of plungers allow game to decide whether the player should manually pull back on the plunger handle to launch the ball with spring power or whether the game should pulse a coil to eject the ball into play.

Here are two examples of slightly different versions of these, the left from a Stern Star Trek Premium, and the right from a Gottlieb Brooks ‘n Dunn machine:


If you have this type of auto/manual combo plunger, follow the Combo (mechanical + coil-fired) plungers guide to configure it in MPF.

Option 4: Coil-fired plunger (no mechanical spring option)

The final plunger option is the fully automatic coil-fired option that has no mechanical spring-based option.

There are a few different physical forms of this. Here’s a typical example from Judge Dredd where a coil shaft with a plastic tip is pulsed to launch the ball directly:


And here’s an example from Williams Star Trek: The Next Generation which uses a catapult-style mechanism in order to launch the ball into play.


Note that both of these options are “identical” as far as MPF is concerned. They both have switches which are active when a ball is able to be launched, they both pulse coils to launch the ball, and neither one has a manual plunge option.

If you have this type of coil-powered plunger, follow the Coil-fired plungers / ball launchers guide to configure it in MPF.

Related How To Guides
Tutorial step 8: Add your plunger lane
Troubleshooting P-Roc/P3-Roc
Related Events