Mastermind in Rust

Masterming game coded in Rust

Table of Contents

General Information

Mastermind or Master Mind is a code-breaking game for two players. Coded in Rust with slint. If the slint part does not compile for you, you can try the terminal version on tag v0.1

I implemented the version as a training to learn the Rust programming language.

Rules

From Wikipedia.

The game is played using:

• a decoding board, with a shield at one end covering a row of four large holes, and twelve (or ten, or eight, or six) additional rows containing four large holes next to a set of four small holes;
• code pegs of six different colors (or more; see Variations below), with round heads, which will be placed in the large holes on the board; and
• key pegs, some colored black, some white, which are flat-headed and smaller than the code pegs; they will be placed in the small holes on the board. The two players decide in advance how many games they will play, which must be an even number. One player becomes the codemaker, the other the codebreaker.[3]: 120  The codemaker chooses a pattern of four code pegs. Players decide in advance whether duplicates and blanks are allowed. If so, the codemaker may even choose four same-colored code pegs or four blanks. If blanks are not allowed in the code, the codebreaker may not use blanks in their guesses. The codemaker places the chosen pattern in the four holes covered by the shield, visible to the codemaker but not to the codebreaker.[4]

The codebreaker tries to guess the pattern, in both order and color, within eight to twelve turns. Each guess is made by placing a row of code pegs on the decoding board.[3]: 120  Once placed, the codemaker provides feedback by placing from zero to four key pegs in the small holes of the row with the guess. A colored or black key peg is placed for each code peg from the guess which is correct in both color and position. A white key peg indicates the existence of a correct color code peg placed in the wrong position.[5]

If there are duplicate colors in the guess, they cannot all be awarded a key peg unless they correspond to the same number of duplicate colors in the hidden code. For example, if the hidden code is red-red-blue-blue and the player guesses red-red-red-blue, the codemaker will award two colored key pegs for the two correct reds, nothing for the third red as there is not a third red in the code, and a colored key peg for the blue. No indication is given of the fact that the code also includes a second blue.[6]

Once feedback is provided, another guess is made; guesses and feedback continue to alternate until either the codebreaker guesses correctly, or all rows on the decoding board are full.

Traditionally, players can only earn points when playing as the codemaker. The codemaker gets one point for each guess the codebreaker makes. An extra point is earned by the codemaker if the codebreaker is unable to guess the exact pattern within the given number of turns. (An alternative is to score based on the number of key pegs placed.) The winner is the one who has the most points after the agreed-upon number of games are played.

Other rules may be specified.

Technologies Used

• Rust 1.58.1 with Cargo 1.58.0
• Crate : rand 0.8.3 and slint 0.2

Features

• Play against the computer in a terminal
• Possibility to change the number of colors, pins in the code and tries

Setup

To run this project, install it locally using cargo:

$ cd ../mastermind
$ cargo build

Usage

To play a game, just type :

$ cargo run

Project Status

Project is in progress.

Room for Improvement

Room for improvement:

• Take the number of pins and colors as an argument

Contact

Created by ElevenJune - feel free to contact me!