Minesweeper

CLI minesweeper made in C using ncurses.

Description

Note This is a fork of 8dcc/minesweeper for fs-os. You can try it there by running the minesweeper command.

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).

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 (unsupported)
        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   1@..1 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