Subsystem is a mod loader for Homeworld: Deserts of Kharak. It aims to have a safe, auditable and data-oriented design.

Place Subsystem.dll and BBI.Unity.Game.dll in the Deserts of Kharak/Data/Managed/ folder.

BBI.Unity.Game.dll already exists and should be overwritten. You can make a backup of this file if you'd like.

Create a JSON file like this:

{
  "Entities": {
      "C_Escort_MP": {
        "WeaponAttributes": {
          "C_Escort_Weapon_G2G_MP": {
            "BaseDamagePerRound": 14,
            "ExcludeFromHeightAdvantage": true
          }
        },
      },
      "G_Baserunner_MP": {
        "UnitAttributes": {
          "MaxHealth": 3500,
          "Armour": 3,
          "Resource1Cost": 225,
          "ProductionTime": 18.0
        }
      },
      "Tier_3_C_Artillery": {
        "ResearchItemAttributes": {
          "Resource2Cost": 150,
          "ResearchTime": 45.0,
          "Dependencies": [
            "Tier_2_C_ArmouredAssault"
          ]
        }
      }
  }
}

Save the file and place it at Deserts of Kharak/Data/patch.json. The filename and location must match exactly.

Note that the keys (Entities, UnitAttributes, etc) are case-sensitive.

The stats are reloaded at the beginning of every game,

To use this in multiplayer, all players in the game must have the same version of Subsystem and the same patch.json file contents. If any player has different data, the game is liable to crash with a synchronization error.

See the patch source files for a list of attributes that can be modified: https://github.com/AGameAnx/Subsystem/tree/master/Subsystem/Patch

These gist show dumps of all named entity components:

https://gist.github.com/Majiir/1c78930ad70a16e1bd9a116948f55409

https://gist.github.com/Majiir/7af5032b89eea5f5b141fdec17faafc8

• Some enums are marked with [Flags]. You must use a particular syntax in order to assign multiple flags. For example, to set a unit's Class to multiple values:

...
"UnitAttributes": {
  "Class": "Hover, Carrier"
}
...

• Non-flags enums should be set as strings. (Example: "HackableProperties": "InstantHackable")

• Fixed64 values are set as Numbers (equivalent to double) in JSON. This is technically a lossy conversion, but it will work well in most circumstances.