Quickstart guide to MPF 0.80 and GMC

This is for people who know what they're doing. If you're lost, check out our full installation guides.

Quickstart for GMC

Download the Godot Editor from https://godotengine.org
Download the latest GMC release from https://github.com/missionpinball/mpf-gmc/releases/ (under Assets > Source code).
Open the Godot Editor and create a new Project in a new folder of your choosing. This will be the project folder for your MPF machine code as well, so if you already have an MPF project choose that folder instead.
Extract the GMC download and copy the addons folder into your project folder.
In the Godot Editor, go to Project Settings > Plugins and check the Enable box for Godot MC. (Godot will show lots of errors during this step and the next, ignore them).
In the Godot Editor Project Settings > Autoload select the folder to add a new Autoload and choose the file addons/mpf-gmc/mpd_gmc.gd. Set the Node name to MPF (all caps) and press Add.
Save your Godot project and then in the editor menu select Project > Reload Current Project.

MPF requires Python 3.8 - 3.12. Validate that you have a supported version of Python with python3 --version.
Create a virtual environment for mpf. In your home folder (or virtual environments folder) type python3 -m venv mpf
Activate your virtual environment: source mpf/bin/activate (on Mac/Linux) or mpfenv/Scripts/Activate.ps1 (Windows PowerShell)
Install MPF 0.80: pip install --pre mpf
In your terminal, navigate to the project folder you created and initialize an MPF config file.

    (mpf) my_project_folder $> mkdir config
    (mpf) my_project_folder $> echo "#config_version=6" > config/config.yaml

Press the play button in the top-right of the Godot Editor. When prompted to select a main scene, select addons/mpf-gmc/slides/window.tscn. You should see a window appear with the MPF logo and text reading "Waiting for MPF..."
In your terminal, type mpf -xt

The Godot window should now say "Connected to MPF". Congratulations, you're running a pinball game!

You can now proceed to set up your GMC slides and start creating modes.

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!

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

While using the search function: