Skip to content

Extra Balls

Related Config File Sections:

MPF has support for extra balls. Extra balls in MPF are "named", and they're tracked so that (by default) each extra ball can only be awarded once. You can configure as many different extra balls as you want, each with different settings that tie into the events that award them. Every extra ball device can award up to x extra balls (defaults to 1). Additionally, you can define extra ball groups which can further limit the maximum number of extra balls.

Score an Extra Ball Based on Score

Some games (especially EMs) award extra balls based on the score. This is an example:

##! mode: base
# in your base mode
extra_balls:
  score_one:
    enabled: true
    award_events: player_score{value>=140000}
  score_two:
    enabled: true
    award_events: player_score{value>=210000}
  score_three:
    enabled: true
    award_events: player_score{value>=300000}
#! variable_player:
#!   score_100000:
#!     score: 100000
##! test
#! # start game and score
#! start_game
#! start_mode base
#! post score_100000
#! assert_player_variable 100000 score
#! assert_player_variable 0 extra_balls
#! post score_100000
#! assert_player_variable 200000 score
#! assert_player_variable 1 extra_balls
#! post score_100000
#! assert_player_variable 300000 score
#! assert_player_variable 3 extra_balls
#! post score_100000
#! assert_player_variable 400000 score
#! assert_player_variable 3 extra_balls

Help us write it!

This section is unwritten or needs an update or edit. Can you help write it? Get your name in lights and geeky pinball bragging rights! Hit the magic sparkly wand to the right of the title to see this page source on GitHub. Then add/edit and submit your change. It's easy! 

<!-- -->
* extra_ball_group_(name)_awarded * extra_ball_group_(name)_lit * extra_ball_group_(name)_unlit * extra_ball_group_(name)_award_disabled * extra_ball_group_(name)_lit_awarded

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