Minesweeper

CLI minesweeper made in C using ncurses.

Description

Simple CLI minesweeper with custom resolution (game size), difficulty and vim-like movement. It has mouse support (if your terminal supports it and it was compiled with USE_MOUSE) and also has color support (if your terminal supports it and it was compiled with USE_COLOR).

Building

Simply run:

$ git clone https://github.com/8dcc/minesweeper
$ cd minesweeper
$ make
...

If you encounter an error like:

$ make
gcc -Wall -Wextra -o minesweeper.out src/main.c -lncurses -ltinfo
/bin/ld: cannot find -ltinfo: No such file or directory
collect2: error: ld returned 1 exit status
make: *** [Makefile:22: minesweeper.out] Error 1

Try removing -ltinfo from the linker options:

diff --git a/Makefile b/Makefile
index bc53b0e..c64d41d 100644
--- a/Makefile
+++ b/Makefile
@@ -1,7 +1,7 @@

 CC=gcc
 CFLAGS=-Wall -Wextra
-LDFLAGS=-lncurses -ltinfo
+LDFLAGS=-lncurses
 BIN=minesweeper.out

 .PHONY: clean all run

Usage

Parameters:

$ ./minesweeper.out --help
Usage:
    ./minesweeper.out                   - Launch with default resolution
    ./minesweeper.out --help            - Show this help
    ./minesweeper.out -h                - Same as --help
    ./minesweeper.out --keys            - Show the controls
    ./minesweeper.out -k                - Same as --keys
    ./minesweeper.out --resolution WxH  - Launch with specified resolution (width, height)
    ./minesweeper.out -r WxH            - Same as --resolution
    ./minesweeper.out --difficulty N    - Use specified difficulty from 1 to 100. Default: 40
    ./minesweeper.out -d N              - Same as --difficulty

Keys:

$ ./minesweeper.out --keys
Controls:
    <arrows> - Move in the grid
        hjkl - Move in the grid (vim-like)
     <space> - Reveal tile
    <LMouse> - Reveal clicked bomb
           f - Flag bomb
    <RMouse> - Flag clicked bomb
           r - Reveal all tiles and end game
           q - Quit the game

Characters:

+--------------------------------------------------+
|..................................................|
|..................................................|
|..................................................|
|.......................211........................|
|.......................1 1........................|
|......................31 1........................|
|.....................21  1123.....................|
|..................2221      12....................|
|..................1          111..................|
|..................1211         1..................|
|.....................1  111   12..................|
|..................2211  1F1 113...................|
|..................1   123.1 1.....................|
|..................2   [email protected] 11212.................|
|..................11111...2     2.................|
|..........................2     2.................|
|.........................31  1111.................|
|.........................2   1....................|
|.........................3   2....................|
|.........................2   1....................|
+--------------------------------------------------+

 You lost. Press any key to restart.

• : Empty tile with no bombs adjacent.
• .: Unknown tile that can be revealed using <space> or flagged using f.
• F: Flagged tile that can be unflagged with f.
• @: You just revealed a tile with a bomb. You lost.
• <number>: Empty tile with N adjacent bombs.

Aditional features

Comment the following line inside src/defines.h if you don't want this feature:

/*
 * This line adds the "reveal surrounding" feature. With this feature, adjacent
 * tiles will get revealed if the user is trying to reveal:
 *   - An already revealed tile
 *   - With adjacent bombs
 *   - With all bombs flagged
 * Comment this line if you don't want this feature.
 */
#define REVEAL_SURROUNDING

Comment the following line inside src/defines.h if you don't want color support:

/*
 * If you compile the program with USE_COLOR and your terminal supports it, it
 * will render the tiles with color.
 */
#define USE_COLOR

Comment the following line inside src/defines.h if you don't want mouse support:

/*
 * If you compile the program with USE_MOUSE and your terminal supports it, it
 * will make the tiles clickable.
 */
#define USE_MOUSE