Skip to content

Understanding the #config_version setting

Since MPF is mainly "programmed" with YAML-based config files, we need a way for MPF to know that the config file(s) it's loading are compatible with the version of MPF that's running.

This is specified in the very first line of a config file (in both the machine-wide configs and mode config files). You specify the config version with a list that starts with a hash sign, like this:


In YAML, lines that start with # are ignored, which means the YAML processor skips this line, but MPF uses it to make sure the config file it's trying to load will work with that version of MPF.

Not every new version of MPF changes the config_version number. If we release a new version of MPF that does not have a new config_version number, then you can use the new version of MPF without needing to make any changes to your config files.

Updating your config files to the latest version

MPF includes a config file migration tool that can automatically migrate your config files to the latest version.

Which versions of MPF require which config_versions?

  • MPF 0.57+: #config_version=6
  • MPF 0.50-0.56: #config_version=5
  • MPF 0.30-0.33: #config_version=4
  • MPF 0.20-0.21: #config_version=3
  • MPF 0.19: #config_version=2
  • MPF 0.17-0.18: #config_version=1
  • MPF 0.1-0.16: config_version not used (a.k.a. config version 0)

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