Ball Saves

Related Config File Sections
ball_saves:

MPF uses ball saves to automatically re-serve a ball that has drained. (Essentially this means the ball drain doesn’t count.)

Ball saves are typically used in several scenarios:

  • Give the player their ball back if they drain right after their ball starts.
  • Give the player their ball back if there’s a particularly wicked shot that tends to drain which the game designers feel bad about. (You should avoid this if possible, and instead, as Lyman Sheets would say, “Fix your f-ing game layout!”)
  • Use to make a timed mode where the player has unlimited drains.
  • Etc.

You can configure ball saves to have various start and stop events and timers, and you can configure multiple ones in different modes that do different things.

Monitorable Properties

For config placeholders and conditional events, the prefix for ball saves is device.ball_saves.<name>.

enabled
Boolean (true/false) which shows whether this ball hold is enabled.
saves_remaining
How many balls saves are remaining.
state
String value of the state of this ball save. Values will be one of the following: enabled, disabled, hurry_up, or grace_period.
timer_started
Boolean (true/false) which shows whether the timer is started.