https://github.com/8dcc/minesweeper
Simple terminal minesweeper with cursor support made in C
https://github.com/8dcc/minesweeper
c cli game minesweeper ncurses vim-keybindings
Last synced: 4 months ago
JSON representation
Simple terminal minesweeper with cursor support made in C
- Host: GitHub
- URL: https://github.com/8dcc/minesweeper
- Owner: 8dcc
- License: gpl-3.0
- Created: 2023-03-22T14:45:48.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-11T23:55:07.000Z (over 1 year ago)
- Last Synced: 2025-02-23T12:14:31.823Z (4 months ago)
- Topics: c, cli, game, minesweeper, ncurses, vim-keybindings
- Language: C
- Homepage:
- Size: 71.3 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 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:
```console
$ git clone https://github.com/8dcc/minesweeper
$ cd minesweeper
$ make
...
```
If you encounter an error like:
```console
$ 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
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:
```console
$ ./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:
```console
$ ./minesweeper.out --keys
Controls:
- Move in the grid
hjkl - Move in the grid (vim-like)
- Reveal tile
- Reveal clicked bomb
f - Flag bomb
- 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 `` or flagged using `f`.
- `F`: Flagged tile that can be unflagged with `f`.
- `@`: You just revealed a tile with a bomb. You lost.
- ``: Empty tile with *N* adjacent bombs.
### Aditional features
Comment the following line inside [`src/defines.h`](src/defines.h) if you don't
want this feature:
```c
/*
* 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`](src/defines.h) if you don't
want color support:
```c
/*
* 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`](src/defines.h) if you don't
want mouse support:
```c
/*
* If you compile the program with USE_MOUSE and your terminal supports it, it
* will make the tiles clickable.
*/
#define USE_MOUSE
```