Skip to content

Ball Saves

Related Config File Sections:

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.

This is an example:

``` mpf-config ball_saves: random_ball_save: active_time](5s hurry_up_time) center_post

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