Better Minesweeper - Documentation
Reference

Changelog

v0.6.0

Featured Changes

  • Custom difficulty changes:
    • Pressing Ctrl+V autofills the text box if there is a valid seed in your clipboard.
    • You are now allowed to make the board as large as your screen can physically fit.
  • Added the ability to make stats change color conditionally.

Small Changes

  • NF runs are now able to be searched for in replay library.
  • Probability overlay now highlights guess flags and shows off-edge tiles when minecount makes them certain to be safe.
  • Stats can now be made smaller and you can now scroll through long lists of stats.
  • Changed Appearance Tab.

Bug Fixes

  • NF, Eff, Gamemode, and Custom PB's now effectively autosave to Replay Library.
  • Question marks no longer require you to lose a game to toggle or count as effective clicks.
  • Custom difficulty dialog no longer autotypes for you when typing in the textbox.
  • Custom board mine density is no longer white text on white background.

v0.5.12

Emergency Patch

  • Attempting to back-up and secure any stats/data so that it's not lost, migrating from Beta to Early Access on Steam.

Featured Changes

  • Overhauled the Custom Stat system now with over 100+ tracked variables to work from.
  • Added Llama's 100-Chain Zini.
  • Added the ability to track PB on any existing or custom stat using Custom PBs.
    • You're also able to do stuff like add predefined custom PB's that self-delete upon passing.

Smaller Changes

  • Smarter tileset rescaling to minimize distortion when resizing board for custom skins.
  • The display counter now will display show negative mines if more flags are placed than mines on the board.
  • Completely overhauled Flag Only game mode.
  • Polished options menu and gave tooltips clearer explanations.
  • Lightened Mine background on dark tileset to make them easier to see.
  • There's a disable scaling by dragging toggle that doesn't work yet but it's there.
  • Some stuff in the Main Hub is now hidden until finished.

Bugfixes

  • Fixed bug between uploading to minesweep.ing and highlight non-chorded flags option.
  • Fixed finding 7 or 8 sometimes not triggering achievement.
  • Fixed ability to change rule class mid game.
  • Auto-Flag isolated mines is no longer as slow as it was.
  • Improved replay compatibility with various game modes.
  • Main Hub can no longer open above your window view.
  • Fixed replay player needing to be restarted twice to fully exit.
  • Fixed bug causing lag on end of game before flagging all unflagged mines.
  • Fixed not being able to enable stats opening on game open while dialog is closed.

v0.5.11

Featured Changes

  • Made massive improvements to replay sharing via link.
    • Cleaner stats and options, polished UI, probability overlay + more.
    • Game also uploads steam display name to the website, this is temporary.
  • Recursive (classic) and Recursive+ (custom) ruleset classes, PBs and leaderboards added.
  • Live probability overlay support added to replays.

Minor Changes

  • Expanded on the Hint system.
  • Cleaned up options menu UI and made tooltips easier to understand.
  • Polished Main Hub UI.
  • Auto settings now set ruleset to Other.
  • Changed Stat Dialog buttons.

Bugfixes

  • Recursive chording works again.
  • Fixed typo in Options Dialog.

v0.5.10

Featured Changes

  • Added working Zini (G.Zini), H.Zini, and 8-Way (G.) Zini.
  • Added a smart hint system. STILL UNDER DEVELOPMENT

Replay

  • Added the ability to play games from certain points in the replays.
  • Added save replay to player dropdown.
  • Replay search now supports: ioe, ios, rqp, corr, throughput, ces, cl, ce, path, mov, iome, sao, qg, stnb.

Minor Changes

  • Always on Top options for main game window and stats dialog.
  • Experimental Hub is now Main Hub, and options open within the Main Hub now.
  • Tab now opens the Main Hub and Options hotkey is now O by default.
  • Text input boxes now ignore wheel events, so scrolling over them keeps scrolling the Options page instead of changing the values.
  • Fixed Isis and Ops stats.
  • Debug Console is removed.
  • Ruleset Classes are now Classic by default, and the reset to default now resets options back to Classic.
  • Ruleset Class is now made more clear within options menu and in stats dialog.
  • Minor UI polish in Main Hub.

Bugfixes

  • Replay menu no longer restarts game if you click on an area without buttons on it.
  • Fixed the daily-run leak into normal PB eligible runs.
  • Reveals are significantly faster due to the removal of a bug that was especially noticeable in large opens.
  • No longer gives you a warning when using probability calc in replays.
  • Fixed bug that glitched the game if the player restarts while holding a tile down before game starts.

v0.5.9

Changes

  • Replay library now handles large volumes of replays more efficiently.
  • Avg stats now show how much they changed at end of run.

Bugfixes

  • Going from chord to reveal works now.
  • Input latency optimized.
  • Various Custom 3BV gamemode bugfixes made.

v0.5.8

Features

  • New Gamemode: Custom 3BV.
  • Option to hide the outer border tiles.
  • New Stats:
    • Mastery
    • Avg Time (last 100 wins)
    • Avg 3BV/s (last 100 wins)
  • New replay control hotkeys.

Changes

  • PB stats now reflect setting class.
  • PB's and leaderboards now have minimum 3BV to qualify.
    • Beg = 2
    • Int = 30
    • Exp = 100
  • Replay controls are now persistent by default.
  • New replay controls.
  • Added embed to the replay uploads.
  • Uploaded links now last 90 days.
  • You can now use hotkeys on the stat menus.
  • Replay steps now show effective clicks only.

Bugfixes

  • L+R Chord now triggers on release of r first as well.
  • Fixed issue with L+R chord in replays.
  • You can once again flag before a game has started.
  • Painting flags is a lot smoother in replays now.

v0.5.6–v0.5.7

Emergency patches pushed to fix a crash introduced in v0.5.5.

v0.5.5

Features

  • This update mainly focused on optimization for speed and performance.
  • New experimental all-encompassing menu, acting as a hub to house various dialogs.
  • A way to import custom skins.
  • Classic, NG Classic, and Custom stat classes.
  • Game modes now have PB's.
  • You can now paint on the board from inside the game to plan efficiency.
  • You can now add replay directories in the library for other games. UNFINISHED
  • New game mode: Flags Only.
  • You can import replays again.
  • Added completion threshold for auto-restart.

Steam Exclusives

  • Steam users now have access to uploading replays for easy replay sharing via link.
  • 8 new achievements.
  • Steam Cloud now supported. (But won't activate until game is approved by Valve)
  • Many new leaderboards.

Game Rules

  • Daily run now uses UTC, midnight, instead of local time.
  • Removed 8x8 beginner.

UI

  • Improved mouse tracking in replays.
  • Added simulated mouse tracking when path tracking is off.
  • Added an option to highlight flags that weren't used to chord.
  • Changed ASCII board formatting.
  • Added option for openings not to reveal flags.
  • Aim Trainer:
    • No longer allows a tile to be chosen consecutively.
    • Now lets you change difficulty from the game menu.
    • Has two squares at once instead of one.
    • Timed is now 45 seconds.
  • When sorting by 3bvs/eff/time in replay library, wins are shown first.
  • Added SVG support for more skins than just dark.
  • Added new colored circle appearance.
  • Added replay support to select game modes.
  • Fixed graphs in dev console.

Bug Fixes

  • Fixed flagging numbers not working.
  • Fixed incompatibility with drag to flag and no guess.
  • Aim Trainer's smiley button no longer drifts when changing tile size via options menu.
  • You can now right-click on the header displays again.
  • Game mode options no longer leak into the user's main game options.
  • Fixed colored circle appearance being off center.
  • Game no longer flashes out when restarting from replay.
  • Replays now account for auto-options.
  • Fixed probability overlay flashing out upon revealing a tile.
  • Fixed game flickering upon startup.
  • Fixed bug that caused replays to lose prematurely.
  • Added a replay stats view that shows how metrics like 3BV/s and efficiency change throughout a run.
  • *Added in-depth career stat tracking and progression over time.
  • Added a Shop.
    • Includes packs, skins, custom flags, custom numbers, and custom smileys.
  • Added a custom skin creator.
  • Added Stat Time Until First Move

v0.5.1-4

Steam Leaderboards

Added Steam Leaderboards for:

  • [Difficulty] 3BV/s PB
  • [Difficulty] Time PB
  • Highest Level

Achievements

  • Working now.

Bugfixes

  • Reenabled the ability to earn XP.
  • Stats dialog no longer flashes upon restarting game on loss.

v0.5.0

Game Changes

  • Overhauled input system for entire game. (probably the biggest change this update)
  • No Guess generation is now even faster and more accurate.
  • Added a new XP and Coin system. [EXPERIMENTAL]
    • Daily Run streaks now increase your XP and Coin multiplier.
    • Each consecutive day adds +0.2 to the multiplier, up to a maximum of 4x.
  • Added Efficiency PB tracking by difficulty.
  • Added cursor tracking for replays. [UNFINISHED]
  • Added option tracking for each replay, including in the replay library.
  • You can now open the board in other website such as LlamaSweeper by right clicking the stats window.
  • Replay buttons now scale down, and menu bar collapses for small windows.
  • Restart hotkey now shows smiley button being pressed when holding. [UNFINISHED]
  • Added L+R Chording support.
  • Added No Flag PB's.
  • Fast Reveal now allows failed chords to show highlight, only skipping highlight on successful chords.

New Stats Added

  • g.ZiNi, h.ZiNi, Ce, IoME, ZNT, ZNE

Options / Settings

  • Added a setting to restart by clicking either the entire top bar or only the restart button.
  • Added an option to instantly restart after losing a game.

Bug Fixes

  • Fixed a visual issue with the number display.
  • Fixed text color issues when switching to Classic (Light) Appearance.
  • Fixed an issue where Daily Run replays were not showing the correct relative information.
  • Streak PB pop-ups now appear correctly when enabled.
  • Replays now properly start recording AFTER a game has started and now upon resetting.
  • No Guess solver no longer flags guesses on mines in obscured clusters as safe.
  • No Guess failure doesn't lag before regen now.
  • Replay library now allows for columns to be modified.
  • Fixed path stat accuracy.
  • Fixed bug that could cause the last tile on Last Tile Remaining to be a tile adjacent to an opening.
  • Fixed question mark support in replays.
  • Fixed incompatibility between drag to reveal and no guess.

v0.4.6

Changes

  • You can now click anywhere on the header to restart/click the smiley button.
  • Space and F now work for input options.
  • You can now click/hold the timeline bar to scrub through a replay instead of having to hold the slider.
  • Clearing flagged zeros via flood now clears the flagged tile.
  • There's now an indicator for what column is selected in the replay library.
  • Removed option to set board to 16px from menu manager.

v0.4.5

Continued Polish

Changes

  • The way UI is done has been optimized for a big speed/performance boost.
  • Made a ton of logic/processing changes for optimization purposes.
  • We're now being smarter about the SVG Smiley and how it's loaded to work on slower PC's.
  • Added custom stats.
  • Improved handling/functionality of settings and the options menu.
  • Made keyboard controls work better.
  • Reduced size of game by 41% (Oops)
  • Replays now show stat differences on PB stats.
  • Default chord is now both mid and left mouse button.
  • We might have a steam achievement? Idk it's a little confusing to add them so maybe I did it right.

v0.4.4 Patch

  • Improved hotkey functionality.
  • All-time stats save now when show replay on game end is enabled.
  • Improved stat dialog window following.
  • Changed STNB formula, and eff measurement on losses.

v0.4.3

The Polish Update

New Features

  • New No-Guess Settings: Pre-Click guess resolving is now an option, and more!
  • New Game Mode Menu: Aim Trainer and Russian Roulette are back! And now with a new addition to the family. This opens the door to adding new game modes as well.
  • SVG Smiley Buttons: The smiley button no longer suffers upon scaling. Finally.

UI

  • Hotkeys tab is now Inputs & Hotkeys. Input options such as keyboard/mouse options are now housed there.
    • This allows inputs such as middle mouse button to restart.
    • Extra mouse buttons (ex. Mouse 4/5) are now supported inputs.
  • Added mouse button/scroll functionality to the Inputs & Hotkeys tab.
  • New option to restore options to default settings.
  • Improved Replay Library.
  • Daily Run now loads replay upon returning to played games.

Bug Fixes

  • Game is now immediately playable restarting from a replay.
  • Daily run no longer changes to a custom game upon restarting.
  • You can now switch difficulties from the daily run.
  • Fixed the PB difference from not showing up in the stat window.
  • Fixed drag to reveal functionality.
  • Fixed short freeze first time running no guess upon restarting the game.
  • Improved replay handling. (autosaving and empty saves in library)
  • Hardened exit to try to make sure the game closes fully (Something is breaking the Itch.io launcher)
  • Scrolling in the options menu no longer changes your settings while scrolling over them.
  • Right Click Numbers to Flag is now functional again and doesn't bring up a drop menu.
  • Right click number flags now show up in replays.

Optimizations

  • Brute force enumeration now calculates isolated clusters to prune certain mines/safes before full board enumeration on complex boards. In theory this will give a more accurate no guess and preserve more complex scenarios. We're trying it out.
  • The probability calculator is now more efficient about off-edge tiles.

Patch Update 0.4.2

  • Fixed typo causing crash on start in code. :)

Patch Update 0.4.1

  • Updated Daily Run database with new seeds that can be solved logically.
  • Removed cluster highlight debug key stopping C from being used as a hotkey.
  • Added a handful of new stats.

v0.4

Featured Changes

  • New Replay System! Watch back, share, and save your games.
  • Replay Library Watch back, share, and save your games.
  • No-Guess Mode Improvements No Guess is nearly finished, with a 0/20,000 Expert failure rate.
  • New Daily Run Seeds Seeds are now pre-defined so no more no-guess solver required.

v0.3.2

New Features

  • No-Guess Mode (Beta) Early implementation. Further changes planned.
  • Dark Mode With dark UI for Win 10. (On by default.)
  • Daily Runs re-enabled and now with No Guess.
  • Cursor Lock Lock cursor to game board during play.
  • Continuous Chording (Flood Chord) Similar behavior to Meowsweeper choring.

Stats

  • Abandoned run time is now included in all-time stats.

UI

  • Reorganized top menu bar
  • Dark mode compatibility for Windows 10 (UI)
  • Added Menu/Dialog Style toggle (Fancy vs Fast) to improve UI performance.
  • New hotkeys to reload current seed and to copy gameboard to clipboard as a jpeg.
  • Removed some stuff from distribution build to make it less bloated.
  • Improved Daily Run stat dialog UI.
  • Added zoom hotkeys.
  • Probability overlay now shows misflags.

Bug Fixes

  • Improved probability overlay accuracy (mines vs tiles remaining)
  • Fixed scaling issues triggered by certain settings combinations.
  • Fixed scaling getting locked and padding issue around game board while
  • Fixed some memory leaks.
  • Game no longer freezes if you close it mid-game.
  • Fixed issue with gamemode stats overlapping in stats dialog.
  • Fixed issue with numbers drawing over tileset in certain appearance modes.
  • User false flags no longer poison probability overlay.

v0.3.1

Features

  • Added a real-time probability calculator. [beta]
  • Added Disable Flagging in settings.
  • Added Disable Chording in settings.
  • Added ability to disable colored text in dialog boxes.
  • Made settings in option menu persistant across different versions.
  • Temporarily disabled Daily Runs. (I'm in the middle of adding stuff to it.)

Aim-Trainer Changes

  • Fixed display number UI bug.
  • Fixed keyboard as mouse functionality.
  • Smiley now resets run.
  • Smiley is more tolerant of multiple rounds being played.
  • Fixed Smiley getting thrown off center when setting to 16x pixels from top menu bar.
  • When switching to aim trainer mode mid game the timer stops now.
  • Improved timer accuracy.
  • Fixed stats flickering upon target click.
  • Improved UI for the game mode's dialog boxes.
  • Flawless Mode is now Endless Mode
  • Target borders are now isolated to their tile.
  • Targets will no longer appear on the same tile consecutively.
  • Improved timer display functionality.

UI

  • Made it congradulate you on your first win rather than saying new pb.
  • Improved seed handling on daily runs.
  • Added the difference between old best and new PW in notification.
  • It now shows the difference between the current run and PB in the stat window when those stats are enabled.
  • It will now show in stat window if not playing on classic mode.

BugFixes

  • Keyboard as Mouse can click the smiley button without crashing the board renderer.
  • There's now a dedicated mod folder that actually loads the mods inside of it.
  • Game no longer shrinks upon closing and opening game on 1600p monitors.
  • Middle mouse chording no longer fails to highlight tiles around it.
  • Stats/PBs no longer stay disabled on subsequent games after a game where they are paused.
  • Fixed loophole allowing users to get pbs while auto-features were enabled.
  • Fixed SQLite storage location and added automatic migration of old stats. (All-time stats no longer clear randomly)

v0.3.0 — The Stats Update

Features

  • Removed hotkey for running the solver, now it's only included in debug mode.
  • Removed some files from the game files, and hid them in the exe.
  • Added tons of all-time stats and all-time stat tracking.
  • Improved daily run system:
    • Added daily run play streaks and added it to the stat window.
    • Make it so that it only counts daily run as initiated once the first move is made.
    • Made it so that automation settings are not applied during daily runs.
    • Now if you open a daily run and don't start it until the day rolls over, it doesn't lock you out of it the next day.
  • Improved & Expanded Per-Game Stats:
    • Added a current win streak (per difficulty) stat.
    • Added PB stats for the stat window. (Time and 3BV/s)
    • Changed the default stats to also be moved around and togglable as well as the default group.
    • You may now press the delete key when a stat is selected or right click the stat to unselect it.
    • Added the ability to right click the stats dialog window to copy the stats from the window, or from presets.
    • You can now right click the stats dialog window to change stat layout presets live.
    • Added the game's seed to the stat window.
    • The stat "Cl" is now functional. (Clicks per second)
    • There is now a "Default" preset.
  • Added pop-ups to notify you when you've hit a PB (Time, Streak, and 3BV)
  • The game is now infinitely scalable for large screens, like 8K screens. Still does not exceed size of screen.

BugFixes

  • Fixed stat option checkboxes taking double click to enable/disable.
  • Made progress on a bug where you need to wait a full second before enabling/disabling stats.
  • Fixed the empty group label appearing when a group is in fact not empty.
  • Moving a stat into a created group directly from above now updates in the stat dialog window without resetting the game.
  • Stat presets now actually work.

UI

  • Removed custom range for auto-flag isolated tiles.
  • Removed a container from stats window.
  • Removed checkboxes and multi-select functionality from stat categories.
  • Removed placeholder game modes.
  • Changed Daily "Challenge" to Daily Run.
  • Added a button to the stats window that allows you to add groups to make it more intuitive than right clicking.
  • Reorganized the Options tab UI and Seperated the Display section into it's own tab.
  • Added display (bomb counter/timer) options to options menu.
  • You can now set specific game scales from the Display tab.
  • Added two smiley easter eggs.
  • Made it so that when opening the Custom difficulty dialogue it automatically inputs your current difficulty's values.
  • The Stats dialog window now shrinks to it's minimum size upon game reset. This adjusts for the blank space left by Est R Time.