3 minesVIiper is a clone of Minesweeper, which runs in the terminal and can be
4 controlled by either `vi` style keybindings, or the mouse.
6 Multiple character and color schemes are available, but more can be added
9 ## Keybindings and mouse
12 | ----------- | ------------------------- |
13 | `h`/`b`/`^` | move 1/5/all to the left |
14 | `j`/`d`/`G` | move 1/5/all down |
15 | `k`/`u`/`g` | move 1/5/all up |
16 | `l`/`w`/`$` | move 1/5/all to the right |
17 | `i` | flag / unflag |
18 | space | open / chord |
19 | `r` | restart game |
20 | Ctrl-L | redraw screen |
23 Use the left mouse button to open or chord a cell, and the right button to flag.
25 A new game can be started by clicking on the `:D` icon.
27 ## Command line arguments
29 | Arg. | Description |
30 | ------ | ------------------------------- |
32 | `-w N` | set field width to N cells |
33 | `-h N` | set field height to N cells |
34 | `-m N` | set number of mines to N |
35 | `-n` | disable flagging |
36 | `-f` | enable flagging (default) |
37 | `-q` | enable question marks |
38 | `-c` | switch to the colored scheme |
39 | `-d` | switch to the DEC charset scheme |
43 By default, minesVIiper comes with three schemes; black-and-white, color, and
44 DECTerm. The first two use unicode characters and therefore require a modern
45 software terminal emulator like GNOME Terminal, XTerm, or others.
46 The DEC color scheme uses Digital, Inc.'s proprietary *Special Graphics Character
47 Set*, which is implemented on the VT220 and later models. (full support for this mode
48 in terminal emulation software is rare)
50 ## Compiling and extending
52 To compile minesVIiper, just run `make`. The phony target `run` will compile and
53 execute the program with the default settings (monochrome scheme, 30x16x99
56 While the main source of the program (`mines_2017.c`) is pure ASCII, `schemes.h`
57 is UTF-8-encoded. Therefore, care must be taken when editing character schemes.
61 This program is released under the terms of the GNU GPL version 3.
62 © 2015-2017 Tobias Girstmair