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.

Loops / Orbits / Ramps

Related Config File Sections
sequence_shots:
sound_player:

Ramps, loops or orbits usually contain two switches. One at the entry and one to signal success. To detect only shots where both switches were hit in order you can use sequence_shots.

TODO: Add a picture of an orbit

switches:
  s_ramp_entry:
    number: 1
  s_ramp_success:
    number: 2
sequence_shots:
  ramp:
    switch_sequence: s_ramp_entry, s_ramp_success
    sequence_timeout: 3s

This example is tested to be valid MPF config. However, it is not integration tested.

switches:
  s_ramp_entry:
    number: 1
  s_ramp_success:
    number: 2
sequence_shots:
  ramp:
    switch_sequence: s_ramp_entry, s_ramp_success
    sequence_timeout: 3s

Additionally, most machines usually play a sound once the entry is hit to signal the player that he hit the ramp and another sound on success to indicate that the ball made it. You can use sound_player: to achieve that. In this example you would use the events s_ramp_entry_active and ramp_hit to play the sounds:

sound_player:
  s_ramp_entry_active: indicate_ramp
  s_ramp_success: indicate_ramp_success

This example is tested to be valid MPF config. However, it is not integration tested.

sound_player:
  s_ramp_entry_active: indicate_ramp
  s_ramp_success: indicate_ramp_success