Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Gem Version Actions CI Build status Maintainability Coverage Status

Terminal mine hunting game built with TTY toolkit components.

Minehunter is a terminal puzzle game inspired by the classic "Minesweeper".

To win a game, a player needs to uncover all the fields inside the grid that don't contain mines. Uncovering a field with a mine immediately ends the game. When an uncovered field has no mine present, it can either be empty or show a number. The number specifies how many mines are in surrounding fields. Armed with this knowledge, the player can deduce fields safe to uncover and use a flag to mark the ones that hide a mine. The number of available flags matches the number of the randomly placed mines. But, the player is not required to use any flags to win the game.

There are three preconfigured difficulty levels:

  • Easy - 9x9 with 10 mines
  • Medium - 16x16 with 40 mines
  • Hard - 32x32 with 99 mines

The player can also create a custom grid with an arbitrary number of mines.

Here is an example of playing on a 20x10 grid with 30 mines:

Playing Minehunter


Add this line to your application's Gemfile:

gem "minehunter"

And then execute:

$ bundle install

Or install it yourself as:

$ gem install minehunter


To start the game, run:

$ minehunter

Alternatively, run an alias:

$ minehunt

To change difficulty level use --level or -l option with easy, medium or hard:

$ minehunter --level easy

To customise the number of grid columns use --cols or -c option. Likewise, specify --rows or -r option to set the number of grid rows. For example, to play a game on a grid with 20 columns and 15 rows do:

$ minehunter --cols 20 --rows 15

Use --mines or -m option to set number of mines to be randomly placed on a grid:

$ minehunter --mines 25


After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.


The gem is available as open source under the terms of the GNU Affero General Public License v3.0.

Code of Conduct

Everyone interacting in the Minehunter project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.


Copyright (c) 2021 Piotr Murach. See LICENSE.txt for further details.