> For the complete documentation index, see [llms.txt](https://did-games.gitbook.io/bonds-modding/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://did-games.gitbook.io/bonds-modding/players/installing-mods.md).

# Installing Mods

{% hint style="danger" %}
Mods cannot be installed on smartphones. Mod support only exists for Windows, macOS and Linux devices (including portable devices running on those OSs, like the Steamdeck)
{% endhint %}

## Bonds's mods folder

Mods are installed within Bonds's installation folder, so the first step is to open it in your file explorer. You need to find the folder that contains the game's executable. On macOS, this is deeper, under `Game.app/Contents/Resources/app.nw` (Right-click `Game.app` and click `Show Package Contents`)

If you see a `mods` folder (alongside other folders named `js`, `img`, `data`...) then you are in the right place. Go into the `mods` folder and you should see an `Example mod` folder; That is an example mod intended for modders and cannot be played so do not mind it - you are now in the correct place to install mods.

{% hint style="info" %}
If you own Bonds on Steam, you can find the game's installation folder by right-clicking Bonds, then "Properties" => "Installed Files" => "Browse"
{% endhint %}

## Adding & Organizing Mods

To install a new mod, simply place the mod's folder into the `mods` folder. Your mod folder should then look like this: 

```
mods/
    Example mod/
    Cool new mod/
```

{% hint style="info" %}
Mods can be placed as deep as you want within the `mods` folder. If you have many mods, you can organize your mods by category, like with a `Cosmetics` folder (so `mods/Cosmetics/Cool new mod/`) or a `Localization` folder for example.
{% endhint %}

## Enabling, Disabling & Ordering Mods

Once you have at least one mod in your `mods` folder, the `Mods` button will appear on Bonds's title screen; Click it to enter the Mods panel.

You can enable and disable mods by clicking on them, and change their order by clicking on the arrows next to each mod.

{% hint style="warning" %}
The order of mods in the menu is NOT for cosmetic purposes, it is the order in which mods are loaded in. A mod that is made for another mod typically needs to be loaded after the mod it is made for, so make sure you follow the mod's load order instructions if there are any.
{% endhint %}

Once you're done, leave the menu to save the configuration and restart the game. You can double-check whether the mod successfully loaded by going into the `Mods` menu again: If a mod you enabled before restarting no longer appears in the list, it likely failed to load. 

{% hint style="info" %}
If the mod didn't load, you may press `F8` to open the console. If you see red error messages, they are likely related. You may send the error messages to the modder for troubleshooting.
{% endhint %}