Oxygen Not Included How To Install Mods Manually Instant
The mod folder location depends on your operating system. Manual mods are not placed in the game’s installation folder.
| Platform | Path |
|----------|------|
| Windows | %LocalAppData%\..\LocalLow\Klei\Oxygen Not Included\mods\ |
| macOS | ~/Library/Application Support/unity.Klei.Oxygen Not Included/mods/ |
| Linux | ~/.config/unity3d/Klei/Oxygen Not Included/mods/ |
Note:
%LocalAppData%typically expands toC:\Users\<YourUsername>\AppData\Local.
TheLocalLowdirectory is insideAppData.
Cause: Missing dependencies. Some mods require other mods to work. oxygen not included how to install mods manually
Common Dependencies:
Fix: Manually install the dependency mod first, restart, then install your target mod.
| Problem | Likely Fix |
|---------|-------------|
| Mod not appearing in Local tab | Ensure mod.yaml exists and is correctly formatted (open in Notepad – should have title:, version:, etc.). Also check folder path – it must be exactly .../OxygenNotIncluded/Mods/ModName/mod.yaml. |
| Game crashes on load | Remove mod. Likely outdated or incompatible with DLC/game version. Check game log: Documents/Klei/OxygenNotIncluded/Player.log. |
| Mod shows but doesn’t work | Missing dependencies (some mods require “Mod Loader” or “Plib”). Install required libraries first. |
| After update, mod broken | Wait for mod author to update, or manually edit mod.yaml to bump minimumSupportedBuild (not recommended). | The mod folder location depends on your operating system
Launch the game once, then close it. Klei’s engine creates the folder automatically. If not, create a new folder named exactly mods (lowercase) inside the OxygenNotIncluded directory.
| Problem | Likely Cause | Solution |
| :--- | :--- | :--- |
| Mod does not appear in Local tab | Wrong folder path or nested folder | Re-read Step 3. Ensure mod.yaml is directly inside the mod folder. |
| Game crashes on startup | Mod is outdated for your game version | Remove the mod folder. Find an updated version or an alternative. |
| Mod shows as "Incompatible" | Mod uses an older API version | You can often force enable it (checkbox), but expect instability. |
| Mod works but causes errors | Conflict with another mod | Enable mods one by one to find the conflict. |
Cause: The game updated, and the mod developer hasn't released a patch. Cause: Missing dependencies
Fix:
Many complex mods require PLib (a modding library) or Mod Manager by @PeterHan. You must install these before the main mod.
To install PLib manually:
Warning: The game loads mods in alphabetical order. If you face crashes, rename PLib’s folder to 0_PLib so it loads first.