https://github.com/gazpachoking/minesweeper

Cross-platform terminal based minesweeper. Because I was bored.
https://github.com/gazpachoking/minesweeper

Last synced: 24 days ago
JSON representation

Cross-platform terminal based minesweeper. Because I was bored.

• Host: GitHub
• URL: https://github.com/gazpachoking/minesweeper
• Owner: gazpachoking
• License: mit
• Created: 2018-06-01T18:48:21.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-10-03T21:08:49.000Z (about 1 year ago)
• Last Synced: 2024-08-02T12:44:50.319Z (3 months ago)
• Language: Python
• Size: 156 KB
• Stars: 19
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - gazpachoking/minesweeper - Cross-platform terminal based minesweeper. Because I was bored. (others)

README

        
Minesweeper

===========

Simple terminal based minesweeper. Python 3 required.

![minesweeper](https://gazpachoking.github.io/minesweeper/minesweeper.emoji.png)

Features

--------

- Cross platform

- Kaboom mode:

  - Cruel but fair, where guessing is punished, 

  but when only guesses are left you are guaranteed not to be wrong.

  - Based on the blog post [here](https://pwmarcz.pl/blog/kaboom/).

- Keyboard or mouse (or hybrid) control

- Standard and Knight's move modes

- Double-width characters (if your terminal supports it)

- QoL features:

  - Highlight adjacent tiles

  - Clear all adjacent

  - Mark all adjacent

  - Shows spaces that were provably empty after a loss (marked with yellow)

Controls

--------

- **N** New game

- **Q** Quit

- **Right-click/M** Mark mine/mark all adjacent

- **Click/Space** Reveal tile

- **Double-click/Space** Reveal all adjacent (except marked mines)

Legend

------

- ░ Unrevealed tile

- **\#** Marked as mine

- **1-8** Number of adjacent mines

- **\*** Unmarked mine (after game end)

- **X** Incorrect mark (after game end) 

CLI

---

- **--size X Y** Specify field size

- **--mines N** Specify number (or fraction of board) of mines

- **--niceness cruel|normal|fair|nice**

  - **nice** Any click that could result in an empty tile is an empty tile.

  - **fair** If guessing is the only move available, you will not guess wrong.

  - **normal** Traditional minesweeper.

  - **cruel** Any click that could result in a mine is a mine. (Except when guessing is the only move available.)

- **--style single|double** double mode uses full width unicode characters to

  double the cell size. Use single if this causes problems with your terminal.