github r0fld4nc3/Stellaris-Exe-Checksum-Patcher v3.0.0.rev1

one hour ago

Downloads

Download Notes
Windows Nuitka Downloads Recommended.
Windows PyInstaller Downloads Try if antivirus flagged Nuitka build.
Linux Nuitka Downloads
macOS Nuitka Downloads Extract .zip to reveal .app. Can still patch the Windows and Linux versions.

Highlights

  • Automatic patching. The Patcher now finds the game's checksum checks by itself, straight from the game executable. Game updates should no longer break patching or mean waiting for new patterns.
  • GOG support. Stellaris bought on GOG can now be found, launched and verified through GOG Galaxy on Windows and macOS.
  • Stellaris 4.5.x support.
  • Patch any platform from any platform. The Patcher detects whether the executable is for Windows or Linux and applies the right patch, whatever system you're on. For example, you can patch the Linux executable from macOS.
  • Improved Options window, split into Game Utilities and General Utilities, with new tools for cleaning up backups.
  • Revamped Fix Save. The Patcher now reads your save first and shows what it contains (Ironman, cheated flag, achievements), so you can pick exactly the fixes you need.
  • Shift-click to choose paths yourself. Hold Shift when clicking Patch to pick the game executable, or Show Save Games Folder to pick the save games folder, instead of using the ones found automatically.

What's New

Patching

  • Checksum, Warning and Tooltip can be picked separately in Game Utilities:
    • Checksum is always applied. It enables achievements and stops the crash reporter from flagging the game as modified.
    • Warning hides the yellow version text.
    • Tooltip shows the normal checksum tooltip instead of the modified-checksum one.
    • All three are ticked by default. Untick Warning or Tooltip to keep that reminder that the game is modified.
  • Each patch shows a short description next to its checkbox.
  • Patches already in the executable stay applied, and others can be added by patching again with a new selection.
  • To remove one or more patches from an executable that's already patched, restore the original executable (from a backup or with Validate Integrity of Game Files) and patch again.
  • On startup, the Patcher says which patches are already applied to the game.
  • A progress bar shows the current step while patching.
  • Shift-click the Patch button to choose the game executable yourself, skipping the saved and automatically found locations.
  • Shift-click the Launch button to switch back to Patch and patch again.
  • Patching is faster: only the bytes that change are written to the executable.
  • Patches now get their details from a new configuration file, patterns-v2.json. Older versions of the Patcher keep using the previous file and work as before.
  • Patch choices saved by older versions that don't exist any more are ignored. The required Checksum patch is always applied.
  • Patching the macOS version of the game isn't supported yet, as no patches are available for it. Windows and Linux executables can still be patched from macOS.

Game Stores: Steam, GOG and Generic

Each game now has a store setting in Game Utilities (next to the game and version), saved per game:

  • Steam and GOG: the Patcher finds, launches and validates the game through that store.
  • Generic: for games installed anywhere else, or started with another app.

The store only changes where the Patcher looks for the game and how it launches and validates it, not how it's patched.

  • The first time a game's executable is patched, the Patcher asks which store it comes from. Existing users will also see this once. You can change it later in Game Utilities.
  • Changing the store makes the Patcher look for the game again. Switching back restores the previous location until the Patcher is closed.
  • A new Launchers section in General Utilities holds the Steam and GOG Galaxy folders and a Generic Runner. Pick each with Browse... and clear it with X. Steam and GOG Galaxy are found automatically when left empty.
  • Generic games can be launched with any app that runs games, such as Wine, Heroic or Lutris. Set it as the Generic Runner and enter its Runner Arguments: {binary} becomes the game executable and {folder} its folder. Leave arguments empty to pass only the executable.
  • Runner Arguments shows an example of what to type, and a box below it explains the placeholders and lists example settings for common runners: Wine, umu-run, Heroic, Lutris and CrossOver. You can select and copy them. Runners like Heroic and Lutris start their own install of the game rather than the patched file, so make sure they point to the install you patched.
  • The Launch button starts the game through its store (Steam, GOG Galaxy or the Generic Runner), and the tooltip says which. Launching from the Patcher is optional: you can always start the game as usual.
  • Validate Integrity of Game Files follows the game's store. Steam works as before. For GOG, the game opens in GOG Galaxy and you must use Verify / Repair there. It's unavailable for Generic games.
  • GOG Galaxy isn't available on Linux yet (it's confirmed to be coming), so use Generic there for now.

Options Window

  • Now split into two tabs:
    • Game Utilities: everything for a specific game, such as choosing the game, version and patches, showing its game and save folders, and validating its files.
    • General Utilities: settings for the Patcher itself.
  • The selected game is shared between tabs, so the dropdowns always stay in sync. Switching game resets the selected version and patches.
  • Changes apply as you make them. Press OK to keep them, or Cancel to undo them.
  • Your patch selection is saved when you press OK, and shown again next time, even before patching.
  • Show Save Games Folder (new) and Show Game Folder now sit side by side. The save folder is found automatically and remembered for next time.
  • When asked to pick the game executable, the file picker opens in the last known location.
  • When more than one save games folder is found, Show Save Games Folder asks which one you use and remembers your choice.
  • Shift-click Show Save Games Folder to choose the folder yourself, for example when your saves are somewhere the Patcher doesn't look. Your choice is remembered, and also used by Fix Save.
  • The X next to Show Save Games Folder clears the remembered folder, so the Patcher looks for it again next time.
  • Checkboxes in General Utilities and the store choices match the Patcher's look.
  • Update Patterns is greyed out for a short while after the patterns were last checked, since it can't download them again any sooner.

Backups and Saves

  • Delete Backups (Game Utilities) finds the backups of the game executable made when patching, shows how many there are and how much space they take, then deletes them. Other files in the game folder are left alone.
  • Manage Save Backups (General Utilities) lists the save backups made by Fix Save, grouped by playthrough and newest first, so you can choose what to keep. Keep Newest Only selects everything except the latest backup of each playthrough.
  • Fix Save now opens in your save games folder. When more than one is found, it asks which one you use, and remembers the choice for Show Save Games Folder.
  • Fix Save now reads the save first and shows what it contains: name, date and game version, Ironman, the cheated flag and whether the achievements list is complete. Values that a fix can change are highlighted, with a short explanation. You then tick only the fixes you want.
  • Next to each fix, Fix Save says whether it would change the save or is already done. Update Achievements is ticked for you when the list needs updating; the other fixes are always your choice.
  • Convert to Ironman and Force Convert to Ironman are now one fix: Convert to Ironman also adds the Ironman setting when the save doesn't have it.
  • When the picked fixes wouldn't change anything, the save is left untouched and no backup is made. Afterwards, a summary lists what each fix changed.
  • If the save changes on disk while you're choosing fixes (for example, the game autosaved), Fix Save stops and asks you to pick it again instead of overwriting the newer save.

Help and Guides

  • The ? button now opens a proper Quick Tips & FAQs window, rewritten for automatic patching. It covers what to do after a game update, already-patched games, changing or removing patches, games that can't be found, Proton, Fix Save and backups.
  • The welcome guide has been updated to explain the new patching, the options window tabs, the progress bar, the Launch button and Manage Save Backups, and now refers to the current version.
  • The welcome guide, FAQ and options window size themselves to the main window and open centred over it.
  • The welcome guide and FAQ match the main window's look: drag them anywhere to move them, and resize them from their edges.
  • The welcome guide now has the same layout and colours as the FAQ and the startup message.
  • The welcome guide opens again whenever it's updated, until you click Understood, so you won't miss what's changed. Show Welcome Dialog in General Utilities opens it any time. If you had already dismissed it, you'll see the new guide once.
  • The Patcher can show a short message at startup for important news. Each message is only shown once. Show Information Message in General Utilities checks for a newer message, then shows it again.
  • The welcome guide and FAQ now explain the store choice, and how to validate game files for each store: Steam repairs the game itself, GOG uses Verify / Repair in GOG Galaxy, and Generic uses your launcher's own option.

Updates

  • A new checkbox in General Utilities lets you opt in to pre-releases as updates. Otherwise they're no longer offered.
  • Re-releases of the same version are now recognised as updates. The title bar version includes the revision (e.g. v3.0.0.rev1).
  • The Patcher always uses its own built-in version number, and update checks always respect the check interval.
  • Update checking and version comparisons are more reliable.

Command Line

  • New --prevent-save-write (-psw) option stops the Patcher from saving its settings to disk. Useful for testing, or on systems that block writing settings.

Fixes

Patching
  • The Patcher no longer always reports the game as not patched on startup.
  • Patching no longer reports success when no patches were available for the selected platform.
  • The Patch button no longer switches to Launch Game when patching failed.
  • Fixed a crash when pressing Patch while the Patcher was still checking whether the game was already patched.
  • Fixed rare glitches or crashes after patching, caused by the Patch button being updated from a background task.
  • The Patcher no longer hangs or fails to close while background tasks are running. Closing now stops them first and waits for patching to finish, so the executable isn't left half-written.
Backups
  • Backups of one file are no longer deleted to make room for backups of another file in the same folder. Each file now keeps its own backup limit.
  • On macOS, old backups of the Windows executable are now deleted, instead of building up past the backup limit.
Fix Save
  • Clean saves are no longer reported as cheated when the cheated-save fix is turned off.
  • Ironman conversion now changes the game state itself, not just the save's metadata.
  • Ironman-only or cheated-only repairs no longer fail when the achievements file can't be loaded. It's now only loaded when updating achievements.
  • Fixed Convert to Regular Save and Convert to Ironman damaging saves whose game settings had no Ironman line.
  • An achievements list placed in the wrong part of the save is now moved to where the game reads it, instead of being updated where it was.
Launching, validating and folders
  • Validate Integrity of Game Files no longer removes the game executable when the Steam App ID can't be determined. Nothing is touched unless Steam can restore it.
  • Validate Integrity of Game Files now uses the right install path when patching the Windows executable through Proton.
  • Launch on Windows now starts Steam instead of opening the Steam folder.
  • Folder buttons now open the folder instead of only highlighting it in the file manager.
  • On macOS, Show Game Folder now opens the right folder when the Windows executable is used through Proton.
  • Fixed errors reading a Steam library on an external drive on macOS.
  • Fixed a crash on macOS when the game couldn't be located automatically.
Options window and interface
  • Fixed a crash caused by one of the buttons in the options window.
  • The Proton selection is no longer kept after cancelling the options window.
  • The previously chosen platform is restored when reopening the options window.
  • Long game names no longer stretch the game dropdown and shift the widgets next to it.
  • Disabled controls now reliably get (and lose) their greyed-out look.
  • Message box text, including Show Details, is now white instead of hard-to-read dark text.
  • Headings in the welcome guide and save disclaimer are no longer smaller than the text below them.
Startup, updates and settings
  • Fixed a possible freeze on startup right after updating, when the patch configuration file hadn't been downloaded yet.
  • Fixed the main window's buttons staying greyed out when loading the patch configuration failed at startup.
  • Settings are no longer sometimes saved with an empty game name.
  • Fixed the Patcher still showing an update as available right after updating.

Technical Changes

Technical and build changes
  • Updated to Python 3.14 and newer dependencies, including security fixes, and Nuitka 4.3.5 to support it.
  • Building from source needs uv 0.9.17 or newer, and skips package versions published in the last 7 days.
  • Icons, fonts, styles and guides are loaded once and reused, instead of being read again for each window.
  • Native macOS .app builds via Nuitka and PyInstaller.
  • Settings are saved more efficiently, with fewer writes to disk. Everything is still saved when the options window closes or the app quits.
  • Removed unused settings.
  • Logging improved and quieter. Routine lookups are debug-only, the loaded patterns are logged each time they load, and a warning is shown when the patterns file is missing.
  • Platform handling no longer depends on how your system names itself, and saved platform settings are read more strictly.
  • More reliable detection of macOS .app bundles when backing up the game and showing its folder.
  • Simplified how the patch configuration file is downloaded, removing an unused platform lookup.
  • Reorganised the patching code and game store handling so more games, files and stores can be supported in future.
  • patterns-v2.json tells the patches apart by game text found near each checksum check, with optional fixes for a specific game build, so a renamed check can be fixed without a new Patcher release. Checks that match no patch are patched with Checksum.
  • Patching reads and scans the game executable only once per run.
  • Reorganised how the Patcher starts up and reaches its settings, making it simpler to maintain. The --no-conn and --prevent-save-write startup messages now also reach the log file.
  • The code is now organised in clear layers (core, tools, patching and stores, app, interface) that only build on the ones below them, so changing one part no longer ripples through the others. tools/check_layers.py checks this for anyone building from source.
  • New report command for anyone building from source: python -m app.report <executable> shows where each patch would be applied, without changing anything.
  • The log now lists the app's config and settings at startup in a readable layout, follows each error with the system, version and revision, and shows how much time is left on the update check cooldown instead of how long ago the last check was.
  • Containerised builds: only one can run at a time, and they can be stopped with CTRL + C.
  • Faster CI builds: Nuitka's compile cache is now kept between runs.
  • The README has been rewritten with clearer guidance, including how the new patching works and whether non-Steam installs are supported.

Checksums

You can verify your download against the SHA256 digest shown next to each Asset in the list below, and look it up on VirusTotal to see scan results.


⚠️ Antivirus False Positives

Some antivirus software may flag this executable as malware. This is a false positive. The binary is compiled with Nuitka, which is commonly flagged due to its use in malware distribution, not because this application is malicious. The source code is open for review, and you can compile it yourself if desired.

If your antivirus flags the Nuitka build, try the PyInstaller build above.

See Issue #39 or README for more information.


If you'd like to support me:

Ko-fi

Buy Me A Coffee

Don't miss a new Stellaris-Exe-Checksum-Patcher release

NewReleases is sending notifications on new releases.