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.

Machine Management

MPF includes many features to help you manage your pinball machine.

(There’s a lot to add here. This will include things like the service mode, auditor, remote monitoring and trouble reporting, etc. See: Help us to write it)


If the service mode is added to modes, the message “coil power off” will appear when the coin door is open. This is only a message: MPF cannot actually turn the coil power off. You must ensure that your power system is wired appropriately to turn HV off when the coin door is open.