Modding

From Cobalt Core Wiki
Jump to navigation Jump to search

This page tells you how to download and install mods. For how to make mods, check out Making Mods.

Downloading mods

You can download mods from the following places:

Modding channel

Mod authors maintain threads in cc-mod-showcase to support their work. They will be often be downloaded as ZIP files, either as "attachments", or with a link to a hosting site. There may be experimental mods, out-dated mods and updates that don't work in the latest game versions; so make sure to check if a mod is up-to-date.

NOTE: It's hugely recommended for modders, both authors and players, to utilize the beta Steam branch of the game!

Dependencies

Some mods may require you to install other mods for them to work. While some mods can have optional dependencies, others can crash and be unplayable without the required dependency. It's best adviced to download all dependencies for a mod.

Mod Loader and Mod Setup

The Cobalt Core modding community, at the moment, is in a transition phase. Mods are being developed for Shockah's Nickel Mod Loader, while EWanderer's Cobalt Core Mod Loader is the legacy mod loader.

Nickel Mod Loader

NOTE: The Nickel mod loader is in constant development, so be mindful and check for updates often. Here are the instructions to setup Shockah's Nickel Mod Loader to play with nickel and legacy mods:

  • Download the latest Nickel release.
  • Create a new folder named ModSaves inside Nickel's extracted folder.
  • Go to the Cobalt Core game files
    • Windows: Press WIN+R and type %appdata%/CobaltCore
    • Linux: Go to $STEAM_PATH/steamapps/compatdata/2179850/pfx/drive_c/users/steamuser/AppData/Roaming/CobaltCore
  • Copy-paste your Slot0/Slot1/Slot2 folders to ModSaves (These are your save files. (Do not delete them by accident!!)
  • Run the NickelLauncher.exe file (on Linux, do this via Proton).
    This will open a console window and in a few moments the game will open! (Of note: The game opens in DEBUG mode)

Legacy Mod Loader

WARNING: It's not recommended to utilize the legacy Mod Loader, we would recommend Nickel instead. However, you're free to use it if you like. Here are the instructions to setup EWanderer's Cobalt Core Mod Loader to play with legacy mods:

  • Download the latest release (Make sure to only download the ZIP file, not the source) and unzip it.
  • Create two new folders named ModSaves and ModLibrary inside the extracted folder.
  • Go to the Cobalt Core game files (For Windows it can be found by pressing WIN + R and typing %appdata%/CobaltCore) and copy-paste your Slot0/Slot1/Slot2 folders to ModSaves. These are your save files. (Do not delete them by accident!!)
  • Run the Cobalt Core Mod Loader .exe file. This will open an app window.
  • Press the 'Locate Game' button to locate the game's files. If this doesn't work, find the game files (In Steam this can be done by right-clicking the game in your Steam Library -> Manage -> Browse local files), and copy-paste it into the box such that it looks something like this: X:\Program Files (x86)\Steam\steamapps\common\Cobalt Core\CobaltCore.exe
  • Press the 'Launch Cobalt Core' button, and it should start the game!

Installing Mods

  • Find and download a mod you want to play.
    • Check the mod description and latest release date. If a mod says it was made for the Nickel Mod Loader IT WON'T work for the Legacy Mod Loader.
    • If a mod was made for the Legacy Mod Loader, 9 times out of 10 these mods will work in the Nickel Mod Loader by following the steps shown here.

Legacy Mod Loader Steps:

  • Unzip the downloaded .zip file.
  • Make sure the extracted folder is named the same as the .dll inside it. If the names are different, rename the folder to match the .dll file.
  • Move the mod folder inside the ModLibrary folder you created earlier. The file direction should look something like this: \CobaltCoreModLauncher\ModLibrary\MyMod\MyMod.dll
  • Run the Cobalt Core Mod Loader .exe file.
  • Press 'Load Folder' and feed it the ModLibrary folder. After doing so, the mod should appear in the Mod List.
  • Press the 'Launch Cobalt Core' button, and now the mod should be active!
  • Repeat the first 3 steps for any mods you want to play with.

Nickel Mod Loader Steps:

  • Is the mod made for the Nickel Mod Loader? If so, drop the zip file inside the ModLibrary folder. The file direction should look something like this: \Nickel\ModLibrary\MyMod.zip
  • If the mod was NOT made for the Nickel Mod Loader:
    • Unzip the downloaded .zip file.
    • Make sure the extracted folder is named the same as the .dll inside it. If the names are different, rename the folder to match the .dll file.
    • Move the mod folder inside the ModLibrary folder. The file direction should look something like this: \Nickel\ModLibrary\MyMod\MyMod.dll
    • Run the NickelLauncher .exe file, wait for the game to finish loading, and close it. This is an important step for certain mods.
  • Run the NickelLauncher .exe file. Now the mod should be loaded and playable!
  • Repeat the first two steps for any mods you want to play with.