/mastermindy-desktop

The customizable Mastermind clone - desktop edition

Primary LanguageJavaMIT LicenseMIT

MasterMindy

The customizable Mastermind clone - desktop edition

Screenshots

About

MasterMindy is based on Mastermind, a turn-based code breaking game. The app will generate a secret code for you to deduce. You will only receive minimal hints. A black hint means you positioned a pawn perfectly... but which one? A white hint means one of your selected pawns is correct but in the wrong place. Play alone or with friends to try and solve this puzzle. You can easily change the difficulty on the settings page.

Further reading about the history, math & strategy of the game:

Game Features

  • Scalable to all window sizes and aspect ratios
  • Flexible amount of pawn fields
  • Flexible assortment of pawn colors to choose from
  • Difficulty change for allowing duplicate colors in the secret
  • Ability to show collision sensitive startup hints
  • Various time and turn limiting capabilities
  • Drag & drop pawns using mouse action
  • Uniquely named pawns for color blind people
  • Bitcoin donation ability :)

Coding Details

  • Cross-compatible with any operating system (Windows, MacOS, Linux)
  • Layout: 22 classes with an average length of 100 lines per class
  • Java-Swing dynamic JComponent placement & GUI construction during runtime
  • A terminal/console UI version is hidden within the code, consider it an easter egg for you to find and run
  • For Android mobile devices, see project MasterMindy-android

How to run

  • Download the .jar file from the releases page.

  • Linux users: you probably already have the required JRE. Try running the .jar file in a terminal window with the command java -jar ~/Downloads/nameOfJarFile.jar. If you don't have the JRE, install it for your specific Linux distribution.

  • Windows or MacOS users: find out if you already have the JRE by reading this. If not, get the JRE and double-click the .jar file.

Contact info & donations

See the contact file.