Skip to content
Tobey Blaber edited this page May 6, 2023 · 43 revisions

What is this?

BepInEx is a general purpose framework for Unity modding. This is a BepInEx pack for Subnautica, preconfigured and ready to use.

Is it compatible with QModManager?

Yes! See the Compatibility with QModManager page for more information.

Where can I find mods made for BepInEx?

You can find some under the Requirements section of the Description tab on the Nexus Mods mod page, under the heading Mods requiring this file. More will be coming soon, please be patient.

What's with the weird console window that opens whenever I start the game with BepInEx installed?

This was added to this installation of BepInEx as an easy way for Windows users to determine whether BepInEx has been installed correctly. We have had a number of users think it isn't working simply because they didn't see any difference in-game after installing BepInEx and nothing else.

Can I close the console window?

If you close the console window it will also close the game, so we advise against it.

If you would like to disable the console window entirely, you can do this easily with Configuration Manager. In-game, press F5. then enable Advanced settings. Click the heading BepInEx, and then under the heading Logging.Console simply uncheck the Enabled setting. You will need to restart Subnautica for this change to take effect.

After I installed this alongside QModManager, the game crashed on launch!

Some legacy QModManager mods require a the BepInEx configuration to function correctly. Please ensure you rename [game dir]\BepInEx\config\BepInEx.legacy.cfg to [game dir]\BepInEx\config\BepInEx.cfg when using this pack with QModManager.

I installed QModManager after this and now some of my BepInEx plugins stopped working!

QModManager ships with an old version of BepInEx, so installing QModManager on top of it will downgrade your BepInEx version, and some BepInEx plugins require the latest BepInEx version to function. To fix this, just reinstall BepInEx.

I've installed this with Vortex and it doesn't work!

Please ensure you have the Subnautica Support Vortex extension installed and that it is fully up-to-date, then reinstall BepInEx and all Subnautica mods.

On Steam, I see the console window briefly but it suddenly closes and mods don't work!

The TL;DR for this is to restart Steam and/or your PC until the problem goes away. For details, read on:

There is a rare bug that sometimes happens where Steam fails to inject the Steam DRM into the game. The game realises it is meant to have the Steam DRM there, so it relaunches itself to try to fix it. When it does this, it detaches BepInEx from the game process (which is why you see the console open and then close itself), and so BepInEx is now no longer running and neither are the mods.

You can confirm if this is what is happening by navigating to the [game dir]\BepInEx folder and opening the file LogOutput.log. If you see these two lines, then you're having this issue:

[Warning: Unity Log] Missing Steam DRM
[Warning: Unity Log] Couldn't initialize Steamworks

At this time, the only known fix for the issue is to restart Steam and/or your PC until the problem goes away. Most of the time you only need to restart once, but if you're unlucky it sometimes requires multiple reboots. The root cause of the issue seems to be a bug with Steam itself.

I'm running a pirated copy of the game and it doesn't work with BepInEx installed!

Tough luck. We won't be helping you with that. If you have problems running mods on a pirated copy of a game... the pirated copy is the problem, not the mods.

Mods operate under the assumption that the game is in a specific state, has specific code which does specific things that they can rely on. If these assumptions are proven false, then their mod is not going to be able to function correctly. Pirated copies of games frequently break these assumptions, and therefore frequently break mods. If you're getting bugs when running a pirated copy of a game, the most likely solution is to run a legitimate copy of the game. No developer is going to help you until you try that first, because otherwise you're just wasting their time.

I have a problem that isn't described above!

Feel free to post a comment on the Posts tab on Nexus Mods describing your issue, and I'll try to help you out.

Clone this wiki locally