Skip to content
This repository has been archived by the owner on Dec 26, 2021. It is now read-only.
/ Mastermind Public archive

An advanced CLI Mastermind game made in Python with local and online game modes

License

Notifications You must be signed in to change notification settings

au2001-efrei/Mastermind

Repository files navigation

Mastermind

This was originally a school project carried out during the first year at Efrei Paris.
The goal was to recreate the Mastermind board game in Python.
User-interface was unrestricted. This implementation is command-line only, specifically using ncurses.
It has been greatly improved from the initial requested specifications. Some improvements are details under Features.

Features

  • Play locally against the computer
    • Interrupt games and resume them using a token; can be on the same computer or a different one
  • Play online and save your record on a scoreboard
    • Enter a unique username to identify yourself
    • Custom game protocol implemented over TCP
    • Interrupt games and resume them automatically (based on IP address)
  • Make the computer play automatically with an A.I.
    • Tool to benchmark the computer: ~4.63 tries on average, 8 maximum (4 pins and 6 colors)
  • Several easter eggs hidden around the program

Installation

  • You will need to have Python 3.7.0 or later installed
  • You will need to have the curses module installed

Running

All the following commands assume your current working directory is the folder containing this README file. To do that, run cd path/to/folder.

  • To start the main program and obtain the menu, run python3 mastermind.py.
  • To interrupt a game while it is running and get a token to resume it later, press Ctrl + C.
  • To resume a pending game, run python3 mastermind.py TOKEN replacing TOKEN with the token obtained in the previous session.
  • To instantly start a Singleplayer game without going through the menu, run python3 singleplayer.py.
  • To instantly start an Online Ranked game without going through the menu, run python3 online_ranked.py.
  • To instantly start a Computer vs Computer game without going through the menu, run python3 computer_vs_computer.py.

To play an Online Ranked game, you have to start the server first. To do that, run python3 server.py.

If you run the server on a different machine, you have to edit the utils.py file on the Client machine to specify the IP address of the machine runnning it.

TODO

  • Add comments to server.py
  • 5 more eastereggs
  • Multiplayer gamemode (rotating player)
  • Player vs. Player (local + online)
  • Auto-discover servers/oponnents on the network or with a QR code and UPnP
  • LAN/Online PvP tournaments
  • Blockchain implementation rather than a centralized server!
  • Real AI, using deep learning?

About

An advanced CLI Mastermind game made in Python with local and online game modes

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages