Skip to content

Service Command Line

The MPF service cli is a fast way to debug or troubleshoot your machine during development and operation.

  1. Start your game (e.g. using mpf both)
  2. Start the service cli from within your game folder using mpf service.

Your game will go into service mode and you can run diagnostics commands. Once you are done the game will continue and exit service mode. You can use tab to complete commands and arguments.



List all coils in the machine.


Pulse coil .


Enable coil . This only works if enable is allowed for this coil.


Disable coil .


List all switches in the machine.


Watch for switch changes. Prints any changes until you press Ctrl+c.


List all lights in the machine.


Turn light into color .


Turn light off.


Exit service cli. Game will reset and start.

See mpf service command line reference.

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