# How to Add Workshop Mods to Your Arma Reforger Server (/docs/arma-reforger/mod-setup)



import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';

Arma Reforger mods are automatically downloaded from Steam Workshop — you just add the mod ID to your config. The XGamingServer **Arma Reforger Config** editor includes a built-in mod browser with auto-dependency resolution.

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden', marginTop: '1rem', marginBottom: '1rem' }}>
  <iframe src="https://www.youtube.com/embed/eT5EgZt2ZcY" title="How to Add Workshop Mods to Your Arma Reforger Server" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%' }} />
</div>

<Tabs items={['Config Editor (Recommended)', 'Manual JSON']}>
  <Tab value="Config Editor (Recommended)">
    <Steps>
      <Step>
        Open the Config Editor [#open-the-config-editor]

        In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Arma Reforger Config** in the sidebar.
      </Step>

      <Step>
        Go to the Mods tab [#go-to-the-mods-tab]

        Click the **Mods** tab in the editor.
      </Step>

      <Step>
        Search for a mod [#search-for-a-mod]

        Type a mod name, author, mod ID, or Workshop URL in the search bar. Results show with thumbnails, names, and IDs.
      </Step>

      <Step>
        Add it [#add-it]

        Click **Add** on the mod you want. The mod is added to your config and **dependencies are automatically resolved** (added too).
      </Step>

      <Step>
        (Optional) Manage the mod [#optional-manage-the-mod]

        * Toggle **Required** on each mod to control whether clients must have it
        * Click **Remove** to delete a mod from the config
        * Use **Import/Export** to bulk manage mod lists as JSON
      </Step>

      <Step>
        Save and restart [#save-and-restart]

        Click **Save Changes**, then restart the server from **Console**. The server downloads the mods on startup.
      </Step>
    </Steps>

    Manually Add by Mod ID [#manually-add-by-mod-id]

    If the search doesn't find your mod:

    <Steps>
      <Step>
        Get the Mod ID [#get-the-mod-id]

        The 16-character hex ID is on the Steam Workshop page URL — the string after `?id=`. Or check the mod's `ServerData.json` file.
      </Step>

      <Step>
        Enter it [#enter-it]

        In the Mods tab, enter the **Mod ID** in the manual-add field. Optionally add a friendly name.
      </Step>

      <Step>
        Click Add Mod [#click-add-mod]

        Save and restart.
      </Step>
    </Steps>
  </Tab>

  <Tab value="Manual JSON">
    <Steps>
      <Step>
        Stop the server [#stop-the-server]
      </Step>

      <Step>
        Edit config.json [#edit-configjson]

        In **Files**, open `config.json`. Add mods to the `mods` array inside the `game` block:

        ```json
        "mods": [
          {
            "modId": "597D72161FD1ED1D",
            "name": "My Mod",
            "version": "",
            "required": true
          }
        ]
        ```

        | Field      | Description                                                    |
        | ---------- | -------------------------------------------------------------- |
        | `modId`    | 16-char hex ID from the Workshop page or mod's ServerData.json |
        | `name`     | Human-readable label (cosmetic only)                           |
        | `version`  | Pin to a specific version, or `""` for always-latest           |
        | `required` | If `true`, clients must have this mod to join                  |
      </Step>

      <Step>
        Save and start [#save-and-start]

        Click **Save Content** and start the server from **Console**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Finding Mod IDs [#finding-mod-ids]

| Source                  | How                                |
| ----------------------- | ---------------------------------- |
| Steam Workshop URL      | The hex string after `?id=`        |
| Mod's `ServerData.json` | Inside the mod folder              |
| Config Editor search    | Easiest — search by name or author |

Required vs Optional Mods [#required-vs-optional-mods]

In config.json:

```json
"modsRequiredByDefault": true
```

When `true`, all mods in the list are required unless individually set to `required: false`. When `false`, mods are optional unless individually set to `required: true`.

How Auto-Download Works [#how-auto-download-works]

* The server downloads mods on first startup after they're added to the config
* Players auto-download required mods when they connect
* Console players (Xbox/PlayStation) **cannot** install mods, so modded servers reject them

Related Guides [#related-guides]

* [Server Configuration](/docs/arma-reforger/server-config)
* [Workshop Scenarios](/docs/arma-reforger/workshop-scenarios)
* [Troubleshooting](/docs/arma-reforger/troubleshooting)