Skip to content

Player Variables Reference

Here's a list of all the different "built in" player variables that MPF uses.

You can use these in your config files to trigger game logic or to display as text on your display.

Video about player and machine variables:

Note that you can also create your own player variables in your configs, and most likely your machine will have several orders of magnitude more player variables than this list here.

That said, here's a list of the "built in" player variables and how they work:

config_section: counters, accruals, sequences (mode)_(timer)_tick number random(x).(y) restart_modes_on_next_ball score

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