Emoji Minesweeper is a logic puzzle game, a variant of the classic minesweeper game reimagined and implemented using emoji! It features a grid of clickable squares, with hidden mines (or flowers) scattered throughout the board. Safe squares have numbers telling you how many mines touch the square. If there is no number, the square doesn't touch any mine. You can use the number clues to solve the game by opening all of the safe squares. If you click on a mine you lose the game!
Emoji Minesweeper always makes the first click safe. You open squares with the left mouse button and put flags on mines with the right mouse button.
The game ends when all safe squares have been opened (win) or when a square containing a mine is opened (loss). If you win, the empty square get filled with happy faces ๐, and if you lose they get filled with sad faces ๐ต.
There are four levels (beginner, intermediate, expert, and custom) and six themes (mine ๐ฃ, flower ๐บ, mushroom ๐, bear ๐ป, surf ๐, and Japan ๐ฏ) to choose from.
Lastly, players can choose between light โ๏ธ and dark ๐ mode.
Additional information for nerds ๐ค (architecture, technologies, debugging) can be found in the documentation.
ย ย ย ย
ย ย ย ย
ย ย ย ย
You can find more information in the documentation.
This is the user interface of Emoji Minesweeper. Such a colorful amalgamation of emoji! On the top, you can see a grid of squares: the board. The black square button emoji ๐ฒ means that the square has not been opened yet. Left-click on any square to open it, and start the game. You don't have to worry about your first move, as we have made sure that your first square can never contain a mine (actually it can, but if that's the case, we relocate the mine to another square so fast that you don't even realize it - you can thank us later). Right below the board you can find three counters.
On the left you can find the mine counter ๐ฃ. It shows the number of mines on the board without flags (we will talk about flagging shortly).
In the middle, next to the abacus ๐งฎ you can find the moves counter. It keeps track of how many moves you have made since the beginning of each game. By moves we mean all the clicks (left and right) you have made on closed squares.
Finally, on the right, you can find an โ hourglass and, more importantly, the time counter, keeping track of time: seconds passed since you opened the first square. Now let's go back to our game.
After you click on a square, you will get something like this. When you open a square that does not touch any mines, it will be opened and the adjacent squares will automatically be opened in all directions until reaching squares that contain numbers. A common strategy for starting games is to randomly click until you get a big opening with lots of numbers.
The empty squares โฌ๏ธ are safe squares that do not touch any mines. Some safe squares have numbers telling you how many mines touch the square. The numbered squares can be either 1๏ธโฃ, 2๏ธโฃ, 3๏ธโฃ, 4๏ธโฃ, 5๏ธโฃ, 6๏ธโฃ, 7๏ธโฃ, 8๏ธโฃ. Why don't we have nine as well? Because each square can be touched by eight square at most. Most squares are touched by eight other squares. If a square is located on the border of the board, it is touched by six other squares (as one of its sides is not touched by anything), and if a square is located in one of the four corners of the board, it is touched by only three other squares. Let's see an example.
Let's focus on the 1๏ธโฃ square in the middle. It is touched by eight other squares (oh, by the way, diagonal squares count as well). We can observe that all its surrounding squares but one have been opened and are safe. On its left, we can see three empty squares and on its top, bottom and right we can see four numbered squares and a closed one. Since its number is 1๏ธโฃ, it has to be touched by exactly one mine. Thus, we can safely assume that the closed square will contain a mine.
In order to make our life easier, and keep track of the squares containing mines, we can right-click on these squares and flag them ๐ฉ using a red flag.
Be careful, because if you flag more squares than the total number of mines, you won't be able to finish the game, until you unflag some squares. Fortunately, we've got you covered on that too, as the mine counter will turn red if you do so.
If you click on a mine you lose the game. If you had wrongly flagged any squares as mines they will be marked with an โ, to help you identify your mistakes.
Yeah, losing looks like this.
Or like this.
Or like this. Not too bad, huh? In order to win a game, you need to open all the safe squares. When you win or lose a game you need to start a new one. You can achieve that by clicking on the ๐ button or by pressing the N key.
In order to keep track of how good (or bad) you are doing the game keeps your stats. To open the stats modal click the ๐ button. Stats include metrics such as games played, games won, percentage of wins, best time and best moves and are kept separately for each level. Don't worry if you are not doing that well, as you can always clear your data by clicking on the Clear button, located inside the stats modal. You can also toggle the stats modal by pressing the S key.
If you do a new best time or win the game by the less moves than ever before, not only are your stats updated accordingly, but empty squares become the partying emoji ๐ฅณ. The respective counters turn gold as well. In these examples, the player achieved both a new time record and a moves record, thus both counters have turned gold.
There are four difficulty levels, with different board sizes and numbers of mines. Along with the classic and predetermined beginner, intermediate, and expert levels, there's a custom level as well, giving players the ability to set the dimensions of the board, as well as the number of mines.
| Level | Dimensions | Mines | % of Mines |
|---|---|---|---|
| Beginner | 9x9 | 10 | ~12.34% |
| Intermediate | 16x16 | 40 | ~15.63% |
| Expert | 30x16 | 99 | ~20.63% |
You can use the level buttons 1๏ธโฃ2๏ธโฃ3๏ธโฃ*๏ธโฃ to switch between levels. You can also use the keyboard keys 1, 2, 3, and 4.
If you click the *๏ธโฃ button, the custom level modal will appear.
Here you can choose the width, the height, and the number of mines for your desired custom level. When you click Submit, your custom level will appear!
This is a custom level featuring 9 columns, 15 rows, and 6 mines. Quite long, isn't it?
The game features six themes with different emoji sets to choose from. Apart from the classic mine theme ๐ฃ and the peaceful and relaxing flower theme ๐บ, you can find a mushroom theme ๐, a bear theme ๐ป, a surf theme ๐, and a Japan theme ๐ฏ. You can use the theme button ๐ฃ/๐บ/๐/๐ป/๐/๐ฏ to switch between themes, or use the left and right arrows on your keyboard. These are the rest of the themes:
The mushroom theme.
The bear theme.
The surf theme.
And the Japan theme. I bet you can't decide which one to pick! Your level and theme preferences are saved in your computer, so your next game always starts with the lastly used configuration.
If you forget the basic controls you can click the help button โto toggle the help modal. You can also toggle the help modal by pressing the H key.
Clicking on the flag button ๐ฉ will toggle flag mode. This will enable you to flag squares by touching them, or by left-clicking on them. You can also toggle flag mode by pressing the F key. You might want to use this if you are on a phone or tablet. If, on the other hand, you are on a computer, the cursor will be changed to a crosshair, to inform you that flag mode is enabled.
Clicking on the โ๏ธ/๐ button allows players to choose between light and dark mode. You can also switch between dark and light by pressing the D key. Quite useful for those long night sessions!
Lastly, we should mention the concept of chording. When an uncovered square with a number has exactly the correct number of adjacent squares flagged, performing a click using the mouse's wheel (or middle button) on it will uncover all unmarked squares. This is called a chord. It is a basic technique that allows players to clear squares using flags, and the reason why flagging styles are often more efficient than non-flagging ones.
- Left-click to open a square square
- Right-click to flag a square (that you think) contains a mine
- Middle-click for chording
- ๐ฃ Mines counter
- ๐งฎ Moves counter
- โ Time counter
- ๐ restarts the game
- 1๏ธโฃ2๏ธโฃ3๏ธโฃ*๏ธโฃ buttons switch between levels (beginner, intermediate, expert, and custom)
- ๐ button toggles the stats modal
- ๐ฃ/๐บ/๐/๐ป/๐/๐ฏ button switches between themes (mine, flower, mushroom, bear, surf, and Japan)
- โbutton toggles the help modal
- ๐ฉ button toggles flag mode (for touchscreens)
- โ๏ธ/๐ button toggles dark mode
| Key | Action |
|---|---|
| ฮ | New game (current level and theme) |
| S | Open/close stats modal |
| 1 | Switch to beginner level |
| 2 | Switch to intermediate level |
| 3 | Switch to expert level |
| 4 | Switch to custom level |
| Left Arrow | Switch to next theme |
| Right Arrow | Switch to previous theme |
| H | Open/close help modal |
| F | Toggle flag mode |
| D | Toggle dark mode |
You can find a full(ish) feature list in the documentation.
The following emoji are used throughout the game:
๐ฒ โฌ๏ธ ๐ณ โฌ ๐ 1๏ธโฃ 2๏ธโฃ 3๏ธโฃ 4๏ธโฃ 5๏ธโฃ 6๏ธโฃ 7๏ธโฃ 8๏ธโฃ *๏ธโฃ ๐
| Theme | Game Title | Emoji Set |
|---|---|---|
| Mine | Emoji Minesweeper | ๐ฃ ๐ฅ ๐ ๐ต |
| Flower | Emoji Flower Field | ๐บ ๐ ๐ ๐ |
| Mushroom | Emoji Mushroom Picker | ๐ ๐ฆ ๐ ๐ตโ๐ซ |
| Bear | Emoji Bearspotting | ๐ป ๐พ ๐ณ ๐ชต |
| Surf | Emoji Surfsweeper | ๐ ๐ฆ ๐ ๐ฆ |
| Japan | ็ตตๆๅญใใคใณในใคใผใใผ | ๐ฏ ๐บ ๐ธ ๐ |
The emoji font used in the game is the Segoe UI Emoji font that can be found here. If you are running Windows 11, this font family is already installed on your computer. If you are running Linux, you can install and use the Segoe UI font family by following these instructions.
The first ever modern emoji existed on a device that came even before phones. In 1995, Japanese Telecom Company NTT DoCoMo made the first emoji available on its Pocket Bell pager model. As you can see Emoji Minesweeper is using some of these very first emoji!
You can find more information about the history of emoji here.
- Michael Kolesidis
- Margarita Marmaridou
- You can be on this list, too!
Thank you so much for your interest in my project! If you want to go a step further and support my open source work, buy me a coffee:
Antipersonnel landmines are explosive devices designed to be detonated by the presence, proximity, or contact of a person. Placed under or on the ground, they can lie dormant for years and even decades until a person or animal triggers their detonating mechanism.
Incapable of distinguishing between the footfall of a soldier and that of a child, antipersonnel mines cannot be aimed. They indiscriminately kill or injure civilians, aid workers, peacekeepers, and soldiers alike. They pose a threat to the safety of civilians during conflicts and long afterwards.
The International Campaign to Ban Landmines (ICBL) is a coalition of non-governmental organizations whose stated objective is a world free of anti-personnel mines and cluster munitions, where mine and cluster munitions survivors see their rights respected and can lead fulfilling lives. We urge you to visit their website, get informed, and support their work in any way possible.
The ICBL, in close partnership with a small number of states, the ICRC, and the UN, put in motion what was later known as the โOttawa Processโ that led to the adoption of the Mine Ban Treaty in September 1997. The Mine Ban Treaty, which includes a comprehensive ban on all antipersonnel mines as well as several measures to redress the harm from past use, was adopted in Oslo (Norway) in September 1997, and opened for signature on 3 December 1997 in Ottawa (Canada.)
Copyright (c) 2025 Michael Kolesidis
Licensed under the GNU Affero General Public License v3.0.
