Related Config File Sections

Flippers are probably the first thing you think of when you think about building your own pinball machine. In fact when most people get their own hardware and start drilling holes in a piece of plywood, the first visible thing they do is to get their flippers flipping.

TODO: Add a picture of flippers

MPF has support for lots of different kinds of flippers (as there are many different ways they’ve been wired over the years), as well as a lot of different options for how flippers are fine tuned.

MPF also has support for various “novelty” flipper modes (no-hold flippers, reversed flipper buttons, weak flippers, etc.)

We recommend you read the Dual-Wound versus Single-Wound coils guide to understand the difference between “dual wound” and “single wound” coils, as flippers in pinball machines can be either type.

You should also probably read the EOS Switches guide if your machine has flipper EOS switches. (In general EOS switches are not needed for flippers with MPF.)

Default Events

MPF contains built-in support for the flipper cancel combo. If you add the tag left_flipper to your left flipper switch, and right_flipper to your right flipper switch, then whenever the player hits both flippers at the same time, an MPF event called flipper_cancel will be posted. This is implemented as combo switch.

Additionally, MPF contains a default timed switch for flipper cradle. It will post flipper_cradle when a player cradles a ball for 3s. Later it will post flipper_cradle_release when the player releases the ball.

Monitorable Properties

For dynamic values and conditional events, the prefix for flippers is device.flippers.<name>.

Boolean (true/false) which shows whether this ball hold is enabled.