ContentLib

ContentLib

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 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)

_If you enjoy my work, please consider donating to my completely optional tip jar._

Multiplayer Support

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.

Examples

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:

<!-- cspell:disable -->

• RePan - Oil by McGalleon
• FICSIT Expert Expansion - FexPan 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

<!-- cspell:enable -->

If you'd like to do this, check out the docs to get started.

ContentLib: Items

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.

Custom Item Example

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.

Item Patching Example

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.

ContentLib: Recipes

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.

Example Complex Recipe

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.

Recipe Patching Example

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.