Better Minesweeper Docs
Customization

Settings Reference

All settings apply instantly and save automatically. Open via Extras > Settings.

Input & Controls

SettingDefaultDescription
Left-click chordOnClick a satisfied number (flag count = number) to reveal its remaining covered neighbors.
Middle-click chordOnMiddle-click a number to chord.
Left+right chordOffRequire the right button held while left-clicking to activate a chord.
Auto-chord on numberOffAutomatically chord when you click a satisfied number, without needing to hold or release deliberately.
Auto-chord on flagOffWhen placing a flag that satisfies a neighboring number, that number chords automatically.
Continuous chord dragOffKeep chording as you drag across satisfied numbers while holding the mouse button.
Classic click behaviorOnA tile activates on button release (standard). Off = activates on press.
Fast reveal previewOffHighlight which tiles will be revealed before you release the click.
Drag revealOffReveal tiles by dragging the cursor over them while holding the left button.
Drag to paint flagsOffHold right-click and drag to place flags across multiple covered tiles at once.
Keyboard as mouseOffUse arrow keys to move the cursor; Enter to left-click, Shift+Enter to right-click. See the Controls page.
Lock cursor to boardOffConfine the mouse cursor to the board area during play.

Gameplay

SettingDefaultDescription
First click guaranteeAlways EmptyWhat the first click promises. Always Empty — opens a flood-fill region (no mine, no numbered tile). Safe — no mine but no flood guarantee. Off — first click is unprotected.
No-Guess modeOffThe board is generated or modified so it is fully solvable without probabilistic guessing. See Game Modes.
No-Guess: when to solvePost-clickPost-click — solving happens after your first click. Pre-click (random) — a random tile is pre-selected; board is ready before you click. Pre-click (fixed tile) — uses the tile position set below.
No-Guess: pre-click tileCenterWhich position is used for pre-click generation: Center, Top-left, Top-right, Bottom-left, or Bottom-right.
No-Guess: reveal ruleAlways revealPost-click only. Always reveal — first click reveals immediately. Require confirm — first click selects a tile; a second click reveals it.
Question marksOffRight-click cycles through Covered → Flag → ? → Covered. The ? state is visual only.
Flag-winOffFlagging all mines wins the game, in addition to the standard reveal-all-safe condition.
Disable flagsOffPrevent flag placement entirely.
Disable chordsOffPrevent chord actions regardless of other input settings.
Surprised faceOffShow the surprised smiley expression while a tile is being clicked.
Flag all on winOnAutomatically flag remaining un-flagged mines when the board is solved.
Classic Beginner (8×8)OffUse an 8×8 Beginner board (original Windows sizing) instead of the standard 9×9.

Display

SettingDefaultDescription
Display modeClassicHow tiles are rendered. Classic — standard numbered tiles. Random Colors — each tile gets a random color. Random Letters — numbers replaced with random letters. Colored Circles — circular tile shapes.
SkinDarkActive skin. Built-in options: default, dark. Custom skins use their folder name.
UI styleFancyFancy — gradient and shadow rendering effects. Fast — flat rendering for better performance on slower hardware.
Smiley renderingSVGUse SVG-based smiley faces (sharper at any size). If disabled, falls back to raster sprites.
Number renderingTextRender mine-count numbers as scalable text. If disabled, numbers are drawn from the tileset sprite sheet.
Custom number colorsOnUse the game’s color scheme for numbers (1=blue, 2=green, etc.). Off = system default colors.
Auto-show probability overlayOffEnable the probability overlay automatically at the start of each game. See Probability Overlay.
Classic scaleOffUse fixed tile sizes instead of dynamically scaling with the window.
Lock classic scaleOffLock the tile size when classic scale is active, preventing resize.

Counters & Header

SettingDefaultDescription
Left counter: displayMine countWhat the left header counter shows. Mine count — mines remaining (total mines minus flags placed). Safe tiles — unrevealed safe tiles remaining.
Left counter: at zeroHideWhen the count reaches zero, hide the counter or show 0.
Show left counterOnDisplay the left counter in the header.
Timer: at zeroHideBefore a game starts, hide the timer or show 0.
Show timerOnDisplay the right counter (timer) in the header.
Timer starts at0Starting value for the timer display. Set to 1 to match classic Windows Minesweeper behavior.

Stats

SettingDefaultDescription
Open stats on launchOnShow the stats window automatically when the game starts.
Stats window follows gameOnThe stats window repositions automatically when the game window is moved.
Persist all-time statsOnStore all-time stats in a SQLite database. Off = in-memory only; stats reset when the game closes.
PB popupsOnShow a notification when a personal best is broken.
PB popup: best timeOnShow popup for a new fastest win time.
PB popup: best 3BV/sOnShow popup for a new best 3BV/s.
PB popup: win streakOnShow popup for a new win streak record.
Pause stat recordingOffSuspend all-time stat recording without clearing history. Useful for practice sessions.

Automation

SettingDefaultDescription
Auto-flag satisfied numbersOffWhen a number’s remaining covered count equals its mine count, automatically flag all those neighbors.
Auto-flag isolated minesOffAutomatically flag covered tiles that have no adjacent uncovered tile within a set radius.
Isolation radius2Tile radius used for isolated mine detection.
Assisted run: Enabling any automation feature marks the run as assisted. Assisted runs are excluded from personal best records and all-time stats.

Replays

SettingDefaultDescription
Record replaysOnCapture game inputs for replay and playback. Disabling skips all recording.
Auto-save to libraryAll gamesWhich completed games are permanently saved to the replay library. Never — temporary only (playable, not kept). Wins only. PBs only — games that set a time or 3BV/s personal best. All games.
Show replay after gameOnAutomatically open the replay player when a game ends.
Record cursor pathOffCapture mouse movement between clicks. Enables cursor path playback but increases file size.
Record highlightsOffCapture hint and cluster highlight state changes in the replay.
Auto-exportOffAutomatically export replays to a .bmrp file after each game.
Exclude cursor from exportsOnStrip mouse path data from exported .bmrp files (keeps exports smaller and privacy-safe for sharing).
Library date formatYYYY-MM-DD HH:MMDate format string used in the replay library columns.

Data Storage

Settings are saved as JSON automatically after every change.

PlatformPath
Windows%LOCALAPPDATA%\BetterMinesweeper\user_settings.json
Linux~/.config/BetterMinesweeper/user_settings.json

On first run, settings are automatically migrated from the game directory to the platform-specific path above.