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.
playfields:¶
Config file section
Valid in machine config files | YES |
Valid in mode config files | NO |
The playfields:
section of your config is where you configure your
playfields in your machine.
You can have multiple playfields and MPF will track balls per playfield.
One playfield should contain the tag default so that the game knows which playfield to use.
Required settings¶
The following sections are required in the playfields:
section of your config:
default_source_device:¶
Single value, type: string name of a ball_devices device. Defaults to empty.
The source ball device to use to feed balls to this playfield. This source device must be able to eject directly to the playfield. Usually this is your launcher ball device. If you do not have a launcher use the trough device.
Optional settings¶
The following sections are optional in the playfields:
section of your config. (If you don’t include them, the default will be used).
ball_search_block_events:¶
List of one (or more) device control events (Instructions for entering device control events). Default: flipper_cradle
Event to block ball search. Used by flipper cradle.
ball_search_disable_events:¶
List of one (or more) device control events (Instructions for entering device control events). Defaults to empty.
Event to disable ball search.
ball_search_enable_events:¶
List of one (or more) device control events (Instructions for entering device control events). Defaults to empty.
Event to enable ball search.
ball_search_failed_action:¶
Single value, type: string
. Default: new_ball
When ball search failed this action is taken. Either new_ball
which will
eject a new ball from the default default source device or end_game
which
will end the game.
ball_search_interval:¶
Single value, type: time string (ms)
(Instructions for entering time strings). Default: 150ms
The delay after each fired coil/searched device.
ball_search_phase_1_searches:¶
Single value, type: integer
. Default: 3
Ball search will run in multiple phases with increasing intensity. For instance, in phase 1, only ball devices without a ball will be pulsed. This defines how many time phase 1 is repeated until ball_search proceeds to phase 2.
ball_search_phase_2_searches:¶
Single value, type: integer
. Default: 3
Ball search will run in multiple phases with increasing intensity. For instance, in phase 2, all ball devices except the trough will try to dejam. This defines how many time phase 2 is repeated until ball_search proceeds to phase 3.
ball_search_phase_3_searches:¶
Single value, type: integer
. Default: 4
Ball search will run in multiple phases with increasing intensity. For instance, in phase 3, all ball devices except the trough pulse their coil. This defines how many time phase 3 is repeated until ball search gives up.
ball_search_timeout:¶
Single value, type: time string (ms)
(Instructions for entering time strings). Default: 15s
ball_search_timeout configures the time of inactivity which has to pass until ball search starts.
ball_search_unblock_events:¶
List of one (or more) device control events (Instructions for entering device control events). Default: flipper_cradle_release
Event to unblock ball search. Used by flipper cradle.
ball_search_wait_after_iteration:¶
Single value, type: time string (ms)
(Instructions for entering time strings). Default: 5s
Extra delay after each iteration.
enable_ball_search:¶
Single value, type: boolean
(true
/false
). Defaults to empty.
Enable ball_search by default. Use with care during development since coils may hurt you. Should be enabled in any production machine.
console_log:¶
Single value, type: one of the following options: none, basic, full. Default: basic
Log level for the console log for this device.
file_log:¶
Single value, type: one of the following options: none, basic, full. Default: basic
Log level for the file log for this device.
tags:¶
List of one (or more) values, each is a type: string
. Defaults to empty.
Set tag default to your default playfield. The game will use the default playfield to eject balls.