💣 Minesweeper Multiplatform 🚩
The classic Minesweeper game for Android, Desktop, iOS and Web with the ol' good Windows 3.1 appearance, entirely written with ✨Jetpack Compose✨.
Run on Desktop
./gradlew :desktop:run
Run on iOS simulator
./gradlew iosDeployIPhone13ProMaxDebug
./gradlew iosDeployIPadDebug
Run on Web
./gradlew :web:jsBrowserRun
🚧 TODO 🚧
- Add a difficulty selector that fits with the general look-and-feel of the app. Also, figure out how to bring the difficulty system from the classic game for Windows into a small screen environment.
- iOS and Web: Use icons and typography when available on Compose Multiplatform.
Instructions
- The game is played on a board of 12x9 cells. 20 of these cells are hiding a mine that will explode if player uncovers them. The rest of cells are safe to uncover. Click on each cell to revel what's beneath. The goal of the game is to uncover all the cells from the board that do not contain a mine. Uncovering a mined cell will result in losing the game.
The board contains the following elements: A timer, activated when the first cell is uncovered, and paused when the game is on background; The New Game button; A counter of mines left to flag (it can be less than zero if there are more flags than mines)
- An uncovered cell will display the number of neighbor cells that contain a mine, ranging from 1 to 8. A neighbor is any of the 8 cells surrounding the target cell. If a cell with no close mine is revealed, it won't show any number, and the game will recursively uncover its neighbors until reaching cells with close mines or the edges of the board.
The number 2 on this cell means that two of the eight neighbors of this cell contain a mine
- If a cell is suspected to hide a mine, you can mark it with a flag by long-clicking the cell. Flagged cells cannot be uncovered. Long-click on a flagged cell to remove its flag. Keep in mind that:
- Flagging a cell does not guarantee that the marked cell will contain a mine. Be careful with marking safe cells.
- Flagging does not take part in the game resolution. Remember that in order to win the game, you must uncover all the safe cells.
- If you think you have flagged all the mined neighbors of a cell (having the same many flags as the numbered cell indicates), you can just click on the uncovered cell to automatically reveal the rest of close neighbors, even though they contain a mine. If you have marked a safe cell by mistake, it means that one of the covered cells is an actual mine, and it will explode on doing this action
Revealing the rest of uncovered mines when flags are placed on mine cells
Revealing the rest of uncovered mines when one or more flags are placed on safe cells
License
MIT License
Copyright (c) 2021 Alex Barceló
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.