If your local mods are not appearing or cause the game to crash, use this checklist to fix the problem:
You downloaded a mod from GitHub or the ONI Discord that isn't on the workshop.
: If the local folder does not exist within the mods directory, you must create it manually. 2. Download and Extract the Mod
: Launch the game, click the Mods button on the main menu, and ensure your local mod is enabled. Common Pitfalls to Avoid oxygen not included how to install mods manually
Final path example:
If your additions fail to appear in the menu or cause the game to crash during startup, review these common failure points.
(If your OS/store location differs—Epic, GOG, custom—replace the Steam game path accordingly; per‑user local mods folder under Documents/Klei is still used for builtin loader.) If your local mods are not appearing or
Warning: Do not let your extraction software nest folders (e.g., .../local/SpeedControl/SpeedControl/mod.dll ), or the game will fail to recognize the mod. Step 4: Enable the Mod In-Game
Welcome to the world of manual mod installation.
OxygenNotIncluded/Mods/ └── BetterBatteries/ ├── mod.yaml ├── BetterBatteries.dll └── strings/ └── strings.po Download and Extract the Mod : Launch the
Note: If the local folder does not exist inside the mods folder, you must create it manually. 2. Prepare the Mod Files
: %USERPROFILE%\Documents\Klei\OxygenNotIncluded\mods\local
Oxygen Not Included (ONI) by Klei Entertainment is a deep, complex space-colony simulation. While the base game offers hundreds of hours of challenge, the modding community has breathed new life into it—adding quality-of-life features, new buildings, and entirely new mechanics.
~/Library/Application Support/unity.Klei.Oxygen Not Included/mods/ (Mac) ~/.config/unity3d/Klei/Oxygen Not Included/mods/ (Linux)