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.
|machine config files
|mode config files
config: section of your configuration files allows you to specify
additional configuration files that will be read in after the current
file is loaded. Here's an example:
Note that each file is on its own line, which starts with a minus, then a space, then the file. (The space is important.) Also note that you can (optionally) specify a path, like this:
MPF will attempt to convert relative and absolute paths based on your OS, and it can deal with slashes in either direction.
MPF will then open those files one-by-one and merge their settings into the master configuration dictionary. The settings are merged together in the order the files are listed, so if multiple files specify the same configuration option then whichever one comes later in the list will overwrite any options that have already been specified.
You can also have
config: sections in other config files, meaning that
one config file can call another which will call another, etc.
Whenever MPF encounters a new config file, it will add it to the end of
the list. And since files are processed in order, if there are any
conflicting settings then the last file on the list will "win." Also
note that the framework will attempt to load the file from the current
working directory (containing the config file that
config: entry is
from. If that fails then it will try the last known good directory that
worked for a config file.
Related How To guides
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