Skip to content

Mode config files

Modes usually start with a mode: section (see mode) which defines their priority and when they start or stop:

##! mode: mode1
mode:
  start_events: ball_starting
  stop_events: timer_mode_timer_complete, shot_right_ramp
  priority: 300

Not all config sections can be used in your machine-wide config (see Machine config files). Some devices may only exist in modes (usually if they require an active game with one or more players). You can see if this is the case at the top of the relevant config section. For instance extra_balls are player-bound and can only be used in modes.


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