Better Minesweeper - Documentation
Reference

Settings Reference

Ruleset Classes

Your current rule profile is shown at the bottom of the Game Settings tab. It is determined automatically from the settings you have enabled. Each profile tracks its own personal bests and leaderboards.

ProfilePBs TrackedHow to get it
Classic Time, 3BV/s, Efficiency, No-Flag time, No-Flag 3BV/s Default. No special settings enabled.
NG Classic Time, 3BV/s, Efficiency, No-Flag time, No-Flag 3BV/s Enable No-Guess Mode with everything else at default.
Custom Time, 3BV/s, Efficiency, No-Flag time, No-Flag 3BV/s Enable any class-breaking setting such as Drag to Reveal, Win on All Mines Flagged, Fast Reveal, Lock Cursor, Right Click Number to Flag Surrounding Tiles, or change First Click from default.
Recursive Efficiency only Enable Recursive Chording with everything else at default.
Recursive+ Efficiency only Recursive Chording + No-Guess Mode, or Recursive Chording + any class-breaking setting.
Other None Recursive Chording + any automation feature enabled. Runs are fully excluded from PBs.

The game provides two quick buttons in the Options footer:

  • Reset to Default / Classic — Disables No-Guess, Recursive Chording, and all class-breaking settings.
  • Set to NG Classic — Enables No-Guess Mode with everything else at default.
Mid-game rule changes disqualify the run. If you change a rule-affecting setting while a game is in progress, that run is marked as disqualified and excluded from personal bests and all-time stats.

Gameplay

These settings are grouped exactly as they appear in the Game Settings tab. Options indented below a setting are sub-options that only apply when the parent setting is enabled.

Safety

SettingDefaultDescription
First Click Safety Any Safe Tile Always Empty opens a flood-fill region. Any Safe Tile guarantees no mine but no flood guarantee. Off leaves the first click unprotected.

Controls

SettingDefaultDescription
Lock Cursor to Playable Area During Game Off Confines the mouse cursor to the board area during play. Press ESC to temporarily unlock until you click back on the board.
Fast Reveal (reveal on press) Off Reveals tiles immediately upon pressing them rather than upon releasing the reveal button.
Drag to Reveal Off Reveal tiles by dragging the cursor over them while holding the left button.
Flag Painting (drag to flag) Off Hold right-click and drag to place flags across multiple covered tiles at once.
Right Click Number to Flag Surrounding Tiles Off If the number of flagged tiles around a number matches the number of mines, right-clicking flags all surrounding tiles.

Rules

SettingDefaultDescription
Allow Question Marks Off Right-click cycles through Covered → Flag → ? → Covered. The ? state is visual only.
Win on All Mines Flagged Off Flagging every mine wins the game in addition to the standard reveal-all-safe condition.
Regenerate Boards Below PB 3BV Minimum Off Automatically skips boards that do not meet the minimum 3BV threshold for PB eligibility on the current difficulty.
No-Guess Mode Off The board is modified after your first click so it can be solved without probabilistic guessing.
No-Guess Generation Post-click (solve after first click) Post-click (solve after first click) solves after your first click. Pre-click (random start tile) picks a random tile before you click. Pre-click (set tile) uses the tile selected below.
Reveal on 2nd Click Off When enabled, the first click selects a start tile and the second click reveals it. Only applies to post-click No-Guess.
Pre-click Start Tile Center Which position is used for pre-click generation: Center, Top-left, Top-right, Bottom-left, or Bottom-right.
Recursive Chording (Flood Chord) Off When a tile is revealed via chording, automatically attempts to chord that newly revealed tile as well. Changes your rule class to Recursive or Recursive+.
Disable Flags Off Prevents flag placement entirely.
Force Lose on Flag Attempt Off When flags are disabled, any attempt to place a flag instantly ends the game in a loss.
Disable Chords Off Prevents chord actions regardless of other input settings.
Auto Restart on Loss Off Automatically starts a new board after you lose.
If Board Completion is Under 25% Minimum board completion percentage required before auto-restart will trigger. Only applies when Auto Restart on Loss is enabled.

Automation

Assisted run: These options interfere with ranking and are not applied during daily runs. Enabling any automation feature marks the run as assisted and excludes it from personal bests and all-time stats. If Recursive Chording is also enabled, the rule class becomes Other and no PBs are tracked.
SettingDefaultDescription
Auto Chord On Tile Reveal Off Automatically chords the number underneath a tile when a tile is revealed.
Auto Chord On Flag Placement Off Automatically chords numbers adjacent to a flag when it is placed.
Auto-Flag Isolated Mines Off Automatically flags covered tiles that have no adjacent uncovered tile within a set radius.

Replay

SettingDefaultDescription
Record Replays On Capture game inputs for replay playback and optional saving to the replay library. Disabling skips all recording.
Auto Save to Library All games Which completed games are permanently saved. Never save keeps temporary replays only. Wins only. PBs only saves games that set a time or 3BV/s personal best. All games.
Show Replay at Game End On Automatically opens the replay player after a game ends, even for temporary replays.
Hide Replay Controls When Not In Use Off Hides the embedded replay controls strip outside of replay mode. Leave unchecked to keep the disabled controls strip visible during normal play.
Record Mouse Trace Off Stores a compressed cursor path in replays for higher-fidelity playback and review. Increases file size.
Trace Distance (px) 8 Minimum pixel movement before a new mouse trace point is recorded.
Trace Time (ms) 16 Maximum time between recorded mouse trace points.

Input & Hotkeys

Configure key and mouse bindings in the Inputs and Hotkeys tab. Double-click a binding to change it. Use Capture Mouse/Wheel to bind mouse buttons or scroll actions.

  • Inputs: Reveal, Flag, Chord, Restart
  • Replay: Play/Pause, Step Back/Forward, To Start/End, Copy Seed
  • Hotkeys: Stats window, Settings, Probability overlay, and more

The chord binding also supports a Classic L+R chord mode: when editing the chord hotkey, check the box to trigger chords by holding right-click and clicking left.