Mods

Early support for standalone mods has been implemented in Cobalt.

File replacement

You can reproduce the hierarchy of the romfs (/Data/StreamingAssets/...) inside of your mod folder to replace files in the game while keeping them separate from other mods.

Note

There is currently no form of conflict management, so if multiple mods replace the same file, the last one being loaded will prevail.

Merging

XML files from the fe_assets_gamedata directory can be merged for you at runtime provided you place them in the right directory.
Patches go in ./patches/xml/ relative to your mod's root directory, should be unbundled, and have an .xml extension.

Check the gamedata merging page for more details.

MSBT files can also be merged. Check the MSBT merging page.

Configuration file

Starting with Cobalt v1.9.0, mods can provide a configuration file named config.yaml at the root of the directory.

# A unique ID to identify your mod. Make sure that it is distinct enough that you do not risk having the same as another mod
id: raytwo.cobalt.sommieparty
# The name of your mod. Unused for now, but might be useful in a future update.
name: The Greatest Mod That Ever Lived
# The description of your mod. Unused for now, but might be useful in a future update.
description: Turn every character into Sommie
# Who worked on the mod
author: Raytwo, Ray2
# Any mod that NEEDS to be loaded before yours can be listed here. If the user does not have this mod, yours will simply not be loaded.
# Assuming you do not depend on anything, you can omit this field.
dependencies:
- raytwo.cobalt.sommie
- dogethis.cobalt.vibratingthighs

If you do not depend on another mod, your configuration would look something like this:

# A unique ID to identify your mod. Make sure that it is distinct enough that you do not risk having the same as another mod
id: raytwo.cobalt.sommieparty
# The name of your mod. Unused for now, but might be useful in a future update.
name: The Greatest Mod That Ever Lived
# The description of your mod. Unused for now, but might be useful in a future update.
description: Turn every character into Sommie
# Who worked on the mod
author: Raytwo, Ray2