A Minecraft plugin that transforms the classic Minesweeper game into an immersive multiplayer experience!
This plugin creates a dedicated world where players can play Minesweeper in Minecraft. Each player or NPC receives their own isolated game platform with a randomly generated 10×10 minesweeper grid.
- Dedicated World: Automatic creation of an empty
world_minesweeperworld for the game - Individual Platforms: Each player gets their own chunk dynamically generated upon arrival
- Minesweeper Mechanics:
- Use the brush to reveal tiles
- Glazed terracotta blocks are retextured via a resource pack to display minesweeper numbers
- Uncover a TNT and the entire platform explodes!
- Mannequin Support: Fake players (mannequins) can be spawned for testing purposes
- Automatic Management: Platforms are created on arrival and cleaned up on departure
- Complete Protection: Players can only interact with their own chunk
- Join the
world_minesweeperworld:/execute in minecraft:world_minesweeper run tp <player> 0 100 0 - You automatically receive:
- A brush to reveal tiles
- 15 redstone torches to mark suspected TNTs
- Use the brush on suspicious sand to reveal what's underneath
- Glazed terracotta blocks are retextured to visually display the number of adjacent mines:
- Sand: No mines (empty tile)
- Blue glazed terracotta: 1 mine
- Green glazed terracotta: 2 mines
- Red glazed terracotta: 3 mines
- etc.
- Avoid uncovering TNT, or it's guaranteed explosion!
- Download the plugin
.jarfile for your server version. - Place it in the
plugins/folder of your Minecraft server. - Restart the server — that’s it!
Important:
- The empty
world_minesweeperworld is automatically created when the server starts.- The resource pack is automatically loaded for players when they join the
world_minesweeperworld, fetched from an external link.- The platform configuration is automatically downloaded to the
plugins/minesweeper/resources/folder from an external link.
The plugin uses glazed terracotta blocks to represent the number of adjacent mines. A resource pack is provided to retexture these blocks with classic minesweeper numbers:
| Number of Mines | Block |
|---|---|
| 0 | Sand |
| 1 | Blue Glazed Terracotta |
| 2 | Green Glazed Terracotta |
| 3 | Red Glazed Terracotta |
| 4 | Purple Glazed Terracotta |
| 5 | Yellow Glazed Terracotta |
| 6 | Light Blue Glazed Terracotta |
| 7 | Cyan Glazed Terracotta |
| 8 | Black Glazed Terracotta |
| 9 | Gray Glazed Terracotta |
In the world_minesweeper world, the following protections are active:
- ❌ Breaking Blocks: Impossible (except redstone torches on your own platform)
- ❌ Placing Blocks: Impossible (except redstone torches on your own platform)
- ❌ Dropping Items: Blocked to prevent item loss
- ❌ Attacking Entities: Impossible between players and NPCs
- ✅ Fall Damage: Disabled throughout the world
- 🔄 Void Fall: Automatic teleportation back to your platform
Note: Only server operators can bypass these restrictions.
When you reveal a tile with no adjacent mines (sand), all neighboring tiles are automatically revealed recursively, just like in classic minesweeper!
Mannequins (NPCs) can join the world to test the plugin. They automatically receive:
- A brush
- Their own game platform
- The same restrictions as players
- Platform Assignment: Players are placed in a spiral around spawn to optimize space usage
- Chunk Isolation: Each platform occupies a complete chunk (16×16 blocks)
- Automatic Clean-up: When a player leaves, their chunk is reset and becomes available again
- Safe Teleportation: Players are teleported to Y=100 at the center of their chunk
- Capacity Management: If all chunks are occupied (10000), new players are sent back to the main world
This project is licensed under the MIT License. See the LICENSE file for more details.