How to create a multiball which uses multiple lock devices

Related Config File Sections:

• multiballs:
• ball_devices:
• multiball_locks:

Some machines have multiple locks and a multiball may use multiple source devices to eject balls. However, you have to unterstand that multiball_locks: and multiballs: are independent. A multiball can use one or multiple ball device as source devices to eject balls. Locks will keep balls inside ball devices and request new balls to the playfield. To use multiple locks in one multiball you need to combine those: Define locks to lock balls in your lock ball devices. Additionally, define a multiball device with your lock ball devices as source. Then, use the multiball_lock_(name)_full events to enable/start your multiball mode. When the multiball starts reset counters of your locks.

In the following example, you have to lock balls sequentially in your three locks. Every lock will enable the next lock using the multiball_lock_(name)_full event. The last lock will start the multiball mode. If you hit s_target1 the multiball will start which will reset and disable all locks using the multiball_(name)_started event. After all the balls from the multiball drained all lock modes and the multiball mode will stop using the multiball_(name)_ended event.

coils:
  eject_coil1:
    number:
  eject_coil2:
    number:
  eject_coil3:
    number:
switches:
  s_lock1:
    number:
  s_lock2:
    number:
  s_lock3:
    number:
  s_target1:
    number:
ball_devices:
  bd_lock1:
    eject_coil: eject_coil1
    ball_switches: s_lock1
    eject_timeouts: 2s
  bd_lock2:
    eject_coil: eject_coil2
    ball_switches: s_lock2
    eject_timeouts: 2s
  bd_lock3:
    eject_coil: eject_coil3
    ball_switches: s_lock3
    eject_timeouts: 2s
# mode lock1
##! mode: lock1
mode:
  restart_on_next_ball: true
  stop_events: multiball_my_multiball_started
multiball_locks:
  lock1:
    lock_devices: bd_lock1
    balls_to_lock: 1
    disable_events: mode_multiball_started
    reset_count_for_current_player_events: multiball_my_multiball_started
# mode lock2
##! mode: lock2
mode:
  restart_on_next_ball: true
  start_events: multiball_lock_lock1_full
  stop_events: multiball_my_multiball_started
multiball_locks:
  lock2:
    lock_devices: bd_lock2
    balls_to_lock: 1
    disable_events: mode_multiball_started
    reset_count_for_current_player_events: multiball_my_multiball_started
# mode lock3
##! mode: lock3
mode:
  restart_on_next_ball: true
  start_events: multiball_lock_lock2_full
  stop_events: multiball_my_multiball_started
multiball_locks:
  lock3:
    lock_devices: bd_lock3
    balls_to_lock: 1
    disable_events: mode_multiball_started
    reset_count_for_current_player_events: multiball_my_multiball_started
# mode multiball
##! mode: multiball
mode:
  start_events: multiball_lock_lock3_full
  stop_events: multiball_my_multiball_ended
multiballs:
  my_multiball:
    ball_count: 4
    ball_count_type: total
    shoot_again: 2s
    start_events: s_target1_active
    ball_locks: bd_lock1, bd_lock2, bd_lock3
##! test
#! start_game 5
#! # there is one ball on playfield by default
#! assert_balls_on_playfield 1
#! assert_balls_in_play 1
#! assert_int_condition 0 device.multiball_locks.lock1.locked_balls
#! hit_switch s_lock1
#! advance_time_and_run 3
#! # it should not be locked
#! assert_balls_on_playfield 1
#! assert_balls_in_play 1
#! assert_int_condition 0 device.multiball_locks.lock1.locked_balls
#! start_mode lock1
#! hit_switch s_lock1
#! advance_time_and_run 3
#! # it should not be locked
#! assert_balls_on_playfield 1
#! assert_balls_in_play 1
#! assert_int_condition 1 device.multiball_locks.lock1.locked_balls
#! hit_switch s_lock2
#! advance_time_and_run 2
#! hit_switch s_lock3
#! advance_time_and_run 3
#! assert_balls_on_playfield 1
#! assert_balls_in_play 1
#! assert_int_condition 1 device.multiball_locks.lock1.locked_balls
#! assert_int_condition 1 device.multiball_locks.lock2.locked_balls
#! assert_int_condition 1 device.multiball_locks.lock3.locked_balls
#! hit_switch s_target1
#! advance_time_and_run 3
#! assert_balls_on_playfield 4
#! assert_balls_in_play 4
#! assert_int_condition 0 device.multiball_locks.lock1.locked_balls
#! assert_int_condition 0 device.multiball_locks.lock2.locked_balls
#! assert_int_condition 0 device.multiball_locks.lock3.locked_balls
#! advance_time_and_run 3
#! drain_one_ball
#! drain_one_ball
#! drain_one_ball
#! assert_balls_on_playfield 1
#! assert_balls_in_play 1
#! assert_mode_not_running lock1
#! assert_mode_not_running lock2
#! assert_mode_not_running lock3
#! assert_mode_not_running multiball

Video about ball locks and multiballs:

---

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