Minesweeper

Classic Minesweeper played in the Minecraft world. Build fixed arenas, let players walk up and play, and reward the fastest.

Features

• Fixed arenas – build one anywhere with a single command; the terrain is restored when you delete it
• Classic rules – the first click is always safe, empty areas open in cascade, flags, and click an opened number to open its neighbours
• TNT mines – when you lose, every mine is revealed as a block of TNT
• Points & rewards – win to earn points (with a speed bonus) and run any console commands as rewards
• Records – fastest time per difficulty, with leaderboards
• Hints – spend points on a safe cell, a mine peek, or a shield
• PlaceholderAPI support – show records and stats in scoreboards, holograms and more
• Fully configurable – difficulties, rewards, hint costs, and every message (MiniMessage)

Quick start

1. Stand on flat, empty ground and run /ms arena create lobby easy
2. The board is built around you. Players click any cell to claim the arena and start playing
3. Left-click opens a cell, right-click places a flag

Commands

Command	Description	Permission
/ms hint <safe|peek|shield>	Use a hint during your game	minesweeper.play
/ms hints	List hints and costs	minesweeper.play
/ms stats [player]	Points, wins and best times	minesweeper.play
/ms top <difficulty|points>	Leaderboards	minesweeper.play
/ms leave	Abandon your game	minesweeper.play
/ms arena create <name> <difficulty>	Create an arena centered on you	minesweeper.admin
/ms arena delete [name]	Delete an arena (without a name, the one you are standing on)	minesweeper.admin
/ms arena list	List arenas	minesweeper.admin
/ms reload	Reload config and messages	minesweeper.admin

Aliases: /minesweeper, /ms, /mines.

Hints

Hints cost points and add a time penalty. By default, using a hint makes the time ineligible for records.

• safe – opens a cell that is guaranteed to be safe
• peek – highlights a mine for a few seconds
• shield – the next mine you hit is flagged instead of ending the game

Rewards

Set console commands in config.yml, per difficulty or for new records. Variables: %player%, %difficulty%, %time%, %points%.

Placeholders

Requires PlaceholderAPI. Identifier: minesweeper

• %minesweeper_record_holder_easy% / %minesweeper_record_time_easy%
• %minesweeper_top_name_easy_1% / %minesweeper_top_time_easy_1%
• %minesweeper_pointstop_name_1% / %minesweeper_pointstop_value_1%
• %minesweeper_points%, %minesweeper_wins%, %minesweeper_losses%, %minesweeper_best_easy%

Requirements

Pick the file that matches your server:

• mc26.2 – Paper 26.2, Java 25
• mc1.20.5-1.21 – Paper 1.20.5 to 1.21.x, Java 21

PlaceholderAPI is optional.

Metrics

This plugin uses bStats to collect anonymous usage statistics (server version, number of arenas, whether PlaceholderAPI is installed). You can opt out for all plugins in plugins/bStats/config.yml.