Skip to Main Content

Oxygen Not Included How To Install Mods Manually |best| -

Mastering the Chaos: The Definitive Guide to Manually Installing Mods in Oxygen Not Included

For many colonists, the cycle is simple: you download a mod from the Steam Workshop, it updates automatically, and you go back to suffocating your dupes in style. But what happens when you don’t use Steam? What happens when a Steam update breaks your favorite total conversion mod? Or when you want to preserve a specific version of a mod because the developer just removed your favorite feature?

All of these have been ported to manual downloads on the Klei forums. oxygen not included how to install mods manually

Pro Tip: Some GitHub mods are in "development" (pre-release). Look for a mod_info.yaml file inside the folder. If it's missing, the mod will not work. Mastering the Chaos: The Definitive Guide to Manually

Final Checklist: Successful Manual Install

✅ Game is closed before moving files.
✅ Mod files extracted and contain mod.yaml.
✅ Folder placed in Documents/Klei/OxygenNotIncluded/mods/local/.
✅ No nested folders (correct: local/MyMod/mod.yaml – incorrect: local/MyMod/old/mod.yaml).
✅ Game launched, local mods tab checked, mod enabled.
✅ Game restarted after enabling. Download the latest ONI‑Modloader release from its GitHub

  1. Download the latest ONI‑Modloader release from its GitHub (e.g., Javisar/ONI‑Modloader).
  2. From the downloaded package copy ModLoader.dll (and accompanying Managed folder files) into the game Managed folder: 
    C:\Users\[YourUsername]\Documents\Klei\OxygenNotIncluded\mods
    • Windows: %PROGRAMFILES(X86)%\Steam\steamapps\common\OxygenNotIncluded\Mods\

    | Folder Name | Purpose | Use Case | | :--- | :--- | :--- | | Steam | Automatically managed by Steam Workshop. Do not touch this folder for manual installs. | Steam users. | | Local | For manually installed mods. This is where your files go. | All manual installations. |

    Crashing on Startup: This usually means the mod is outdated or missing a dependency (like PLib). Check the mod's documentation to see if it requires a specific "library" mod to function.