# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://did-games.gitbook.io/bonds-modding/players/installing-mods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.