This is the dev documentation for an unreleased version of MPF!

This is the documentation for MPF 0.53+, which is the “dev” (next) release of MPF that is a work-in-progress. Unless you’re specifically looking for this version, you probably want to use the version of documentation called “latest” which is for the latest released version of MPF. That documentation is at docs.missionpinball.org/en/latest.

Coils (Solenoids)

Related Config File Sections


Please ensure that you have established common ground between logic and coil power before turning on high voltage on your coils (especially on homebrew machines). Ignoring this might lock on your coils, overheat them, burn down your house or kill you. We are serious, floating grounds are dangerous. If you are not an professional electrician read the guide about voltages and power.

In MPF, you typically list all the coils in your machine in the coils: section of your machine configuration file, along with default options for them, like pulse times, PWM values, whether they can be enabled (held on), etc.


You don’t typically work with coils directly, rather, you tend to add them to other devices once they’ve been defined (flippers, autofires, ball devices, diverters, etc). You can configure Dual-wound Coils on top of coils.

That said, it is possible to perform actions on coils directly, such as pulsing, enabling, or disabling them. You can do this via the coil_player: section of a config file or via the coils: section of a show.

Related How To Guides
Tutorial step 3: Get flipping!
Related Events