Oxygen Not Included

Oxygen Not Included

Ranching Overhaul
 This topic has been pinned, so it's probably important
heihei  [developer] 6 Jan, 2022 @ 2:17am
A little tutorial on how to config
My config uses the JSON format. It is a structured format, meaning that it is easy for computers to read, but maybe not for humans. You are better off with a specialized editor than the Windows Notepad. There are hundreds of JSON online editors, you can use any one you like.
for example: JSON Editor Online [jsoneditoronline.org]
Open the RanchingOverhaulConfig.json file located in Documents/Klei/OxygenNotIncluded\mods, and use the tree view rather than the code view. It is much more intuitive. Left of the colon in black is the name of the property, please DON'T MODIFY IT. Anything in Black should be kept as-is. Right of the colon is the value shown either in red or green, you can modify it to whatever you want. Now let's look at each property:
  • RanchingSpeedMult: in %. 0.4 means each level of husbandry increases station usage speed by 40%.
  • RanchingDurationMult: in %. 0.5 means each level of husbandry increases "Groomed" effect duration for 50% of a cycle.
  • RanchingExpBase: How much husbandry attribute exp you'll earn for one ranching related task (wrangling, using stations, etc.)
  • LullabyMult: in %. How much faster an egg incubates if it has the "Lullabied" effect.
  • HappyFertilityMult: in %. How much faster the critter makes eggs if it has the "Happy" effect.
  • CritterDropOffMaxAmount: self-explanatory.
  • CritterFeederCapacity: self-explanatory.


Next are the parameters for each critter. It would be impossible to read with windows notepad, so use an editor! Take JSON Editor Online for example, the critter configs are inside the "CritterConfigs" list. click on the triangle left to it, and the list will expand.
The first level of the list contains names of critters you can modify. These names are in-game codes and they can be different than their real names, but it is not hard to infer. Take "Hatch" for example, click the triangle left to it and you'll see all the parameters.
  • SpaceNeeded: How many tiles a critter needs. Quite self-explanatory.
  • FertilityCycle: How long it takes for a wild critter to lay an egg.
  • AdultThresholdInCycles : At what age a critter will be considered an adult. 5 means that they will be promoted to an adult at 5 cycles age. You can put this to 0 so they will immediately become adults after hatching.


"EggConfigs" and "DietConfigs" are the most daunting. See the square brackets [] next to them? It means that they are lists. You can add or remove the elements at will. Click the triangle next to "EggConfigs" of Hatches, you'll see 0, 1, 2. It means that there are three elements in the list, thus Hatches by default can lay three types of eggs. You can add/remove elements by clicking the square icon to the left, and a menu will show up containing options. click any triangle on the elements, and you'll see the parameters you can modify:
  • weight: the chance that the critter will lay this kind of egg.
  • egg: definition for egg type. click the triangle to expand. "Name" is what you want to change. Change it to whatever egg you like, and the critter will lay that.


In "DietConfigs":
  • ConsumedTags: Also a list. Use the left square icon to add/remove strings. Modify the green part to whatever item name in the game, and you critter will eat that.
  • ProducedItemTag: What it will poop.
  • CaloriesPerKg: the larger, the LESS your critter will eat.
  • ProducedConversionRate: ratio of output over input. Eating 100kg to get 50kg means a conversion rate of 0.5. Make it larger than 1 and your critter will violate the laws of Physics :D.
  • ProduceSolidTile: what Shove Voles do.
  • EatsPlantsDirectly: What Dreckos do.
Last edited by heihei; 9 Jan, 2022 @ 6:41am
< >
Showing 1-3 of 3 comments
Terrestris 7 Jan, 2022 @ 3:39am 
If I want everything set as vanilla besides getting exp from ranching, I need to set RanchingSpeedMult and RanchingDurationMult back to 1, right? Any other changes?
heihei  [developer] 7 Jan, 2022 @ 3:43am 
Originally posted by Terrestris:
If I want everything set as vanilla besides getting exp from ranching, I need to set RanchingSpeedMult and RanchingDurationMult back to 1, right? Any other changes?
I didn't think this through... The default values I provided in the config file are the values I liked. I should provide them in vanilla.
The vanilla values for your mentioned properties are both 0.1. LullabyMult and HappyFertilityMult should both be 0.
Last edited by heihei; 7 Jan, 2022 @ 3:43am
Terrestris 7 Jan, 2022 @ 8:16am 
Originally posted by heihei:
Originally posted by Terrestris:
If I want everything set as vanilla besides getting exp from ranching, I need to set RanchingSpeedMult and RanchingDurationMult back to 1, right? Any other changes?
I didn't think this through... The default values I provided in the config file are the values I liked. I should provide them in vanilla.
The vanilla values for your mentioned properties are both 0.1. LullabyMult and HappyFertilityMult should both be 0.

Thank you so much. I just want to play ONI in more vanilla style but tired of switching power of incubators and waiting lullabies of a century. :happy_yeti:
< >
Showing 1-3 of 3 comments
Per page: 1530 50