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.

coil_pulse <name>

Pulse coil <name>.

coil_enable <name>

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

coil_disable <name>

Disable coil <name>.


List all switches in the machine.


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


List all lights in the machine.

light_color <name> <color>

Turn light <name> into color <color>.

light_off <name>

Turn light <name> off.


Exit service cli. Game will reset and start.

See mpf service command line reference.