A Subnautica Mod that randomises many aspects of the game for replayability, originally based on the first Subnautica randomizer. Over time, this project grew to become completely independent and today no longer shares any code with the original.
If you do not change any of the options in the mod options menu the mod will randomise using recommended settings. You can either start playing immediately, or customise your experience in the mod options menu.
The randomisation persists between play sessions and within save games. This means you don't have to play it all through in one sitting, and that you can swap between different save files with different seeds as you like. However, you cannot change any options of an ongoing game.
- Recipes for most craftable things in the game, excluding decorative base pieces and food/water.
- Blueprints found in databoxes
- Fragment spawn rates and locations
- Lifepod spawn location
- Door codes and supply box contents
- ✔️ No softlocks
- ✔️ Detailed mod options menu
- ✔️ (Probably) Don't spawn in the void
- ✔️ Randomise rewards from scanning a fragment you already know
- ✔️ Include fish, eggs and seeds in recipes
- ✔️ Out-of-order upgrades, so you might acquire e.g. a Seamoth Depth Module 3 long before you ever manage to get Module 1 or 2
- ✔️ Long recipe chains. Do you really need that laser cutter, or do you craft it into Polyaniline for a Rebreather?
- ✔️ Items are balanced on an underlying value logic
- If you prefer pure chaos, simply turn on Chaotic mode!
- ✔️ Share your seed with friends
- Install BepInEx
- Install Nautilus
- Extract this mod into your
Subnautica/BepInEx/pluginsfolder- (Optional) Edit the config in the in-game options menu to your liking
- Start a new game
- Enjoy!
git clone --recurse-submodules- NuGet should automatically download all dependencies for you. If it does not, perform a NuGet restore.
- (Optional) Create a
GameDirectory.targetsfile in the same folder as the freshly clonedSubnauticaRandomiser.csprojand add the path to your local Subnautica install directory to it. An example file can be found here.
- (Optional) Create a
- Building the project will leave you with a
SubnauticaRandomiser.dllin the default build directory. If you created aGameDirectory.targetsfile it will also automatically copy all necessary mod files to yourSubnautica/BepInEx/pluginsdirectory for quick testing.
Under the hood, the randomiser creates a new Unity GameObject for storing all randomisation logic. It then attaches Components as needed, depending on which config options are set. Only those Components which are actually needed are attached to the GameObject. Components primarily communicate via events, which means they do not rely on each other and can be individually turned on/off with no repercussions.
There are some basic Components that are responsible for steering the overall logic and are always attached. These are the Core Logic module and the Progression Manager. The core logic is what actually runs the main loop where game entities are randomised one by one, while the manager keeps track of overall game progression and ensures no softlocks. Events are invoked between the two of them as certain milestones are reached.
Here's a rough diagram of the overall structure and execution flow:
