Archived 2026-09-13 from
https://github.com/missionpinball/mpf-docs/blob/main/docs/game_design/mode_layering.md.
Rendered-page summary, not a byte-perfect copy (the source declined a verbatim reproduction).
This is MPF's own documented precedent for the Field/Mission/Wizard mode-layering pattern this
project's design/README.md workflow already uses.
Three helper modes run underneath the current gameplay to manage transitions:
field.yaml) — consolidates all field modes.global.yaml) — manages transitioning between field mode and mission modes.base.yaml) — MPF's default background mode; manages transitioning betweenThe full doc includes YAML examples for field/mission/global/wizard/base mode configs, showing
how each layer manages its own event handlers and transitions between gameplay states — see the
live URL for the actual config snippets, not captured in this summary.