ECC Library is a modding API for Subnautica and Subnautica: Below Zero that allows you to add fleshed-out creatures to the game without needing to reinvent the wheel each time, saving you hundreds of lines of code and hours of research.
ECC Library 2.0 is a complete rewrite of the original library, created in response to the "modpocalypse" update. The old version of ECCLibrary is no longer supported. ECC 2.0 converts the inheritance-forcing creature data system to a more robust object-oriented system called Creature Templates.
An example of a creature asset class in ECC 2.0 can be found here. Note that this example is much more complicated than it needs to be because I construct the prefab entirely through code instead of exporting a model out of the Unity Editor.
Creatures can also be created without using inheritance. This example is cleaner than the previous one because the prefab is defined in Unity.
De-Extinction for SN1 and Below Zero is also a great example with many fish ranging from small edible creatures to leviathans.
The XML documentation within the library is very elaborate and should provide sufficient information for setting up basic creature behaviours.
Nautilus, the new Subnautica Modding API.
Please check the releases tab on the right side of this page to find the latest version.
ECCLibrary is an open-source mod and contributions are always welcome. If you are interested in contributing to the project, there are several ways to do so.
One way to contribute is to submit bug reports and feature requests through the issue tracker on GitHub. This helps the ECCLibrary team understand what features, changes and/or fixes are needed.
If you would like to build the project, follow the steps below to set up the environment:
- Fork or clone the repository.
- Open the
ECCLibrary.slnfile with an appropriate IDE (Visual Studio, Rider, etc.,). Locate theGameDir.targetsfile, open it, and replace the GameDir path with the correct path to your Subnautica folder.Ensure the NuGet packages are loaded correctly. You may need to right click the Solution at the top of the Solution Explorer and chooseRestore NuGet Packages.Build the solution. A folder named ECCLibrary should be automatically placed in your BepInExpluginsfolder.If that does not work, double check the Nautilus reference path in the csproj file.
The project structure is being changed so currently you have to manually copy the file. Sorry for the confusion!