CS1010301-MineSweeper-Project

111.2 CS1010301 物件導向程式設計實習踩地雷遊戲.
MineSweeper game with GUI supported, writing in C++.

Support Platforms

Windows MSVC
MacOS AppleClang
Linux GCC/Clang

⚠️ Apple Silicon (arm64) is not currently supported.

Build

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .

Run Mode

The game support in console mode and GUI mode.
We can use launch arguments to run the game in different mode.
By default run the game it running in GUI mode.

Command Input

./MineSweeper CommandInput

Command File

./MineSweeper CommandFile <InputCommandFile> <OutputResultFile>

GUI

./MineSweeper GUI

Game State

Standby
Playing
GameOver

Command

Command	Usage	Standby	Playing	GameOver
`Load`	Load game board	✅
`StartGame`	Start game	✅
`Print`	Print the information	✅	✅	✅
`LeftClick`	Left click a block (Uncover block)		✅
`RightClick`	Right click a block (Put flag)		✅
`Replay`	Start a new game			✅
`Quit`	Quit game			✅

Load

Load <Load Mode...>

Load Mode

BoardFile

Load the generated board file

Load BoardFile <file_path>

Example

Load BoardFile ./boards/board1.txt

RandomCount

Generate a board with random count mines

Load RandomCount <width> <height> <mines_count>

Example

Load RandomCount 10 10 10

RandomRate

Generate a board with random rate mines

Load RandomRate <width> <height> <mines_rate>

Example

Load RandomRate 10 10 0.3

Print

Print <Print Mode...>

Print Mode

GameBoard

Current game board

Covered block #
Uncovered block number
Flag f
Question Mark ?
Mine X

Example Input

Print GameBoard

Example Output

0 0 0 0 0 0 0 0 1 # 
0 0 0 0 0 0 0 0 1 1 
1 1 1 0 0 0 0 0 0 0 
# f 1 0 1 1 2 1 1 0 
1 1 1 0 1 # ? # 2 1 
0 0 0 0 1 1 # # # # 
0 0 0 0 0 1 # # # # 
0 0 0 0 1 2 # # # # 
1 2 1 1 1 # # # # # 
# # # # # # # # # #

GameAnswer

Example Input

Print GameAnswer

Example Output

0 0 0 0 0 0 0 0 1 X 
0 0 0 0 0 0 0 0 1 1 
1 1 1 0 0 0 0 0 0 0 
1 X 1 0 1 1 2 1 1 0 
1 1 1 0 1 X 2 X 2 1 
0 0 0 0 1 1 2 1 2 X 
0 0 0 0 0 1 1 1 1 1 
0 0 0 0 1 2 X 1 0 0 
1 2 1 1 1 X 3 2 0 0 
X 2 X 1 1 2 X 1 0 0