Skip to content

FAQ: Installation

How do I get started?

Start with the Start Here link in the menu. That will explain an overview of how MPF works and then lead you through the features, the tutorial, and so on.

What are the prerequisites?

If you just want to start playing with MPF, you do not need a physical pinball machine. In fact we have a graphical tool (the MPF Monitor) which simulates a real pinball machine, so you can probably build an entire game without having an actual pinball machine.

If you want to use a real pinball machine (or build a real machine), you need to pick a pinball control system. (We have a list of supported control systems here.) If you want to get started as cheaply as possible, the Open Pinball Project hardware is open source which you can build yourself. You can probably build all the hardware you need for under $100.

What computer hardware do I need?

MPF supports Windows, Mac, and Linux, so pretty much any computer is fine. Most people do their development of MPF on whatever computer they use in their daily lives, then when they're getting close to done with their machine, they install a dedicated computer (or even a Raspberry Pi) in their machine to run MPF.

Latest Versions

If you are creating a new game and are installing all of the MPF tools from scratch, you should start with the most up-to-date versions of everything you can. This will ensure you have the latest features and bug fixes, and are the easiest for the community to support. The most updated full installation (known-working on Windows and Linux) as of January 2026 is:

  • Python 3.14
  • MPF 0.80.0.dev12 (via pip --pre option)
  • MPF-GMC 0.1.6 (via Asset Library)
  • Godot Editor 4.5.1
  • MPF Monitor 0.57.2
  • Note: mpf-mc is no longer supported with MPF 0.80+, use Godot and MPF-GMC instead

What Python version can I use with MPF?

The stable version (0.57, currently on 0.57.3) of MPF can be used with Python versions 3.8-3.12. We walk you through getting Python installed in our installation documentation.

The previous version of MPF, 0.56. is only compatible with Python from version 3.7 through 3.9.

The next revision (0.80.0) of MPF supports Python 3.10 - 3.13, and does not support the legacy Media Controller. The new media controller for 0.80 is called GMC, and is in active development.

Should I use the stable version or development version?

We recommend that people use the latest "stable" (or "release") version of MPF unless you need specific features from the "dev" (next) version.

Where do I find information on older versions of MPF?

If you want information about an older version of MPF, we have prior version documentation bundles.

You can install older versions of MPF by specifying them with pip, like this:

pip install mpf==0.56.0.dev33

Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results