Warning

This is the dev documentation for an unreleased version of MPF!

This is the documentation for MPF 0.56+, which is the “dev” (next) release of MPF that is a work-in-progress. Unless you’re specifically looking for this version, you probably want to use the version of documentation called “latest” which is for the latest released version of MPF. That documentation is at docs.missionpinball.org/en/latest.

Ball Locks

Related Config File Sections
multiball_locks:
ball_holds:

MPF supports ball locks which are used to hold a ball that has entered a Ball Devices. To separate use-cases MPF supports two cases of ball locks:

  • Multiball_locks which lock balls for a multiball. Locked balls are no longer in play (i.e. deducted from ball count).
  • Ball_holds which only hold balls temporarily. This is used to play animations or stop the ball during a video mode. Those balls are technically still in play.