Toby's BepInEx package for Subnautica.

BepInEx is a common framework for modding in Unity. This is a pre-configured BepInEx package for Subnautica, ready for use on Windows, macOS, and Linux (including SteamOS).

Toby's BepInEx for Subnautica.

Pre-configured BepInEx for Subnautica, ready for use on Windows, macOS, and Linux (including SteamOS).

BepInEx is a universal modding framework for Unity mods. BepInEx includes the following tools and libraries

Installation of game-specific code (hereinafter - plugins) at startup;

Apply patches to methods, classes, and even entire assemblies in a game without affecting the original files of the game;

Customize the plugins and save the game to the desired outputs, such as the console or files;

Manage plugin dependencies.

BepInEx is one of the most popular modding tools for Unity on GitHub.

What does this package contain?

This package is preconfigured and ready for use for Subnautica modding.

In particular, this package includes.

Tobey.Subnautica.ConfigHandler is a custom BepInEx patcher that automatically performs QModManager-compatible BepInEx configuration,

Tobey.UnityAudio, a customizable BepInEx patcher that automatically adds support for Unity sound when the mod needs it.

Tobey.FileTree, a customizable BepInEx plugin that saves the game's file tree to assist in troubleshooting.

Compatible with QModManager

TL;DR. is that QModManager is compatible with BepInEx, but there are a few things you should be aware of.

🛑 Notes.

Do not install QModManager unless it is an old branch.

Easy automatic installation.

💬 Important.

You won't see any changes in the game just by installing this package.

Check the LogOuput.log file in the BepInEx folder to determine if BepInEx is installed.

Windows (Vortex)

Vortex is a tool for installing and managing mods in Windows. You can install any mod for Subnautica and other games, including this package.

1. install Vortex Mod Manager. Make sure it is updated.

2. Click the Vortex button at the top of the page to install.

3. Check the 🔔 area in the upper right corner of Vortex:

If QModManager is installed, Vortex may notify you to reinstall/uninstall QModManager. Do the following:

If you see a notification of type "Upgrade required to deploy", press Upgrade to allow the update.

If you see a notification of the type Deployment Required, click Deploy.

4. start the game.

macOS (gib)

gib is a command-line tool that automates the installation of BepInEx on macOS.

1. Download Toby's BepInEx for Subnautica from the Files tab. If your browser does not open it automatically, unzip it in the download folder.

2. Open the Terminal in Launchpad or Spotlight (⟩ Press space, type terminal and press Enter).

Copy the command from the Usage section into README, as in #3, paste it into Terminal using ⌘ V, and press Enter to run it.

If you are stuck, contact README gib.

Manual Installation

⚠️ Attention.

macOS users are strongly encouraged to install using gib, as manual installation on macOS is cumbersome and prone to bugs.

manual installation on macOS is very cumbersome and prone to errors.

Advice.

The game folder is the folder where the game's executable file (for example, Subnautica.exe) is located.

Steam users can find the game folder in the Steam library by right-clicking on the game and selecting Manage -> Browse Local Files.

To install the game manually, follow these steps:

1. Download the Tobey's BepInEx for Subnautica from the Files tab.

2. 2. Extract the contents of the downloaded archive into the games folder.

ℹ️ In other words, unzip the .zip file and drag-and-drop the files and folders into your games folder.

3. Depending on your operating system:

Windows users: launch the game.

Linux (for example, SteamOS. ) and macOS users: Follow the operating system configuration instructions below:

💬 Important.

Simply installing this package will not result in in in-game changes.

Check the LogOuput.log file in the BepInEx folder to determine if BepInEx is installed.

Configuration in Linux (for example, SteamOS).

1. If the game is not in Steam, add it to Steam as a non-Steam game.

2. Open the game properties in Steam and set the launch arguments as follows:

WINEDLLOVERRIDES="winhttp=n,b" %command%.

3. Launch the game via Steam.

Configure on macOS

To install on macOS follow the guide for idiots.

Installing mods

For instructions on installing mods, see README, Installing Mods.