Skip to content


This is a config file reference. Click for instructions.

This page is reference material which explains every setting and option for this section of an MPF yaml config file. See the instructions for config files for formatting and other details. See our guide to config file examples for more examples of real configs in action.

Valid in
machine config files YES ✅
mode config files NO 🚫

In the logging section you can configure which how verbose parts of MPFs should log.

    asset_manager: none
    ball_controller: none
    ball_search: basic
    bcp: basic
    bcp_client: basic
    bcp_interface: basic
    bcp_server: basic
    clock: none
    config_players: none       # todo
    data_manager: none       # todo subclasses
    delay_manager: none
    device_manager: none
    event_manager: none
    file_manager: none       # todo
    logic_blocks: none
    machine_controller: basic
    mode_controller: basic
    placeholder_manager: none
    platforms: none       # todo
    players: basic       # todo
    plugins: none       # todo
    score_reel_controller: none
    scriptlets: none       # todo
    service_controller: basic
    settings_controller: none
    show_controller: none
    switch_controller: basic
    timers: none
    asset_manager: basic
    ball_controller: basic
    ball_search: basic
    bcp: basic
    bcp_client: basic
    bcp_interface: basic
    bcp_server: basic
    clock: none
    config_players: basic
    data_manager: basic
    delay_manager: none
    device_manager: basic
    event_manager: basic
    file_manager: basic
    logic_blocks: basic
    machine_controller: basic
    mode_controller: basic
    placeholder_manager: basic
    platforms: basic
    players: full
    plugins: basic
    score_reel_controller: basic
    scriptlets: basic
    service_controller: basic
    settings_controller: basic
    show_controller: basic
    switch_controller: full
    timers: none

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!

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