Subnautica 2 · UE4SS library
Subnautica2 API Library (S2ML)
A shared UE4SS Lua framework for Subnautica 2 mod creators. It supplies reusable helpers for events, player access, inventory, item and recipe registration, world operations, saves, notifications, and sounds. Players can install it when another mod requires the library; developers can use its dependency bridge and starter template to build on the shared APIs.
- Publication
- Published on CurseForge
- Completion
- Published release; future updates may continue
- Game
- Subnautica 2
- Listed compatibility
- Early Access 1 - Release
- Listed release
- S2ML.zip
- Last listed update
- 2026-05-18
- Project ID
- 1546903
Release details checked September 30, 2026. CurseForge lists the current files, dependencies, and supported versions.
What you can do
Players install this dependency when a mod requires it. Developers can start with the supplied template and use the event, inventory, save, and runtime discovery helpers instead of repeating low-level integration code.
- Event-driven mod APIs
- Inventory and player helpers
- Item, recipe and tech registration
- Save utilities and runtime discovery
Project visuals
Official project artwork. Browse the CurseForge gallery ↗ — opens in a new tab
Get started
Installation & setup
- Install a compatible UE4SS Lua runtime for Subnautica 2; the project recommends UE4SS 3.0.1.
- Download and extract S2ML from the Files tab, then copy the included files into the game’s UE4SS Mods folder.
- Check that ue4ss/Mods/S2ML/ and ue4ss/Mods/shared/S2MLBridge.lua exist. Enable S2ML : 1 in mods.txt before mods that depend on it.
- Start the game and follow the dependent mod’s instructions. Early Access updates can change internal names; consult the release notes if a mod stops loading.
Read the official instructions & release notes ↗ — opens in a new tab
Need help with Subnautica2 API Library (S2ML)?
Include the addon release, game version, steps to reproduce, and any error message.