Skip to content

The Virtual Platform

Related Config File Sections:

MPF's virtual platform interface is a software-only platform you can use if you don't have a physical pinball controller attached.


MPF also has a smart virtual platform which is probably what you'd use in most cases instead of the virtual platform.

Note for P-ROC and P3-ROC users: P-ROC's pyprocgame includes a virtual P-ROC interface called FakePinPROC. We don't use that in the MPF because doing so requires that pyprocgame is installed, and it's likely that people using MPF won't have pyprocgame. Using MPF's virtual hardware interface is conceptually similar to FakePinPROC.

Using the virtual platform

There are three ways you can use the virtual platform:

1. Manually setting the platform

You can manually specify the virtual platform in the machine config, like this:

  platform: virtual

3. Via the command line

You can also specify the smart virtual platform interface via the -x (lowercase X) from the command line, like this:

mpf -x


mpf both -x


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