Simple Mod Manager

Simple SN2 Modloader

A streamlined, console-based terminal mod manager and launcher for Subnautica 2. Simple and efficient. No I will not be adding a GUI, it's terminal only for now. Originally made this for me and my friends but thought I'd post it here.

[line]

Features

1. Game Launcher

• Launch Standard: Start Subnautica 2 from steam without any console stuff. Just normally play the game.[/*]

• Launch with Debug Console: Run the game alongside a live diagnostic/debug window to trace active errors, monitor asset loading, or work on mod development.[/*]

2. Mod Management 

• Toggle UE4SS Mods: Toggle or Remove your UE4SS mods and a mod load order to boot.[/*]

• Toggle BP Patch Mods (~mods): Toggle or Remove your pak patch mods and a mod load order to boot. [/*]

• Toggle BP Logic Mods:  Toggle or Remove your LogicMods and a mod load order to boot. [/*]

• Engine Tweaks: Adjust your game engine to optimise performance.[/*]

• Install Mod from Zip: Directly install newly downloaded packages into your directories without requiring external extraction or manual file movement.[/*]

3. Integrated Updater (WIP)

• Check and Update BP Patch & Logic Mods: Syncs your local configuration files and automatically grabs updates for blueprint-based enhancements.[/*]

• Update UE4SS: Directly pulls and installs the latest stable underlying injection framework to keep pace with structural game updates.[/*]

4. Deployment & Safety Guards

• Deploy Mods to Game: Deploys the modpack to the game automagically.[/*]

• Purge Mods and Revert to Vanilla: Un-Deploys mods and removes UE4SS so you can play mod-free.[/*]

[line]

Planned Features

• Dedicated Modlist Import/Export: Plan to add this later, so you can share mods and modpacks with you and your friends easily. This is mostly a feature i want to implement for myself.[/*]

[line]

Credits & Acknowledgments

This modloader leverages and supports incredible work across the Subnautica 2 modding community. Special credits to:

• Vercadi: For the Quality Tweaks and async engine optimization basis for Engine.ini[/*]

• Ghostiexd: For developing the core Performance Engine.ini Presets that I used.[/*]

• Caites: For creating the PlayerTweaks system I used and packaged in this mod.[/*]

• The UE4SS Team: For building the underlying subsystem framework making all of this achievable.[/*]

[line]

Quick Start Guide

1. Run the Modloader Menu

Double-click the

RUNME.batfile in this folder to open the terminal-based mod manager menu.

2. Deploy Mods to the Game

Before you play for the first time, or whenever you make changes to your mods, select option

[4] Deploy Mods to Gamefrom the menu. This cleans out any old files in your game directory and copies your active mods, settings, and loaders into the right place with the optimized load order.

3. Launching the Game

You can launch the game normally via Steam, or use the play menu in the modloader:

• Select

[1] Play Gamein the main menu.[/*]

• Select

Launch Standardto run the game normally with mods.[/*]

• Select

Launch with Debug Consoleif you want to open the game alongside the UE4SS debugger (helpful for tracking down errors or reading log outputs).[/*]

[line]

Managing Your Mod List

To manage your installed mods, select

[2] Mod Managerfrom the main menu:

• Toggling Mods: Go to

Toggle Standard Mods,

Toggle Logic Mods, or

Toggle UE4SS Modsto enable or disable mods.[/*]

• Changing Load Order:

• Within the toggle menus, highlight any mod and press

Ctrl + Up Arrowor

Ctrl + Down Arrowto change its loading priority.[/*]

• Mods load from top to bottom as listed in the configuration files, so place dependencies or core libraries higher up.[/*]

[/*]

• Deleting Mods: Highlight a mod and press

Dto delete it from the manager.[/*]

• Adding New Mods: Choose

[5] Install Mod from Zipand enter the path to the downloaded mod

.ziparchive. The manager will extract it and place the files in the correct directories automatically.[/*]

• Applying Tweaks: Open the

Engine Tweaksmenu to apply graphics and performance presets to your

Engine.inifile.[/*]

[line]

Reverting to Vanilla

If you want to play without mods or start clean to troubleshoot an issue, choose

[5] Purge Mods and Revert to Vanillafrom the main menu. This removes all deployed mods, the hook DLL, and custom settings files from your game folder.