Nautilus

Nautilus

sell 1.0.0-pre.56bolt Auto Auto-updates from GitHubLast synced Nov 08, 2026 07:08 UTC
by SubnauticaModding
tag 30 OpenMods mod ID Reference it in openmods.json (add-on-of, dependencies) link github.com/SubnauticaModding/Nautilus

Nautilus, the Subnautica Modding API (formerly SMLHelper)

visibility 301 Views
download 187 Downloads
schedule Updated Nov 08, 2026
descriptionREADME.md

Nautilus: Subnautica Modding API

banner

NuGet Discord GitHub contributors License


Contents


About

Nautilus is the core modding library for Subnautica and Subnautica: Below Zero. It offers many simple helpers and utilities for interacting with the game, allowing for easy implementation of content.

Some notable features and techniques that Nautilus allows for are:

  • Adding new items, decorations, base modules, tools, and other prefabs
  • Regstering custom biomes, spawning objects in the world
  • In-game mod configuration in the Subnautica style
  • Adding sounds and replacing existing audio
  • Registering new story events: voice logs, PDA entries, story triggers, etc.
  • Setting up materials and shaders as accurately as possible
  • Registration utilities to help with making larger mods scaleable

This project is a continuation of SMLHelper with an improved codebase and maintainability. Nautilus offers all the features SML used to offer with a more robust implementation. Additionally, Nautilus took a different route for managing handlers to address many bugs and timing issues that were persistent in SML.

We hope to keep improving the modding experience in Subnautica to allow developers to create mods more easily and eliminate the implementation concerns in the mod-making process. For more information on Nautilus and its capabilities, please refer to our documentation.

⚠️ Nautilus will only receive continued support for the latest version of Subnautica


Installation

  1. Download the Subnautica BepInEx Pack.

  2. Extract/unzip the BepInEx x64 zip file to your game folder

    • Where is my Subnautica/game folder? (Click to expand)
      • Steam:         C:\Program Files (x86)\Steam\steamapps\common\Subnautica
      • Epic Games:   C:\Program Files\Epic Games\Subnautica
      • Xbox PC:       C:\XboxGames\Subnautica\Content
      Note: the above paths are the default locations, yours may vary
    • How do I extract the zip file? (Click to expand)
      • Extracting/unzipping a zip file is as simple as right clicking it, and selecting the Extract here prompt. We highly recommend the use of a zipping tool besides the Windows default one, such as WinRAR, or 7-Zip
  3. Download Nautilus from Nexus Mods or GitHub Releases

  4. Extract/unzip the Nautilus zip file to your Subnautica\BepInEx folder

  5. Confirm your Subnautica\BepInEx\plugins now looks like this:

    If it doesn't look like this, try figuring out where your Nautilus folder has gone, and move it into the plugins folder

    Screenshot of plugins folder

  6. Launch the game, and enjoy! (a good way to confirm Nautilus has loaded is to check the game Options for a Mods tab)

If you have any trouble installing the mod, please join our Discord server, and explain whats going on in a help and support channel.


Nautilus Documentation (source) - API docs, guides for getting started, and detailed tutorials

Development Setup Guide - Start here for your first mod

Updating to Nautilus from SMLHelper - For updating older mods

Subnautica Modding Discord Server - The best place to discuss making mods for Subnautica


Contributors

To everyone who has taken the time to contribute to Nautilus and/or SMLHelper, we cannot thank you enough!

Table of contributors ❤️


Contributing

We welcome all kinds of contributions; simply ensure you have read through our Contribution Guidelines before submitting a pull request.

If you are not capable of writing code, but have feature ideas or bug reports, feel free to submit an issue instead.

forum Comments 0 comments

Join the conversation

lock

Log in to join the conversation

Connect with GitHub to post comments and react.

chat_bubble_outline

No comments yet — be the first to share your thoughts.

Versions

View All
package_2 Nautilus_SN.STABLE_1.0.0.56.zip
452.7 KB Sign in to download Install via OpenModsManager
package_2 Nautilus_BZ.STABLE_1.0.0.56.zip
420.2 KB Sign in to download Install via OpenModsManager
Requires

No required dependencies

Project Metadata

star Downloads

187

visibility Views

301

Tags

sell No tags yet
View on GitHub

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.