Oxygen Not Included How To Install Mods Manually May 2026
Installing mods manually for Oxygen Not Included (ONI) is often necessary for players on the Epic Games Store or those using standalone versions who cannot access the Steam Workshop directly. 1. Locate Your Local Mods Folder
ONI looks for manual mods in a specific "Local" directory rather than the Steam-managed folders. You must navigate to the appropriate path based on your operating system: %USERPROFILE%\Documents\Klei\OxygenNotIncluded\mods\Local\
/Users/[USERNAME]/Library/Application Support/unity.Klei.Oxygen Not Included/mods/Local/ ~/.config/unity3d/Klei/Oxygen Not Included/mods/Local/ folder does not exist within the directory, you must create it manually. 2. Prepare the Mod Files When you download a mod manually (from sources like Steam Workshop downloader ), it usually arrives as a Klei Entertainment Forums Extract the Zip
: Unzip the contents into a new, dedicated folder named after the mod. Verify Structure : Open your new mod folder. You should see a mod_info.yaml file, and typically a : Avoid "double-nesting" (e.g., mods/Local/MyMod/MyMod/files
). The game will not recognize the mod if its core files are buried too deep. 3. Install the Mod Move your prepared mod folder (containing the files) directly into the folder you found in Step 1. 4. Enable In-Game
Once the files are in place, you must activate them within the game client: Oxygen Not Included from the main menu.
Find your manually added mod in the list (it may be labeled under a "Local" category). button next to it. Restart the game oxygen not included how to install mods manually
to apply the changes. Most mods require a full restart to load their code properly. Steam Community How to install mods for Oxygen not included (on Steam)
How to Manually Install Mods for Oxygen Not Included While the Steam Workshop is the easiest way to manage your colony's upgrades, players using the Epic Games Store
version or those who prefer manual control can still install mods easily. This guide walks through finding your local directory and getting your mods up and running. 1. Locate the Correct "Local" Folder
Oxygen Not Included (ONI) looks for manual mods in a specific
folder within your user data directory. You may need to create this folder if it doesn't already exist. %USERPROFILE%\Documents\Klei\OxygenNotIncluded\mods\local
~/Library/Application Support/unity.Klei.Oxygen Not Included/mods/local ~/.config/unity3d/Klei/Oxygen Not Included/mods/local 2. Prepare the Mod Files Installing mods manually for Oxygen Not Included (ONI)
Manual mods must be placed in individual subfolders to load correctly. your desired mod from a source like
or use a third-party tool to download files from the Steam Workshop. Extract the ZIP file. You should see files like mod_info.yaml , and often a Create a subfolder inside the directory named after the mod (e.g., .../mods/local/TrueTiles/ Move the files
into this new subfolder. Avoid "double-nesting" (e.g., ensure it isn't .../local/TrueTiles/TrueTiles/mod.yaml 3. Enable the Mods In-Game
Simply placing the files in the folder won't activate them; you must enable them through the game's UI.
To manually install mods for "Oxygen Not Included" (ONI), you'll need to follow these steps. This guide assumes you have basic knowledge of navigating your computer's file system and that you have already purchased and installed the game on Steam.
Paths you may need
- Steam builtin (per‑user Steam mods and local mods)
- Windows (local mods): %USERPROFILE%\Documents\Klei\OxygenNotIncluded\mods\local\
- Steam workshop content: %PROGRAMFILES(X86)%\Steam\steamapps\workshop\content\457140\ (Steam manages these)
- Logs: %USERPROFILE%\AppData\LocalLow\Klei\Oxygen Not Included\output_log.txt
- ONI installed under Steam (game install folder)
- Windows (game folder): %PROGRAMFILES(X86)%\Steam\steamapps\common\OxygenNotIncluded\
- Managed folder: ...\OxygenNotIncluded_Data\Managed\
- Mods folder (if using ONI-Modloader): ...\OxygenNotIncluded\Mods\
- Mod loader log: ...\OxygenNotIncluded\Mods_Logs\ or ...\OxygenNotIncluded\Mods\Mod_Log.txt
- macOS
- Game resources: /Applications/OxygenNotIncluded.app/Contents/Resources/Data/Managed/ (or where installed)
- Mods for builtin: ~/Library/Application Support/Steam/steamapps/workshop/content/457140/ (Steam) and Documents folder for Klei similar to Windows
- Logs: ~/Library/Logs/Unity/Player.log
- Linux
- Game folder under steamapps/common/OxygenNotIncluded
- Logs: ~/.config/unity3d/Klei/Oxygen Not Included/Player.log
(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.) Steam builtin (per‑user Steam mods and local mods)
Step 3: How to Manually Install the Mod
You have downloaded a mod. It is likely a .zip file named something like PliersFix.zip or BlueprintsFixed.zip. Follow these steps precisely:
Step 2: Finding the Mods Folder
- Navigate to
steamapps/common/Oxygen Not Included/OxygenNotIncluded_Data/Modsin the file explorer. If theModsfolder does not exist, you'll need to create it.
2) Manually installing a mod for the Steam builtin loader (use this for local mods or non‑Workshop installs)
- Download the mod .zip or .rar from the mod author (GitHub, Nexus, Klei forum).
- Extract the mod so the top level is the mod folder (not an extra nested folder).
- The mod folder should contain files like manifest.json, assemblies (.dll) or Config folder, and other mod files.
- Copy the mod folder into:
- Windows: %USERPROFILE%\Documents\Klei\OxygenNotIncluded\mods\local\
- macOS/Linux: equivalent Documents/Klei/OxygenNotIncluded/mods/local/ (create directories if missing)
- Start the game. Check log at:
- Windows: %USERPROFILE%\AppData\LocalLow\Klei\Oxygen Not Included\output_log.txt
- macOS: ~/Library/Logs/Unity/Player.log
- Linux: ~/.config/unity3d/Klei/Oxygen Not Included/Player.log
Notes:
- Each mod should be its own folder. Do not merge multiple mods into one folder.
- Ensure manifest.json and any Config/*.json sit in the mod root as the author specifies.
For Windows (Alternative Path)
If the above doesn't work, check:
C:\Users\[YourUserName]\AppData\LocalLow\Klei\Oxygen Not Included\mods
Note: The AppData folder is hidden by default. If you can't see it, open File Explorer, click "View," and check "Hidden items."
Step 1: Locate the Mods Folder
The game stores all mods in a dedicated folder. Do not place mods inside the game’s installation directory (e.g., Program Files\Steam\...).
-
For Steam, Epic, or GOG on Windows:
%LocalAppData%\OxygenNotIncluded\mods\- Quick tip: Press
Windows + R, paste%LocalAppData%\OxygenNotIncluded\mods, and press Enter.
- Quick tip: Press
-
For Steam on Mac/Linux:
~/Library/Application Support/unity.Klei.Oxygen Not Included/mods/(Mac)
~/.config/unity3d/Klei/Oxygen Not Included/mods/(Linux)
Inside this mods folder, you may see a Steam folder. Ignore it. That is for automatic Workshop mods. For manual mods, you will work directly inside the mods folder.
