Skip to content

Releases: Vercadi/subnautica-2-mod-manager

Subnautica 2 Mod Manager v0.2.2

Choose a tag to compare

@Vercadi Vercadi released this 30 May 08:32

Subnautica 2 Mod Manager 0.2.2

Focused hotfix for Nexus feedback around inbox installs, duplicate old versions, mod-list cleanup, and confusing actions.

Changed

  • Fixed the Proton/Linux inbox workflow: inbox mods can now be selected from the main mod list and installed/enabled with Install & Enable.
  • Added Delete From List for uninstalled imported mods. This removes the manager-owned data/library/sources/src_* copy, removes the library_state.json entry, and clears stale profile references.
  • Renamed the profile-only action to Remove from Profile so it is not confused with uninstalling or deleting a library entry.
  • New imports now replace likely old uninstalled duplicate entries instead of filling the list with multiple versions of the same mod.
  • Installed duplicate entries are kept and marked with a Duplicate badge until they are uninstalled.
  • Added Delete Old Versions to the row menu for cleaning old uninstalled duplicate entries while keeping the selected one.
  • Apply/plan errors now include clearer next-action wording for missing sources, target conflicts, unsafe paths, and missing install paths.
  • Apply Preview now includes Copy Details when warnings/errors exist, so users can paste useful support details.

Notes

  • Disable keeps a mod in the active profile but turns it off.
  • Remove from Profile removes a mod from the active profile.
  • Uninstall removes manager-installed game files recorded in the manifest.
  • Delete From List removes the manager's saved library copy/list entry only after the mod is uninstalled.
  • Review-required loose overlays remain blocked from automatic Apply.
  • Unknown/manual files are still never deleted.

Artifact

  • Zip: dist/release/Subnautica2ModManager-0.2.2-portable.zip
  • SHA256: 75e62918cd5bbbcf9be6f58a497a7a1550702558729fc813bb9af57251c01d2f

Subnautica 2 Mod Manager v0.2.0

Choose a tag to compare

@Vercadi Vercadi released this 21 May 05:29

Subnautica 2 Mod Manager v0.2.0

This release includes the unreleased 0.1.5 stabilization fixes plus the 0.2.0 S2 PDA visual polish pass.

Changed

  • Restyled the main UI toward a Subnautica 2 PDA look with darker glass panels, brighter cyan outlines, subtle hex texture, and corner brackets.
  • Moved the selected-mod details panel to the right side so the mod list remains the main workspace.
  • Updated active navigation, profile selector, and Apply styling with amber selected-state colors.
  • Improved compact mod row readability.
  • Changed review-required loose-file rows to show clearer Limited Access styling.

Included from unreleased 0.1.5

  • Fixed Remove so it is profile-only and works for installed mods.
  • Fixed Uninstall so it removes manager-installed game files but keeps the mod available in the manager list.
  • Fixed Reset to Vanilla so it switches to Vanilla and removes manager-installed files directly.
  • Apply now skips unrelated review-required loose files instead of blocking safe supported mods.
  • Disabled or removed mods now create clear pending Apply changes.
  • Missing library/source copies no longer trap uninstall or reset flows.
  • Missing-source errors now give clearer next steps.
  • Reduced false UE4SS runtime warnings when runtime is installed, enabled, or manually present.
  • Unknown/manual files are still never deleted.
  • Loose overlays and SN2P-style root overlays remain review-required and skipped automatically.

Package

  • Portable Windows zip: Subnautica2ModManager-0.2.0-portable.zip
  • ZIP SHA256: 4534622dac6e33d8a7857850ab8604430bd88044c1abe6bc7b4e4cb2569bf142
  • EXE SHA256: 6f7b8a79e6c857cb722bfe50d4e00a4873fad3f754c5f6eeec6aa02be0f8ad8e

Subnautica 2 Mod Manager v0.1.4

Choose a tag to compare

@Vercadi Vercadi released this 17 May 14:29

Subnautica 2 Mod Manager v0.1.4

UX clarity, installed-config editing, and responsiveness hardening.

Archive note

The portable zip was repacked on 2026-05-19 with explicit directory entries for better compatibility with Ark, PeaZip, and other non-Windows extractors. The app version remains 0.1.4.

Changed

  • Added clearer mod states: Available, Enabled, Disabled, Pending Apply, Installed, Will Remove, Needs Review, Blocked, and Error.
  • Simplified main actions around Install From File, Install Folder, Open Mods Folder, Apply, Enable, Disable, Remove, Uninstall, and Reset to Vanilla.
  • Safe unambiguous drag/drop or Install From File sources can now install into the manager and enable automatically.
  • Apply can skip review-required loose overlays while still applying supported safe profile changes.
  • Normal warning details now appear inline/console-first instead of opening noisy noncritical popups.
  • Drag/drop registration now covers the larger mod list area.
  • Inbox scans now use cache/timing support for better responsiveness.
  • Fixed confusing no-op Apply feedback when no pending game changes exist.

Added

  • Installed-mod-only config discovery and editing for .lua, .ini, .json, .txt, and .cfg.
  • Config saves back up the installed file first and can restore the imported original.
  • Game Pass / WinGDK UE4SS health output for runtime root, mod target, proxy DLLs, and experimental layout warnings.
  • Better UE4SS runtime warning suppression when runtime is installed, manually present, or enabled in the active profile.

Safety

  • Config editing is only available for manager-installed files.
  • Imported-but-not-installed mods show install-first guidance instead of an editor.
  • Unknown/manual files are never deleted.
  • Loose overlays and SN2P-style root overlays remain review-required.
  • Critical uninstall/reset confirmations cannot be disabled.

SHA256

c944e6c47555439052319a42ac083dfe769e06c2d2bd1d4eccfa1fc0de211f2d  Subnautica2ModManager/Subnautica2ModManager.exe
46e1ee37920285b11928e58384af799bbb81e4e0447d8ac6fa5ad1cdb16a6501  Subnautica2ModManager-0.1.4-portable.zip

Subnautica 2 Mod Manager v0.1.3

Choose a tag to compare

@Vercadi Vercadi released this 16 May 23:45

UX simplification and profile/game sync redesign.

Changed:

  • Main flow is now drag/drop -> Install & Enable -> Apply -> Launch.
  • Main action labels are simplified: Apply, Install, Enable, Disable, Remove, Uninstall, Reset to Vanilla.
  • Recovery / Backups is now Installed Files / Backups.
  • Mod rows now use Available, Enabled, Disabled, Installed, and Needs Review states.
  • Apply now syncs the game folder to the active profile, including removal of manager-installed files that are no longer enabled.
  • Apply skips review-required loose overlays while installing supported selected mods.
  • Added an Open Mods Folder action for the detected game-side mod target.
  • UE4SS runtime warnings now clear correctly when UE4SS Runtime is enabled in the active profile or already installed.
  • Noncritical popups default off; critical safety confirmations remain enabled.

Safety:

  • Unknown/manual files are still reported only and are not deleted.
  • Loose overlays remain blocked/review-required.
  • Overwrites are still backed up before install.
  • Uninstall/reset confirmations remain critical and cannot be disabled.

Download:

  • Use Subnautica2ModManager-0.1.3-portable.zip.

SHA256:

  • EXE: 5c07c0792d496acb5af4ed54bbe07b573810572bf55e8b619d230cd437d0a004
  • ZIP: f6abbbf77a52ed347d1a723376f9a4174faaa13f6c8ff0fc414fdba3a67adde9

Validation:

  • python -m compileall app.py s2_mod_manager
  • pytest -q: 192 passed

Subnautica 2 Mod Manager v0.1.2

Choose a tag to compare

@Vercadi Vercadi released this 15 May 21:33

Subnautica 2 Mod Manager v0.1.2

Small patch release for update visibility.

Changes

  • Startup update checks now default to enabled for new installs and missing/corrupt settings.
  • Existing users who already saved an update-check preference keep their current choice.
  • Update checks still only query GitHub Releases.
  • The app still does not auto-download or auto-install updates.

Notes

  • Users on 0.1.0 or 0.1.1 can still click Updates manually.
  • The update popup can be disabled in Settings through the popup policy controls.

Subnautica 2 Mod Manager v0.1.1

Choose a tag to compare

@Vercadi Vercadi released this 15 May 20:43

Subnautica 2 Mod Manager v0.1.1

Patch release for Epic/manual installs and experimental Game Pass WinGDK layout support.

Highlights

  • Steam auto-detection remains supported and unchanged.
  • Epic/manual Win64 installs can now be selected manually when they expose the normal Unreal layout.
  • Manual path selection now accepts common folder levels instead of only the outer Steam-style root.
  • Game Pass WinGDK layout support is included as experimental for Content\Subnautica2\Binaries\WinGDK.
  • UE4SS runtime/mod deployment targets now come from the detected install layout instead of assuming Win64.
  • Game Pass UE4SS targeting follows the ProtonLabs package notes: base/runtime payloads can be applied from the Content root, while standard Lua mods target Content\Subnautica2\Binaries\WinGDK\ue4ss\Mods.
  • Diagnostics and support reports now include install variant, project root, binaries folder, pak folder, and UE4SS target folder.
  • UE4SS runtime warnings now explain that users can import/add the UE4SS Runtime package through the manager instead of only installing it manually.
  • Main flow is simpler: drag/drop or install from file, use Import & Enable, toggle mods on/off, then Preview & Apply Profile.
  • Toggling an imported mod now adds/enables it in the active editable profile automatically. If Vanilla is active, the manager creates or selects Default Modded.
  • A primary Preview & Apply Profile button is visible on the main screen; it is no longer hidden behind the row menu.
  • Fixed SeaSprint-style UE4SS pak deployment: non-_P pak bundles now install to Subnautica2\Content\Paks\LogicMods.
  • Patch pak bundles ending in _P still install to Subnautica2\Content\Paks\~mods.
  • Existing imported non-_P pak library entries from older builds are migrated to LogicMods automatically.

Manual Path Selection

Settings can validate and normalize:

  • Outer install root
  • Inner Subnautica2 project folder
  • Subnautica2\Binaries\Win64
  • Content
  • Content\Subnautica2
  • Content\Subnautica2\Binaries\WinGDK

Storefront Notes

  • Steam: tested and auto-detected.
  • Epic/manual Win64: supported through manual path selection when the shipping exe and pak folder exist.
  • Game Pass WinGDK: experimental. The manager can detect WinGDK and map UE4SS mods to Content\Subnautica2\Binaries\WinGDK\ue4ss\Mods, but some mods may still crash because of mod/runtime compatibility.

Safety Notes

  • Preview & Apply Profile is still required before install.
  • Managed recovery still only touches files recorded in install_manifest.json.
  • Loose root overlays and unsafe unmanaged writes remain blocked.
  • Unknown files are reported, not deleted.

Subnautica 2 Mod Manager v0.1.0

Choose a tag to compare

@Vercadi Vercadi released this 15 May 15:41

Subnautica 2 Mod Manager v0.1.0

Initial public portable Windows release.

Highlights

  • Import UE4SS and pak mods from files, folders, .zip, and .7z.
  • Organize imported mods into profiles.
  • Enable or disable profile entries.
  • Preview every planned install action before writing to the game folder.
  • Apply supported managed mods after confirmation.
  • Track installed files in install_manifest.json.
  • Uninstall managed files later through Recovery / Backups.
  • Generate diagnostics and redacted support reports.

Supported Mod Shapes

  • Pak bundles with .pak, .ucas, and .utoc companions.
  • UE4SS runtime archives/folders.
  • UE4SS Lua mods using Scripts\main.lua.
  • UE4SS C++ mods using dlls\main.dll.
  • Wrapped UE4SS mod folders.
  • Zip and 7z archives.
  • Direct folders containing supported mod structures.

Review-Required Shapes

  • Loose game-root overlays.
  • SN2P-style root overlays.
  • Root loader DLLs or root .ini files.
  • Ambiguous archives containing multiple unrelated mod candidates.
  • Unsupported archive/file layouts.

Review-required items are blocked from automatic apply. They can be imported for reference, but they need manual review before use.

Safety Notes

  • Real apply for supported managed mods is available through Apply Preview.
  • Apply Preview refuses blocked or review-required plans before any game-folder write.
  • Destructive recovery is limited to manifest-tracked managed files.
  • Unknown files are reported, not deleted.
  • Saves are not deleted by the manager.
  • Restore-vanilla and quarantine are preview/report surfaces only.

Known Limitations

  • No per-mod UE4SS settings editor yet.
  • No Nexus metadata parsing or one-click Nexus download integration.
  • Manually installed mods cannot be safely uninstalled unless this manager installed them.
  • RAR support depends on local archive support.
  • SN2P-style root overlays remain review-required.

Support Report

Use Help / About / Support, then copy or save the local support report. Include the report text, mod filename, active profile, action clicked, and visible warning or error.

Support reports redact user-home paths. Do not include saves, personal account folders, or unrelated logs.

Windows Security Note

This is an unsigned PyInstaller portable build. Some antivirus tools may flag unsigned Python apps heuristically. The app does not require administrator rights and should be extracted outside the game folder.