Repository navigation
🇧🇷 Leia em Português: README_pt-BR.md
⚠️ Windows SmartScreen may warn about an unrecognized app, because the installer isn't code-signed. Click More info → Run anyway.
Requirements
- Windows 10 or 11 (x64)
- An existing SPT install
Release 0.8.0
Mod profiles, start buttons for the server and launcher, a cleaner update check, new themes, and fixes for the most reported download and install errors.
Mod profiles
- Keep several setups in one SPT install, MO2-style: solo, Fika with friends, testing. Each profile remembers which mods are in it and which are active, plus your names, categories and manual mod page links.
- The active profile saves itself. There's no save button: whatever you do in the app is part of it.
- Switching disables the mods that aren't in the other profile (nothing is deleted), and offers to download the ones it has that aren't installed. It's blocked while the game or the SPT server is running, since their files are locked.
- Export / Import profile. The file carries each mod's version and catalogue ID, so importing it on another PC or a friend's game downloads the exact versions. Mod lists exported by older versions still import, as a new profile. Closes #9.
Updates
- Redesigned update check. Mods are listed in aligned columns (name, versions, actions), with a single Update all button at the top. Blocked, incompatible, no-local-version and not-found mods are grouped in collapsed sections with a count.
- Blocked updates say what blocks them: the installed mod and the version range it accepts, e.g. "Scorpion 1.0.0 (requires ~2.0.15)". The "update blocked" chip in the mod list shows the same on hover.
- Update anyway. Blocked updates can be installed after confirming what may break. Often the blocking mod's author just hasn't widened the range yet.
New
- Start the SPT server and launcher from the header.
- Refresh (or F5) re-reads the SPT folder, so mods added or removed by hand show up without restarting.
- Fika filter for installed mods.
- Link to mod page (in a mod's ⋮ menu): tell the app which catalogue mod a folder is, for mods it can't match by name. You can also enter the installed version, for mods that don't report one or report the wrong one, so update checks can compare it.
Appearance
- Themes: Black (OLED), Olive and High contrast, along with System, Dark, Light and Sand.
- Accent color: pick from presets or any color. If it would be hard to read on the theme, the app darkens or lightens it.
- Colorblind mode, separate from the theme: statuses use blue and orange instead of green and red.
Changes
- The app's files no longer sit in the SPT root. They live in
user/spt-mod-manager/inside the server folder (SPT_Runtime/user/spt-mod-manager/on SPT 4.1), and existing files are moved there automatically. Going back to 0.7.x afterwards won't find them. - Export / Import list moved to the new profile bar.
Fixes
- "fetch failed" (#8): downloads and catalogue requests now use the same network stack as the browser, so the system proxy, VPN and Windows certificates are respected. If it still fails, the error shows the real cause and host.
- "ADM-ZIP: Invalid or unsupported zip format" (fixes #7): archives are opened by their real format instead of the extension, with 7-Zip as a fallback for zips the built-in reader rejects. Damaged or incomplete downloads, and web pages sent instead of the file, get a clear message.
- Running the app from inside a
.zip/.rarwithout extracting it is detected at startup, instead of failing later with "spawn 7za.exe ENOENT". - Switching the mod source shows why the source didn't respond.
- Light theme: primary buttons use white text, for readable contrast.
Full details in the README.
Installation
Download SPT-Mod-Manager-0.8.0-win-x64.exe below and run it. Updating from an older version keeps your settings.
Feedback
Found a bug? Use Details → Open a GitHub issue on the error, or post in the comments on sp-mod.com.