Skip to content

High score (mode)

MPF includes a built-in high score mode that can be used to track high scores, including letting players enter their names (or initials) and tracking different high score awards. (See the How To: High Scores guide for details).

You can use the config files to completely customize how the high scores work, including the number of scores to track, what you call each award ("GRAND CHAMPION", "HIGH SCORE 1", etc.) and what (and how many) awards you track (score, loops, aliens blasted, etc.).

The high score mode stores its high scores in <your_machine_folder>/data/high_scores.yaml file. It automatically reads them in when MPF boots to create machine variables that can be accessed from your game, and it automatically updates the high scores on disk when they change after a game ends.

See High Scores for details.

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