v0.8.0 — Mod profiles, themes and launch buttons

🇧🇷 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/.rar without 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.

v0.7.0 — Settings, categories and a download queue

🇧🇷 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.7.0

A settings panel, your own categories, a real download queue, a download cache, changelogs before updating, and no more freezing while big mods install.

Settings

• New settings panel (gear icon): instance info, theme, animations, language, mod source and download options, all in one place.
• Themes: System, Dark, Light and Sand.
• Animations can be turned off. Mouse scrolling is now smooth either way.
• The first launch asks for your language.

Organize

• Categories. Group mods by the source's category, or create your own and drag mods into them. Categories survive updates and folder renames.
• Expanded packages and collapsed categories are remembered.

Updates

• Changelog before updating. A note icon next to each available update shows what changed between your version and the new one.
• Mod names in the update check open the mod's Versions tab, where authors say when a clean install is needed.
• The blocked updates list starts collapsed.

Downloads

• Download queue. One download at a time by default (2 or 3 in settings). Pause, resume, cancel and reorder. Paused downloads resume where they stopped when the server allows it.
• Dependencies and the mod are queued together, and the mod always installs last. Cancelling a dependency asks whether to cancel the mod too.
• Download cache (issue #5). Mods you already downloaded install again without downloading: reinstalling, importing a list, another instance. 5 GB by default, with usage and Clear cache in settings.
• Browse: "Compatible with 4.1.x" and "Fika compatible only" filters.

Fixes

• The app no longer freezes while installing big mods. Installs run in a separate process.
• Installs never run at the same time, so the app can't lose track of an installed mod.
• Truncated downloads are caught before installing.
• Mods with loose DLLs no longer install into a .tmp-forge-download-... folder.
• "Couldn't overwrite" errors on read-only or locked files are handled and explained.

Full details in the README.

Installation

Download SPT-Mod-Manager-0.7.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.

v0.6.4 — Update All

🇧🇷 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.6.4

Update checks that work on big mod lists, updates that stop blocking each other, and a way to report errors that actually tells me what went wrong.

Updates

• Update checks no longer fail on large mod lists. With many mods installed, the check could stop with 414 URI Too Long. The app now splits the check into smaller requests.
• Updates no longer block each other. When mod A needed the new version of mod B, and B also had an update, both showed as blocked. The app now works out the right order, so A shows up as a normal update after B.
• Update all. Installs every available update in one click, in the right order, one at a time. If one fails, the rest keep going and you get a summary at the end.
• Mods you already updated now show "✔ updated" instead of keeping the Update button.

Errors

• Error messages are in English for every language except Portuguese. Some errors used to show up in Portuguese for everyone.
• New Details button on errors. It opens a box with:
  • Copy error: the error plus the app, SPT and Windows versions. Your Windows username is removed from any path.
  • Open a GitHub issue: opens a new issue already filled in.
• Error notifications stay on screen longer, so they don't disappear before you can read them.

Fixes

• Open folder on server + client mods always opened the server half. The menu now has one entry for each half.

Full details in the README.

Installation

Download SPT-Mod-Manager-0.6.4-win-x64.exe below and run it. Updating from an older version keeps your settings.

Feedback

Found a bug? Use the new Details → Open a GitHub issue button, or post in the comments on sp-mod.com.

v0.6.3 — Updates That Stay Updated

SPT Mod Manager v0.6.3

A Vortex / Mod Organizer 2-style mod manager built specifically for SPT.

🇧🇷 Português: https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README_pt-BR.md

⚠️ Before running

Windows will likely display a "Windows protected your PC" SmartScreen warning. This is expected for unsigned indie software and does not mean the application is malicious. Click More info then Run anyway.

Requirements

• Windows
• An existing SPT installation

Release 0.6.3

Small one, fixing an update prompt that wouldn't go away.

Fixes

• Mods stop asking to be updated once you've updated them. The Manager was reading the version from inside the mod's files, and that number doesn't always match what the author published. When they differ, the Manager compared the wrong value and kept offering the same update forever, no matter how many times you took it. For mods installed through the Manager, the version the source reported is now the one that counts. Mods you dropped in by hand are unaffected, since there's nothing else to go on for those. ( thanks mozekuma )
• This also unblocks updates that were being held back: a mod whose dependency looked out of date couldn't be updated, and the dependency looked out of date because of the same bug.

See the README for the complete feature list.

Installation

1. Download SPT-Mod-Manager-0.6.3-win-x64.exe below.
2. Run it (see the SmartScreen note above).
3. Select your SPT installation folder on first launch.

Feedback

This is a personal project, so feedback, bug reports, and feature suggestions are always welcome.

v0.6.2 — Updates That Behave

SPT Mod Manager v0.6.2

A Vortex / Mod Organizer 2-style mod manager built specifically for SPT.

🇧🇷 Português: https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README_pt-BR.md

⚠️ Before running

Windows will likely display a "Windows protected your PC" SmartScreen warning. This is expected for unsigned indie software and does not mean the application is malicious. Click More info then Run anyway.

Requirements

• Windows
• An existing SPT installation

Release 0.6.2

Updating a mod no longer forgets what you had set up, and mod images are back.

Updating

• A disabled mod stays disabled after you update it. Installing always wrote into the active folders, so updating something you had turned off quietly turned it back on. ( thanks doktorstick )
• A mod that renames its folder between versions no longer ends up installed twice. The new version was copied in and the old folder was left behind, so the server loaded both and the mod misbehaved for reasons that pointed anywhere but here. ( thanks trex0113 )
• Importing a mod list restores the version saved in it, with the right name and author, instead of pulling the newest one. ( thanks KirillLoginov )

Installing

• Files that sit next to a mod's folder are installed too. SVM ships Greed.exe beside its SPT_Runtime folder, and the Manager was copying only from the folder itself, so the executable was dropped without a word. ( thanks inganshin, FallenWerewolf )
• Mod images work again. The file host only serves them to requests coming from the site, so every thumbnail was being refused. The last few in each page were never even requested.

Browsing

• Sort by most downloaded, recently updated, recently added or name. ( thanks inganshin, Meepowski, Faolan1213 )
• "Open mod page" on any installed mod, from the row menu. ( thanks trex0113 )
• A missing dependency and an outdated one now read differently, and the Fika label no longer shares a colour with "Installed".

Fixes

• The app no longer crashes when the SPT folder has been moved or renamed outside of it. A failed download used to take the whole window down with a JavaScript error.
• Dependencies installed alongside a mod are marked as installed right away.
• Removing one half of a two-part mod removes both from the list.

See the README for the complete feature list.

Installation

1. Download SPT-Mod-Manager-0.6.2-win-x64.exe below.
2. Run it (see the SmartScreen note above).
3. Select your SPT installation folder on first launch.

Feedback

This is a personal project, so feedback, bug reports, and feature suggestions are always welcome.

v0.6.1 — Fixes From Your Reports

SPT Mod Manager v0.6.1

A Vortex / Mod Organizer 2-style mod manager built specifically for SPT.

🇧🇷 Português: https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README_pt-BR.md

⚠️ Before running

Windows will likely display a "Windows protected your PC" SmartScreen warning. This is expected for unsigned indie software and does not mean the application is malicious. Click More info then Run anyway.

Requirements

• Windows
• An existing SPT installation

Release 0.6.1

Everything here came from your comments on 0.6.0. Thank you for the reports, a couple of these were worse than they looked.

Fixes

• Importing a mod list restores the version that was saved in it, instead of the newest one. The version was in the exported file all along; the restore path never read it. If you exported with an older version of a mod on purpose, you get that one back. ( thanks KirillLoginov )
• Removed mods stop showing as installed. The catalogue was deciding what you had from its own notes and never checking whether the folder was still there, so a mod deleted by hand, or by an older build, kept showing "Reinstall". The disk decides now, and nothing needs to be cleaned up by hand. ( thanks Mayoringram )
• The "update available" mark goes away once you update. It was only ever written, never cleared, and it was saved to disk, so it came back even after restarting. ( thanks DemonHunter58, sotthata )
• Removing a two-part mod removes both halves from the list. Both were already deleted from disk, but only one row disappeared. ( thanks inganshin )
• A missing dependency and an outdated one now read differently in search results. Both looked the same, which made a library you already had look like one you didn't.
• The catalogue search recovers from a failed request instead of leaving the search field disabled until you reopened the window.

See the README for the complete feature list.

Installation

1. Download SPT-Mod-Manager-0.6.1-win-x64.exe below.
2. Run it (see the SmartScreen note above).
3. Select your SPT installation folder on first launch.

Feedback

This is a personal project, so feedback, bug reports, and feature suggestions are always welcome.

v0.6.0 — Seven Languages, Dependencies

SPT Mod Manager v0.6.0

A Vortex / Mod Organizer 2-style mod manager built specifically for SPT.

🇧🇷 Português: https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README_pt-BR.md

⚠️ Before running

Windows will likely display a "Windows protected your PC" SmartScreen warning. This is expected for unsigned indie software and does not mean the application is malicious. Click More info then Run anyway.

Requirements

• Windows
• An existing SPT installation

Release 0.6.0

The Manager speaks seven languages now, and it knows which mods depend on which.

Languages

• Chinese, Russian, French, Japanese and German, on top of the English and Portuguese that were already there. The PT | EN buttons are now a dropdown, and on first launch the Manager follows your system language instead of assuming.
• Around 99% of these translations were done by [GΛVRIEL](https://github.com/GAVRIEL-911), who built a multilingual edition of the Manager on his own and offered it back to the project. He deserves the credit for the whole thing, and there's a line next to the language picker pointing at him.
• A handful of strings for the features below were added after his work and were translated by me, without speaking any of those five languages. If you spot a translation that reads badly, it's almost certainly one of mine, not his. Tell me and I'll fix it.

Dependencies

• Search results now say how many dependencies a mod has, before you install anything. The badge is amber when something is missing or out of date, and grey when everything is already in place.
• Installing a mod checks what it needs and offers to bring it along. You get a list with each dependency, its size, and what will happen to it: downloaded, updated, or already fine. Nothing appears when you already have everything.
• Dependencies install before the mod itself, since a mod that loads before its library can fail on the server's first start.
• When updating a shared library, the Manager tells you who else is using it. Mods pin exact versions on the site, so two mods can want different versions of the same library and only one can be on disk. Now you can see that before you decide instead of finding out later.

Fixes

• Server mods work again on SPT 4.1. The game changed how it writes mod information inside the files, and the Manager was reading nothing back. If you installed a server mod by hand, it showed up without a version, an author or an ID — and that missing ID also made checking the site slower, because the Manager had to fall back to searching by name. Reading is fixed, and it still handles the older 4.0 format.
• Removing a two-part mod now removes both parts. Disabling one already moved both halves, but removing only deleted the one you selected, so the leftover half reappeared on its own in the next scan.
• The catalogue search no longer locks up. If a request failed, the search field stayed disabled until you closed and reopened the window. It now recovers and shows you what went wrong.

See the [README](https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README.md) for the complete feature list.

Installation

1. Download SPT-Mod-Manager-0.6.0-win-x64.exe below.
2. Run it (see the SmartScreen note above).
3. Select your SPT installation folder on first launch.

Feedback

This is a personal project, so feedback, bug reports, and feature suggestions are always welcome.

v0.5.3 — Browsing, Fixed Up

SPT Mod Manager v0.5.3

A Vortex / Mod Organizer 2-style mod manager built specifically for SPT.

🇧🇷 Português: https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README_pt-BR.md

⚠️ Before running

Windows will likely display a "Windows protected your PC" SmartScreen warning. This is expected for unsigned indie software and does not mean the application is malicious. Click More info then Run anyway.

Requirements

• Windows
• An existing SPT installation

Release 0.5.3

Small release, all from your comments. Every item here came from someone reporting something.

Mod search

• Clicking a mod now opens that mod's page instead of the site's front page. The link had the right address on it all along; the click handler just ignored it.
• New "Only what I don't have" checkbox. Hides mods you've already installed so you can see what's actually new to you. When it's on, the Manager also pulls a bigger page from the site, so there's still a list left after the hiding.
• Both checkboxes now re-run the search when you click them. "Only compatible" used to need a second click on Search, which made it feel broken next to the other one.
• The "Installed" badge updates right after installing, instead of waiting for you to search again.
• Mods for a different SPT version are now labelled rather than just missing. Uncheck "Only compatible" and you'll see the whole catalogue, with a red mark on anything that doesn't fit your install and the version it targets in the tooltip. If you were hoping for a way to pick several SPT versions at once, this covers it: a mod marked ~4.1.0 already counts as compatible on 4.1.2, so the only ones hidden were those pinned to one exact version.

Errors

• "Unexpected token '<'" is gone. That message appeared when the site answered with an error page instead of data, which the Manager then failed to read as JSON. It now tells you what actually came back, so a Cloudflare error, a site outage and a hotel Wi-Fi login page no longer all look like the same cryptic failure.

See the README for the complete feature list.

Installation

1. Download SPT-Mod-Manager-0.5.3-win-x64.exe below.
2. Run it (see the SmartScreen note above).
3. Select your SPT installation folder on first launch.

Feedback

This is a personal project, so feedback, bug reports, and feature suggestions are always welcome.

v0.5.2 — Update Checks Actually Work

SPT Mod Manager v0.5.2

A Vortex / Mod Organizer 2-style mod manager built specifically for SPT.

🇧🇷 Português: https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README_pt-BR.md

⚠️ Before running

Windows will likely display a "Windows protected your PC" SmartScreen warning. This is expected for unsigned indie software and does not mean the application is malicious. Click More info then Run anyway.

Requirements

• Windows
• An existing SPT installation

Release 0.5.2

All bug fixes, all from your reports. Thanks to everyone who took the time to describe what they were seeing.

Checking for updates

• Update checks went from about five minutes to under twenty seconds on a 97-mod install, and from 180 requests down to 17. One query parameter was making the Forge ignore the filter it was sent, so the fast batched lookup silently returned the wrong mods and every single mod fell through to the slow one-at-a-time search. That also made the check hit the rate limit and give up partway, which is why some of you saw "N mods weren't checked" every time.
• Fixed hitting the rate limit after browsing mods. A few requests weren't going through the same throttle as the rest, so opening the mod search and then checking for updates could trip the limit and get you blocked for 30 seconds.
• Mods that genuinely aren't on the Forge are now remembered as such for a week, so they don't get searched from scratch on every check.

SPT 4.1 installs

• Fixed server mods installing to the wrong folder when spare copies of SPT.Server.exe sit in your game root. The Manager checked the folder you selected before looking inside it, so a leftover executable in the root won over the real one in SPT_Runtime, and server mods ended up in a stray user/mods. It now prefers the subfolder when the folder you picked is clearly your game root.
• If you were affected: open the Manager once and the saved path corrects itself. Mods already installed to the wrong place stay there, so reinstall those through the Manager. A leftover user/mods in your game root is safe to delete afterwards.

Other fixes

• Your chosen SPT version sticks again. Detecting the version automatically from the server executable was overwriting your manual choice on every startup, which meant you couldn't stay on an older version on purpose.
• Multi-part mods read more clearly. When a mod ships a server and a client half, the parts now sit in a shaded strip under the mod itself rather than looking like separate list entries. Only the mod gets a checkbox, since enabling or disabling applies to both halves together.

See the [README](https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README.md) for the complete feature list.

Installation

1. Download SPT-Mod-Manager-0.5.2-win-x64.exe below.
2. Run it (see the SmartScreen note above).
3. Select your SPT installation folder on first launch.

Feedback

This is a personal project, so feedback, bug reports, and feature suggestions are always welcome.

v0.5.1 — The Forge Is Back

SPT Mod Manager v0.5.1

A Vortex / Mod Organizer 2-style mod manager built specifically for SPT.

🇧🇷 Português: https://github.com/Nevek20/SPT_Mod_Manager/blob/main/README_pt-BR.md

📢 The Forge is back at a new address

The Forge has returned as the official continuation at https://sp-mod.com, and this mod's page now lives at https://sp-mod.com/mod/2851/spt-mod-manager.

If you're on 0.4.6 or older, you need this update. The old sp-tarkov.com API is offline, so searching for mods, checking for updates, one-click installs and modlist restore are all failing on those versions. 0.5.0 and 0.5.1 point the Manager at the new site and bring those back.

Update notifications also link to the mod page again, the way they used to.

⚠️ Before running

Windows will likely display a "Windows protected your PC" SmartScreen warning. This is expected for unsigned indie software and does not mean the application is malicious. Click More info → Run anyway.

Requirements

• Windows
• An existing SPT installation

Release 0.5.1

• Update notifications link to the mod page again. They pointed at GitHub for a while, because no site was accepting new uploads at the time. The Forge accepts them again, so this goes back to normal, the changelog link still opens the GitHub release, for anyone who'd rather download there.
• The link follows whichever source you've selected, so if you're using a mirror instead, it takes you to that one.

Coming from 0.4.6 or older?

0.5.0 was the big one, and everything in it is in this build too:

• The Manager talks to sp-mod.com, and you can switch sources from a dropdown in the mod search window
• Multi-part mods appear as one row with their parts nested underneath, instead of split across separate Server and Client sections
• Mods you already have are marked as installed in the search window
• "Only compatible with X" actually shows compatible versions now
• The SPT version is detected again on 4.x, read from SPT.Server.exe

Full details: v0.5.0 release notes

Installation

1. Download SPT-Mod-Manager-0.5.1-win-x64.exe below.
2. Run it (see the SmartScreen note above).
3. Select your SPT installation folder on first launch.

Feedback

This is a personal project, so feedback, bug reports, and feature suggestions are always welcome.

---

Descrição curta pra Forge

Release 0.5.1

📢 The Forge is back at https://sp-mod.com — if you're on 0.4.6 or older, update. The old sp-tarkov.com API is offline, so mod search, update checks, one-click installs and modlist restore are all failing on those versions. This build points the Manager at the new site and brings them back.

• Update notifications link to the mod page again, the way they used to. They went to GitHub for a while, because no site was accepting uploads at the time. The changelog link still opens the GitHub release for anyone who'd rather download there.
• The link follows whichever source you've selected in the search window, so a mirror takes you to that mirror instead.

Coming from 0.4.6? Everything from 0.5.0 is in this build: selectable mod sources, multi-part mods shown as one row with their parts nested underneath, already-installed mods marked in the search window, a working "only compatible with X" filter, and SPT version detection working again on 4.x.