Using Construct Mod Loader

Mod Merger 🔗
Say goodbye to conflicts! CML uses a merging method similar to GitHub - but without the requisite user input. This helps to make File Modding easier, and allows for more mods to work to be installed at the same time without picking and choosing.
Incompatibility Detector 🔗
Don't know what's conflicting? When two mods try to modify the same line(s) of code, CML will let you know and help the user handle it!
Workshop Support 🔗
Download (and convert) mods from the Steam Workshop! Works with all mods demarcated as CML mods, almost all manual-install mods, and a few creative-only mods.
Patch System 🔗
Having issues when Scrap Mechanic updates? Are mod files too large? Introducing: The Patch System! Mods that use the CML Patch System are less likely to break when Scrap Mechanic updates or when combined with other mods, and they take up very little space.
Steam Integration 🔗
Add Construct Mod Loader to your Steam Library with the click of a button! Automatically finds the Scrap Mechanic folder and its associated workshop location.
Profiles 🔗
Sick of keeping multiple sets of modifications? Separate them out with Profiles! Each profile can contain up to 2,147,483,647 mods, each of which can be individually enabled/disabled. You can easily switch between profiles and be happy to see that all files will be modified as expected.

## Installation Instructions

Go to the latest release, then download and run the setup file.

Once you have installed CML, run it and navigate to the CML Settings tab. Press `(Re)-Generate Vanilla Folder` to use the Steam API to download/update to the latest version of Scrap Mechanic.

## Running the program

CML needs Administrator privileges to run if any of the following are in a special-access folder (pretty much any folder that is not a subdirectory of the Users [`C:\Users\<>\`] folder):

* Construct Mod Loader
* Scrap Mechanic
* Steam
* The Steam Workshop (Almost always located within the Steam folder)

By default, the .msi will install Construct Mod Loader into `C:\Program Files (x86)\Construct\` and generate Desktop and Start Menu shortcuts for the program. It will also require Administrator privileges to run by default.

If you do not have Start Menu or Desktop shortcuts for Construct Mod Loader, you can also run it from the .exe within the API folder, located at `Installation Directory\API\CML.exe` by default.

If you would like to create a Steam Shortcut for CML, you can do so by pressing the `Create Steam Shortcut` button in the CML Preferences tab. Note: Depending on your system, this may or may not run CML with Administrator privileges, but should follow the setting as defined in the Properties of the .exe on most systems.

## Update Instructions

### Automatic Update (V+B.1.0 and up)

Go to the Settings tab, and click `Check for Updates`. If the `Update` button enables, a new update is available - click it to automatically download and install the Update Assets from GitHub. When the download begins, the `Update` button will be disabled.

In some instances, this will fail, and the `Update` button will re-enable itself automatically. In this case, press it again, and it will direct you to the GitHub page for the latest release. See the Manual Update instructions below for further instructions.

### Manual Update

Download and unzip the UpdateAssets.zip from the latest release. Place the files within the .zip into the API folder, replacing where necessary (Default location: `C:\Program Files (x86)\Construct\API\`).