subnautica-ii-coop-bepinex-mod

Configures a BepInEx multiplayer mod for Subnautica 2 with session sync and shared inventory.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill subnautica-ii-coop-bepinex-mod-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subnautica-ii-coop-bepinex-mod
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/subnautica-ii-coop-bepinex-mod
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill subnautica-ii-coop-bepinex-mod-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Subnautica 2 ships without native co-op support, so players who want synchronized multiplayer sessions, shared inventories, and adaptive difficulty must install and configure a BepInEx-based mod stack manually, which involves networking, state sync, and config tuning. ## Core Features & Use Cases - Session Hosting & Joining: Create or join WebRTC P2P sessions with shareable session codes, NAT punch-through, and configurable ports and STUN servers. - State Synchronization: Keep inventories consistent across players using Merkle tree verification with conflict resolution and forced resync commands. - Adaptive Difficulty & AI Narration: Scale creature spawns, resources, and oxygen by player count, and optionally generate narrative journal entries via OpenAI or Claude APIs. - Use Case: A group of four friends installs BepInEx, drops the DeepSynergy plugin into the plugins folder, edits synergy_profile.json to set max_players and difficulty scaling, then hosts a session and shares the session code to play together. ## Quick Start Set up the Subnautica 2 co-op mod by installing BepInEx, placing the DeepSynergy plugin in the plugins folder, and configuring synergy_profile.json for a four-player session.

Frequently Asked Questions about subnautica-ii-coop-bepinex-mod

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the Subnautica 2 co-op mod?▼

Install BepInEx 6.0.x into the Subnautica 2 game directory, then extract the DeepSynergy mod into BepInEx/plugins/DeepSynergy. Edit BepInEx/config/synergy_profile.json to set session name, max players, and difficulty options before launching the game.

How to host a multiplayer session in Subnautica 2?▼

Open the BepInEx console with F1 and run /start_server to create a session, which returns a shareable session code. Other players join with /join_session followed by that code, using WebRTC with STUN for NAT traversal.

Does the mod support shared inventory across players?▼

Yes, inventory state is synchronized using Merkle tree verification to detect mismatches between players. Conflicts are resolved by timestamp authority, and you can force a full resync with the /sync_inventory console command.

Why can't players connect to my Subnautica co-op session?▼

Connection failures usually come from blocked port 25000, firewall rules on Subnautica2.exe or BepInEx, or mismatched mod versions. Enable debug_mode in the config and check BepInEx/LogOutput.log for WebRTC timeout or version mismatch errors.

Can I use OpenAI narration with the Subnautica mod?▼

Yes, set api_integration.openai.enabled to true in synergy_profile.json and define the OPENAI_API_KEY environment variable. The /api_narrate command then generates short journal entries from gameplay context using the configured model.

What are the limitations of the BepInEx co-op mod?▼

The mod supports 2 to 8 players and requires BepInEx 6.0.x IL2CPP with matching versions on all clients. It conflicts with other multiplayer or inventory mods, and performance with 3+ players may require raising creature_spawn_divider or disabling API features.