{"id":28630949,"url":"https://github.com/piotrmurach/minehunter","last_synced_at":"2025-06-12T13:09:26.238Z","repository":{"id":56883786,"uuid":"391655165","full_name":"piotrmurach/minehunter","owner":"piotrmurach","description":"Terminal mine hunting game.","archived":false,"fork":false,"pushed_at":"2024-03-19T22:55:56.000Z","size":118,"stargazers_count":23,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-23T05:49:57.334Z","etag":null,"topics":["cross-platform","game","minesweeper","minesweeper-game","puzzle-game","ruby","rubygem","terminal-game"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piotrmurach.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"piotrmurach"}},"created_at":"2021-08-01T14:49:31.000Z","updated_at":"2024-10-23T17:34:39.000Z","dependencies_parsed_at":"2024-03-19T23:48:22.189Z","dependency_job_id":null,"html_url":"https://github.com/piotrmurach/minehunter","commit_stats":{"total_commits":26,"total_committers":1,"mean_commits":26.0,"dds":0.0,"last_synced_commit":"f8ef0ef0298d33d771b4290367995fe4fe672278"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/piotrmurach/minehunter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrmurach%2Fminehunter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrmurach%2Fminehunter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrmurach%2Fminehunter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrmurach%2Fminehunter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piotrmurach","download_url":"https://codeload.github.com/piotrmurach/minehunter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrmurach%2Fminehunter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259470951,"owners_count":22862999,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cross-platform","game","minesweeper","minesweeper-game","puzzle-game","ruby","rubygem","terminal-game"],"created_at":"2025-06-12T13:09:25.593Z","updated_at":"2025-06-12T13:09:26.220Z","avatar_url":"https://github.com/piotrmurach.png","language":"Ruby","readme":"# Minehunter\n\n[![Gem Version](https://badge.fury.io/rb/minehunter.svg)][gem]\n[![Actions CI](https://github.com/piotrmurach/minehunter/workflows/CI/badge.svg?branch=master)][gh_actions_ci]\n[![Build status](https://ci.appveyor.com/api/projects/status/6jnp11d5jpcvua4j?svg=true)][appveyor]\n[![Maintainability](https://api.codeclimate.com/v1/badges/bce6981d523e678029e7/maintainability)][codeclimate]\n[![Coverage Status](https://coveralls.io/repos/github/piotrmurach/minehunter/badge.svg)][coverage]\n\n[gem]: https://badge.fury.io/rb/minehunter\n[gh_actions_ci]: https://github.com/piotrmurach/minehunter/actions?query=workflow%3ACI\n[appveyor]: https://ci.appveyor.com/project/piotrmurach/minehunter\n[codeclimate]: https://codeclimate.com/github/piotrmurach/minehunter/maintainability\n[coverage]: https://coveralls.io/github/piotrmurach/minehunter\n\n\u003e Terminal mine hunting game built with [TTY toolkit components](https://ttytoolkit.org/components/).\n\nMinehunter is a terminal puzzle game inspired by the classic \"Minesweeper\".\n\nTo 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.\n\nThere are three preconfigured difficulty levels:\n\n* Easy - 9x9 with 10 mines\n* Medium - 16x16 with 40 mines\n* Hard - 32x32 with 99 mines\n\nThe player can also create a custom grid with an arbitrary number of mines.\n\nHere is an example of playing on a 20x10 grid with 30 mines:\n\n![Playing Minehunter](https://github.com/piotrmurach/minehunter/raw/master/assets/minehunter_custom_grid_play.png)\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem \"minehunter\"\n```\n\nAnd then execute:\n\n    $ bundle install\n\nOr install it yourself as:\n\n    $ gem install minehunter\n\n## Usage\n\nTo start the game, run:\n\n```shell\n$ minehunter\n```\n\nAlternatively, run an alias:\n\n```shell\n$ minehunt\n```\n\nTo change difficulty level use `--level` or `-l` option with `easy`, `medium` or `hard`:\n\n```shell\n$ minehunter --level easy\n```\n\nTo 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:\n\n```shell\n$ minehunter --cols 20 --rows 15\n```\n\nUse `--mines` or `-m` option to set number of mines to be randomly placed on a grid:\n\n```shell\n$ minehunter --mines 25\n```\n\n## Development\n\nAfter 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.\n\nTo 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](https://rubygems.org).\n\n## Contributing\n\nBug 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](https://github.com/piotrmurach/minehunter/blob/master/CODE_OF_CONDUCT.md).\n\n## License\n\nThe gem is available as open source under the terms of the [GNU Affero General Public License v3.0](https://opensource.org/licenses/AGPL-3.0).\n\n## Code of Conduct\n\nEveryone interacting in the Minehunter project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/piotrmurach/minehunter/blob/master/CODE_OF_CONDUCT.md).\n\n## Copyright\n\nCopyright (c) 2021 Piotr Murach. See [LICENSE.txt](LICENSE.txt) for further details.\n","funding_links":["https://github.com/sponsors/piotrmurach"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrmurach%2Fminehunter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiotrmurach%2Fminehunter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrmurach%2Fminehunter/lists"}