Multiballs
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).
balls_added_live
: Numeric value of how many balls this multiball added into play.
balls_live_target
: Numeric value of how many balls this multiball is attempting to keep in play.
enabled
: Boolean (true/false) as to whether this multiball is enabled.
shoot_again
: Boolean (true/false) as to whether this multiball is in "shoot again" mode which means it's attempting to keep live.
Related How To guides
- Multiball locks
- Multiball with a traditional ball lock
- Multiball with a virtual ball lock
- Multiball with multiple lock devices
- Add a ball multiball
Related Events
- multiball_(name)_started
- ball_save_(name)_timer_start
- multiball_(name)_hurry_up
- multiball_(name)_grace_period
- multiball_(name)_shoot_again
- multiball_(name)_lost_ball
- multiball_(name)_shoot_again_ended
- ball_save_(name)_add_a_ball_timer_start
- multiball_(name)_ended
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