Vercadi's Subnautica 2 Mod Manager

Subnautica 2 Mod Manager is a safety-first Windows mod manager for Subnautica 2 UE4SS and pak mods.

It is built around a simple flow: Drag/drop or Install From File -> Install & Enable -> Apply -> Launch

The manager imports mods into its own library, lets you enable or disable them in profiles, applies supported managed mods to the game folder, records installed files in a manifest, and can uninstall only files it installed.

Features

•     Steam install discovery for Subnautica 2 app id 1962700[/*]

•     Manual install path selection for Steam/Epic-style Win64 layouts[/*]

•     Experimental Game Pass WinGDK layout support[/*]

•     Drag/drop and browse install from files, folders, zip, 7z, and supported archive layouts[/*]

•     One-step Install & Enable for supported unambiguous mods[/*]

•     Pak bundle support for .pak, .ucas, and .utoc[/*]

•     LogicMods support for non-_P UE4SS Blueprint/logic pak bundles[/*]

•     UE4SS runtime detection and install support[/*]

•     UE4SS Lua and C++ mod detection[/*]

•     Protected Vanilla profile plus editable modded profiles[/*]

•     Enable, Disable, Remove, Uninstall, Reset to Vanilla, and Apply actions[/*]

•     UE4SS activation file support for enabled.txt, mods.txt, and mods.json[/*]

•     Installed-mod config editing for safe text files: .lua, .ini, .json, .txt, and .cfg[/*]

•     Manifest-backed uninstall and backups before overwrites or installed config edits[/*]

•     Diagnostics, redacted support reports, and activity logging[/*]

•     Subnautica-inspired underwater UI[/*]

How To Use

•     Download the portable zip.[/*]

•     Extract it to a normal folder outside the game folder and outside Program Files.[/*]

•     Run Subnautica2ModManager.exe.[/*]

•     Open Settings and confirm your Subnautica 2 install path.[/*]

•     Drag/drop a mod onto the mod list, or use Install From File / Install Folder.[/*]

•     Use Install & Enable for supported mods.[/*]

•     Click Apply.[/*]

•     Launch the game.[/*]

To disable a mod, turn it off or select it and click Disable, then click Apply again.

To remove a mod from the active profile, select it and click Remove, then click Apply.

To remove manager-installed files from the game folder, use Uninstall or Reset to Vanilla. The manager only removes files recorded in its install manifest. Unknown or manually installed files are reported, not deleted.

Supported Mods

Supported for managed install:

•     UE4SS runtime folders or archives[/*]

•     UE4SS mods using Scripts/main.lua[/*]

•     UE4SS mods using dlls/main.dll[/*]

•     Pak bundles:[/*]

•         .pak[/*]

•         .pak + .ucas[/*]

•         .pak + .utoc[/*]

•         .pak + .ucas + .utoc[/*]

•     Zip archives[/*]

•     7z archives[/*]

•     RAR archives if local archive support is available[/*]

•     Folders containing supported mod structures[/*]

Pak target policy:

• Patch paks ending in _P install to Subnautica2 Content Paks ~mods.[/*]

• UE4SS Blueprint/logic pak bundles without _P, such as SeaSprint-style mods, install to Subnautica2 Content Paks LogicMods.[/*]

• Archives that already include Content Paks LogicMods or Content Paks ~mods keep that target folder.[/*]

Storefront / Install Layout Support

Steam:

Steam is the tested path and is auto-detected through Steam library/appmanifest discovery.

Epic/manual Win64:

Supported through Settings manual path selection when the install exposes the normal Unreal layout with Subnautica2 Binaries Win64 and Subnautica2 Content Paks.

Game Pass:

Game Pass WinGDK support is experimental. The manager can recognize the reported Content Subnautica2 Binaries WinGDK layout. Game Pass UE4SS base/runtime packages are treated as Content-root payloads, while standard UE4SS Lua mods target: Content Subnautica2 Binaries WinGDK ue4ss Mods

Individual mods can still crash if they are not compatible with Game Pass/WinGDK, even when the folder target is correct. If a Game Pass setup crashes, test one mod at a time.

Manual path selection accepts the outer install folder, the inner Subnautica2 project folder, Subnautica2 Binaries Win64, the Game Pass Content folder, Content Subnautica2, or Content Subnautica2 Binaries WinGDK.

Review Required / Blocked Layouts

Some layouts are detected but blocked from automatic Apply:

•     Loose game-root overlays[/*]

•     SN2P-style root overlays[/*]

•     Arbitrary root DLL/config overlays[/*]

•     Ambiguous archives containing several unrelated mod candidates[/*]

•     Unsupported archive/file layouts[/*]

•     Unexpected unmanaged game-root overwrites[/*]

These are blocked because they can affect game launch, conflict with other loaders, or leave unmanaged files behind. Unknown/manual files are reported, not deleted.

Safety Model

Apply installs supported enabled mods and removes manager-installed files that no longer belong to the active profile.

Every managed install is recorded in install_manifest.json. If an existing managed target is overwritten, the original file is backed up first. Installed Files / Backups and uninstall actions only touch files recorded in the manager manifest.

Config editing is available only for manager-installed files. Saving a config creates a backup first. Imported-but-not-installed mods show install-first guidance instead of an editor.

Reset to Vanilla switches to the Vanilla profile and removes manager-installed files after confirmation. It does not delete saves, unknown files, or manually installed files.

Support

If something scans incorrectly, Apply does nothing, a mod is marked Needs Review, or a mod installs to the wrong folder, please include a support report.

In the app: Help / Support -> Generate Support Report

Please include:

•     The support report text[/*]

•     The mod archive filename[/*]

•     The active profile name[/*]

•     The action you clicked[/*]

•     The visible warning or error[/*]

Do not include save folders or personal files. The support report is designed to redact personal home paths and omit save paths.

Support My Modding Work

Optional support helps me spend more time maintaining and building mods.

Support on Ko-fi | Support on Patreon