This mod allows users (and developers) to easily create custom recipes, items & schematics, and more, or modify existing ones from any mod! Custom content of your own design is only a couple of JSON files away! Developers can also leverage the ContentLib API to generate or modify content at runtime.
Read the documentation here for more detailed info on how to use the mod.
Questions? Suggestions? Join the Nog's Mods Discord server or leave an issue on the GitHub issues page (slower response time)
ContentLib itself supports multiplayer and dedicated servers as long as all sides have the same content definitions. Other mods that depend on ContentLib may not support multiplayer, so check the mod page or ask the mod author.
You can use ContentLib for your own personal edits, but you can also easily distribute your scripts as mods for others to use.
To get an idea of what ContentLib is capable of, check out a few existing mods that use ContentLib:
- RePan - Oil by McGalleon
- Recipe Maker, Auto Packing, Building Kits, Hide Researched Milestones, Recipe Randomizer, and more by Andre Aquilla
- ContentInfo by Nog
- Useful Liquid Biofuel by Jarno458
- No Package For Fluid by jimmon89
- Ethical Power Slug Treatment by LordOcram
If you'd like to do this, check out the docs to get started.
Creating your own Items (or Liquids/Gasses) is as simple as creating a JSON file, placing it in the correct directory, and launching the game.
You can also modify existing Items from any mod in a similar manner.
Check out the docs to get started.
Creating a new item is this simple, as long as you're fine with re-using meshes.
Below is an example of a freshly created Item and a screenshot of it within the game.
{
"$schema": "https://raw.githubusercontent.com/budak7273/ContentLib_Documentation/main/JsonSchemas/CL_Item.json",
"Name": "Gold Too",
"VisualKit": "Desc_OreGold_C",
"Description" : "This is a new Item which re-uses the visuals of Caterium Ore!"
}
Remember that you still need a recipe somewhere that produces the item, or the game will not load it.
Check out the docs to get started.
In addition to creating new items, you can also use ContentLib to modify existing items, both base-game items and those added by other mods.
Below is an example modification of the base game's "Caterium Ore" item, which is named OreGold internally. With the power of ContentLib Items, you can reveal who's really behind that mask - Gold Ore!
This example replaces the item name and description, but you can modify other fields, too.
//Game/FactoryGame/Resource/RawResources/OreGold/Desc_OreGold.Desc_OreGold_C
{
"$schema": "https://raw.githubusercontent.com/budak7273/ContentLib_Documentation/main/JsonSchemas/CL_Item.json",
"Name": "Gold Ore",
"Description" : "Surely not Caterium Ore. Couldn't be!"
}Check out the docs to get started.
Creating your own recipes is as simple as creating a JSON file, placing it in the correct directory, and launching the game.
You can also modify existing recipes in a very similar manner.
Check out the docs to get started.
Here's an example recipe for the Blender made by McGalleon.
{
"$schema": "https://raw.githubusercontent.com/budak7273/ContentLib_Documentation/main/JsonSchemas/CL_Recipe.json",
"Name": "Synthetic Crystal",
"Ingredients": [
{
"Item": "Desc_RawQuartz",
"Amount": 16
},
{
"Item": "Desc_QuartzCrystal",
"Amount": 7
},
{
"Item": "Desc_Water",
"Amount": 4800
}
],
"Products": [
{
"Item": "Desc_QuartzCrystal",
"Amount": 20
}
],
"ManufacturingDuration": 8,
"ProducedIn": ["Build_Blender"],
"UnlockedBy": ["Schematic_1-1"]
}
Check out the docs to get started.
In addition to creating new recipes, you can also use ContentLib to modify existing recipes, both base-game recipes and those added by other mods.
Below is an example modification of the base game's Biofuel recipe. The recipe display name is changed to BioFuel Override and the recipe now consumes 1 Coal to produce 10 Biofuel instead.
//Game/FactoryGame/Recipes/Constructor/Recipe_Biofuel.Recipe_Biofuel_C
{
"$schema": "https://raw.githubusercontent.com/budak7273/ContentLib_Documentation/main/JsonSchemas/CL_Recipe.json",
"Name": "BioFuel Override",
"Ingredients": [
{
"Item": "Desc_Coal",
"Amount": 1
}
],
"Products": [
{
"Item": "Desc_Biofuel",
"Amount": 10
}
]
}Check out the docs to get started.
You can use ContentLib to create your own schematics, or edit existing ones!
This works for HUB Milestones, MAM Nodes, and AWESOME Shop items.
Check out the docs to get started.
You can also use ContentLib to perform (Class Default Object) CDO edits.
This is an advanced feature that is not easily summarized.
Check out the docs to get started.
Expand for more info on ContentLib CDO Edits
Edit the properties of an item without using the ContentLib Item system.
{
"$schema": "https://raw.githubusercontent.com/budak7273/ContentLib_Documentation/main/JsonSchemas/CL_CDO.json",
"Class": "/Game/FactoryGame/Resource/Parts/GoldIngot/Desc_GoldIngot.Desc_GoldIngot_C",
"Edits": [
{
"Property": "mDisplayName",
"Value": "Gold Ingot"
},
{
"Property": "mInventoryIcon",
"Value": {
"ImageSize": {
"X": 255,
"Y": 255
},
"Margin": {
"Left": 0,
"Top": 0,
"Right": 0,
"Bottom": 0
},
"TintColor": {
"SpecifiedColor": {
"R": 1,
"G": 1,
"B": 1,
"A": 2
},
"ColorUseRule": 0
}
}
}
]
}Edit the ingredients of a recipe without using the ContentLib Recipe system.
{
"$schema": "https://raw.githubusercontent.com/budak7273/ContentLib_Documentation/main/JsonSchemas/CL_CDO.json",
"Class": "/Game/FactoryGame/Recipes/Blender/Recipe_FusedModularFrame.Recipe_FusedModularFrame_C",
"Edits": [
{
"Property": "mIngredients",
"Value": [
{
"ItemClass": "/Game/FactoryGame/Resource/Parts/ModularFrameHeavy/Desc_ModularFrameHeavy.Desc_ModularFrameHeavy_C",
"Amount": 643
},
{
"ItemClass": "/Game/FactoryGame/Resource/Parts/AluminumCasing/Desc_AluminumCasing.Desc_AluminumCasing_C",
"Amount": 245
},
{
"ItemClass": "/Game/FactoryGame/Resource/RawResources/NitrogenGas/Desc_NitrogenGas.Desc_NitrogenGas_C",
"Amount": 123
}
]
}
]
}Change the parent of a blueprint.
{
"$schema": "https://raw.githubusercontent.com/budak7273/ContentLib_Documentation/main/JsonSchemas/CL_CDO.json",
"Class": "/Game/FactoryGame/-Shared/Material/MI_Factory_Base_01.MI_Factory_Base_01",
"Edits": [
{
"Property": "Parent",
"Value": "/AdaptingGenerators/Assets/MM_FactoryCopy.MM_FactoryCopy"
}
]
}Check out the docs to get started.
Icons by deantendo#4265