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:
Add this line to your application's Gemfile:
And then execute:
$ bundle install
Or install it yourself as:
$ gem install minehunter
To start the game, run:
Alternatively, run an alias:
To change difficulty level use
-l option with
$ minehunter --level easy
To customise the number of grid columns use
-c option. Likewise, specify
-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
-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 rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/piotrmurach/minehunter. 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.