Terminal based minesweeper game coded in C++.
Welcome to the minesweeper game. In this game the mines are hidden at random locations in the board and the player needs to find out these locations with the help of numbers hidden in the board. Each number indicates the number of mine(s) present around them. Flag all the locations of mines to win the game but, be aware. If any mine explodes, it will genrate a chain-reaction and explode all the mines present in the board and you will lose the game.
The bomb Character:
*The flag Character:
#The Character to hide:
.
Project is created with:
- Turbo C++ 4.0 Windows 7 Windows 8 64Bit Version
When you will open the game it will display the general info of the game on the Introduction page and will ask you the size of board you want play on.
Avoid choosing size of board more than 10 so that board get display properly
After you provide the size of board let's say suppose n then the board will be created of dimensions n x n and the
20% of total n x n cells of board will contain Mines at random locations
After the board is created of desired size we can view it on the Game page along with other details like total numer of mines present and total number of locations flaged
Now, the player will have 4 options to play the game:
- Press 1 to open a position
- Press 2 to Flag a position
- Press 3 to Undo Flag
- Press 4 to Submit
As it is a terminal version of minsweeper, it dosn't have a facility of clicking a location to access it for opening/flagging it. Rather, we have to enter the row and column number of the cell we have to access after we select the desired operation.
The number of moves are counted, so each time you select an operation from the options the moves count get incremented by 1.
If you Press 1:
the open location option will get selected and the game will ask us to enter the row and column number of the cell we want to open. We can only open a location if it is not flagged or opened priviously and the entered row and column number is valid. After you open a location successfully the board will get updated accordingly to the character which was hidden.
If the hidden character was a number betwwen 1 and 8 inclusivly: the location will get opened normally.
If the character was the bomb: it will start a chain reaction and all the bombs in the board will get exploded and the game will get over.
If the character was '0': it will open all the locations around it until it find the locations containing a number between 1 and 8.
If you Press 2:
the flag location option will get selected and the game will ask us to enter the row and column number of the cell we want to flag. We can only flag a location which was not opened or flagged previously and the entered row and column number is valid. After you flag a location it's character will change from hidden to flag character no matter what is the valus of the location.
Each time you flag a location the flag count will be incremented but be aware don't flag a location unnecessarily. The flag count is limited to number of mines and you cannot flag more than the number of mines present in the board.
If you Press 3:
The undo flag location will get selected and the game will ask us to enter the row and column number of the cell we want to remove flag from. We can only remove flag from the location which is still flagged and the entered row and column number is valid. It is a important feature of the game as the number of flags are limitted and you may want to re-think about some locations before submitting your game.
If you Press 4:
The submit operation will get selected. you should select it only when you want to quit the game or you have completed it. if you select this option before using all your flags the game will ask for your confirmation and if you confirm your submission, it will show the Result page where your number of moves and the score scored by the player.
The score is calculated after the submission. Each loaction opened safly increase score value by 1 and each location flagged correctly increase score value by 10.
Back to Table of contents
The game is coded in C++ programming language without any classes and object. The complete is coded keeping in mind the Procedural Oriented Programming pradigm using only functions.
- The function which show the general-info of the game and takes input of the size of the board from the player.
int introduction();- The function to initialize the board passed in the parameter and set the default value of each cell as
0.
void initialBoard(char**, int);- The function to set each cell value of the display-board to
.character.
void createDisplayBoard(char**, int);- The function to create the logic-board in which the amount of mines to be created are set.
void createLogicBoard(char**, int);- The function to create mines at random locations in the logic-board.
void createMines(char**, int, int);- The function to create the hints around the mines.
void createHints(int, int, char**, int);- The function to disply the board which is passed in the parameter.
void displayAnyBoard(char**, int);- The function which return the current amount of flags in the display board.
int countFlags(char**, int);- The function which return the total amount of mines in the logic-board.
int countMines(char**, int);- The function to open a cell and update display-board according to the result of comparision between logic-board and display-board.
int openLocation(char**, char**, int, int, int);- The function to open locations recursivly around the current cell if the cell has value 0.
void foundZero(int, int, char**, char**, int);- The function to flag a location on the display-board.
void flagLocation(char**, int, int, int);- The function to remove a flag from a flagged location.
void undoFlag(char**, int, int, int);- The function to stop the game either when you win the game or when you decide to quit in between.
int submit(char**, char**, int, int, int);- The function to claculate the score scored by the player in the game after submission.
int scoreCalculator(char**, char**, int);- the function to display all the mines after the player hits a mine while opening a location.
void showMines(char**, char**, int, int, int);The logic of the code is simple there is two-dimensional array of character used in the game board, but the unique thing here is that there are actually two boards in the play. One which show us the output the display-board. The other which contain the vlue of the locations which is hidden from us the logic-board. Whenever we try to perform any opertion like open or flag a location, the display-borad is the one which gets updated and it updates according to the value which is present at the same location in the logic-board.
In the main function where the actual playing of the game happens ther is a infinite while loop which can only be stoped when the player surrenders or wins the game. In each iteration of the loop the updated display-board get displayed, the number of moves get incremented, the current number of flags on the display board gets updated, player chooses the opration and the condition for gameover is checked. If the player wins/surrenders/loses the score is calculated and the result is decleared accordingly.
void main(){
// initialize variables and take n
// initialize & create logic-board and display-board of n x n
mcount = countMines(logicBoard, n);
while(!gameover && !lost){
clrscr();
fcount = countFlags(displayBoard, n);
cout<<" Mines = "<<mcount<<"\t"<<" Flags = "<<fcount<<"\n";
displayAnyBoard(displayBoard, n);
// provide options
switch(choice){
case 1:
lost = openLocation(logicBoard, displayBoard, n, mcount, fcount);
break;
case 2:
flagLocation(displayBoard, n, mcount, fcount);
break;
case 3:
undoFlag(displayBoard, n, mcount, fcount);
break;
case 4:
gameover = submit(logicBoard, displayBoard, n, mcount, fcount);
if(gameover == -1){
lost = 1;
}
moves--;
break;
default:
cout<<"\n\t\tEnter a valid Choice!!\n\t\tPress Enter to continue...";
break;
}
moves++;
}
if(lost == 1){
score = scoreCalculator(logicBoard, displayBoard, n);
// gameover lost message
}
if(gameover == 1){
score = scoreCalculator(logicBoard, displayBoard, n);
// gameover win message
}
}Back to Table of contents
The next version will conatin these updates:
- Difficulty level: By default the game conatins 20% mines, after adding this the game will ask the player for the desired difficulty level.
- Beginner: containing 10% mines.
- Easy: containing 20% mines.
- Medium: containing 25% mines.
- Hardy: containing 35% mines.
- Leader Board Result: After the submissions the Result page just shows the result of the current match but instead in the next version due to this feature the game will ask player to enter player name and store the player name, difficulty, board size, number of moves and the score scored by player in a database which will get displayed after the result of current game in the form of a Leader board.
- More Accurate Score: the score calculation will also include number of moves as variable for a more accurate score in the next update.
Back to Table of contents