Home

ONI Modding Wiki

Welcome to the Oxygen Not Included modding wiki. This wiki has two parts:

• ONI Modding Guide - General-purpose tutorials, game data reference, and gotchas for anyone modding ONI
• Shikyo's Mods - Documentation and APIs for mods in this repo (DuplicantStatusBar, etc.)

---

ONI Modding Guide

ONI mods are C# class libraries using Harmony 2.0 to patch the game at runtime (.NET Framework 4.7.1). No official modding API - you decompile, intercept, and patch.

Getting Started

1. Getting Started - Prerequisites, tools, environment setup
2. Mod Structure - Folder layout, mod_info.yaml, loading pipeline
3. Harmony Patching - Core technique: prefix, postfix, transpiler
4. Debugging - Player.log, dnSpy, common errors

Tutorials

• Gameplay Tweaks - Common patterns: stats, buildings, recipes
• Creating Buildings - IBuildingConfig, tech tree placement
• New Content - Items, elements, creatures, kanim pipeline
• UI Modding - uGUI, KScreens, overlays
• Mod Configuration - PLib options and settings screens
• Publishing - Steam Workshop, versioning

Game Data Reference

Indexed tables extracted from Assembly-CSharp.dll - use instead of ad-hoc decompilation.

Game Data Index - Master index with all data tables

Key tables: Elements · Buildings · Skills · Traits · Effects · Components · Chore Types · Rooms

Reference

• Key API Reference - Commonly used game classes and methods
• Gotchas - Collected pitfalls for ONI modding
• Community Resources - Links, tools, other mods

---

Shikyo's Mods

DuplicantStatusBar

RimWorld-style colonist bar for ONI - stress-colored borders, expression-driven portraits, alert badges, hover tooltips.

• Steam Workshop

API for mod developers:

• API Overview - What the DSB API offers and how to get started
• Custom Alerts - Register custom alert detectors with badges
• Tooltip Hooks - Append custom stat lines to hover tooltips
• Events - React to alert changes, widget lifecycle, bar visibility
• API Reference - Complete method and type reference

---

Quick Links: Source Code · Report Issues