Skip to content


Related Config File Sections:

MPF includes a multiball feature which can be used to automatically start and stop multiballs.

Each multiball in MPF has a separate name. There are several different types of multiballs (run until a single ball is left, timed multiballs, etc.) Multiballs can also be configured with multiball saves so that (for example) any balls lost in the first 15 seconds of a multiball are automatically re-launched back into play.

MPF also supports stacking of multiple multiballs at the same time.

Balls can be locked for multiball with the related /events/multiball_multiball_ended config section.

Video about ball locks and multiballs:

Common Issues

Why does MPF wait about 10s when adding balls to the playfield from the trough during a multiball?

When MPF adds a ball to the playfield the launcher waits until the ball is confirmed to be on the playfield. For the first ball this happens when a playfield switch is hit after the eject. However, this will not work with more than one ball on the playfield (e.g. during a multiball). In this case, the launcher will wait until its eject timeout passed (eject timeouts in ball_devices </config/ball_devices>) which defaults to 10s. Therefore, you need to tune eject_timeouts of your launcher to fix this issue.

Monitorable Properties

For dynamic values and conditional events, the prefix for multiballs is device.multiballs.(name).


: Numeric value of how many balls this multiball added into play.


: Numeric value of how many balls this multiball is attempting to keep in play.


: Boolean (true/false) as to whether this multiball is enabled.


: Boolean (true/false) as to whether this multiball is in "shoot again" mode which means it's attempting to keep live.

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