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.

How to use MPF with the LISY platform

Related Config File Sections

MPF can directly control Gottlieb System 1 or System 80 machines via the LISY1 or LISY80 controller boards (with firmware 4.02+). Additionally, LISY35 can control Bally and Stern Games manufactured from 1977 to 1985 with MPU AS-2518-17 or AS-2518-35.


For general installation instruction and some background information on the LISY hardware platform, visit www.lisy80.com.

There are two ways this can be done:

  1. Run MPF on a standalone PC which connects to the LISY hardware operating in “slave” mode via Ethernet, WiFi, or serial. This is generally recommended during development since it’s easier to work on your MPF config using your own computer. You can also use this configuration if you want to add an LCD or DMD to the older Gottlieb machine.
  2. Run MPF on the LISY hardware directly (“master” mode). (Technically MPF is running on the LISY controller’s Raspberry Pi Zero.) This option is nice when your game is finished and you no longer want to connect a PC. Note that the Raspberry Pi on the LISY is not powerful enough to run the MPF media controller, so this option is really only valid for simpler, segment display type games. If you want to run a full LCD or DMD, then just run MPF on a separate computer (which can still be small and inside your machine) and connect to the LISY controller via Option (a) above.

See the following image for an architecture overview:


LISY can controll all features of your Gottlieb System1/80 machine. This includes: