# Add Workshop Scenarios to Your Arma Reforger Server (/docs/arma-reforger/workshop-scenarios)







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

Arma Reforger supports custom scenarios from the Steam Workshop. Workshop scenarios are delivered as mods that contain custom `.conf` scenario files. To use one, you add the mod to your mod list, then point `scenarioId` at the workshop scenario's `.conf` path.

Find a Workshop Scenario [#find-a-workshop-scenario]

<Steps>
  <Step>
    Browse the Workshop [#browse-the-workshop]

    Visit the [Arma Reforger Steam Workshop](https://steamcommunity.com/app/1874880/workshop/) and filter by **Scenarios** or **Game Modes**.
  </Step>

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

    On the Workshop page, find the mod's GUID (16-character hex). You'll need this to add the mod to your config.
  </Step>
</Steps>

Install a Workshop Scenario [#install-a-workshop-scenario]

<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.

                <img alt="Config Tool in the sidebar" src={__img0} placeholder="blur" />
      </Step>

      <Step>
        Add the mod [#add-the-mod]

        Go to the **Mods** tab. Search for the scenario mod by name or paste its mod ID. Click **Add**.

                <img alt="Config Editor Mods tab" src={__img1} placeholder="blur" />
      </Step>

      <Step>
        Set the scenario [#set-the-scenario]

        Go to the **Game** tab. Toggle **Use Custom Scenario** and paste the workshop scenario's `.conf` path:

        ```
        {SCENARIO_GUID}Missions/CustomScenario.conf
        ```
      </Step>

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

        Click **Save Changes** and restart from **Console**.
      </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 the mod and set `scenarioId`:

        ```json
        "game": {
          "scenarioId": "{SCENARIO_GUID}Missions/CustomScenario.conf",
          "mods": [
            {
              "modId": "WORKSHOP_MOD_GUID_HERE",
              "name": "Custom Scenario Mod"
            }
          ]
        }
        ```
      </Step>

      <Step>
        Save and start [#save-and-start]
      </Step>
    </Steps>
  </Tab>
</Tabs>

Find the Scenario .conf Path [#find-the-scenario-conf-path]

If the Workshop page doesn't list the scenario ID, you can discover it:

<Steps>
  <Step>
    Add the mod to your server [#add-the-mod-to-your-server]

    Install the mod first (without setting `scenarioId`).
  </Step>

  <Step>
    Add -listScenarios startup parameter [#add--listscenarios-startup-parameter]

    In **Startup**, add `-listScenarios` to the startup parameters. See [Startup Parameters](/docs/arma-reforger/startup-parameters).
  </Step>

  <Step>
    Start and check Console [#start-and-check-console]

    Start the server from **Console**. The startup output lists all available scenarios, including those from installed mods, under "Workshop scenarios".
  </Step>

  <Step>
    Copy the path [#copy-the-path]

    Find your custom scenario's `.conf` path and use it as the `scenarioId`.
  </Step>
</Steps>

Troubleshooting [#troubleshooting]

| Problem                  | Fix                                                                                          |
| ------------------------ | -------------------------------------------------------------------------------------------- |
| Scenario not appearing   | Verify the mod ID and that the mod loaded successfully in **Console**                        |
| Server crashes on start  | The scenario may be incompatible with the current Reforger version. Check the Workshop page  |
| Mod not downloading      | Check the server has internet access and the mod ID is correct. Some mods have dependencies  |
| Wrong scenario ID format | The format is `{16-char hex GUID}Missions/Filename.conf` — make sure both braces are present |

Related Guides [#related-guides]

* [Switch Scenario](/docs/arma-reforger/switch-scenario)
* [Scenario List](/docs/arma-reforger/scenario-list)
* [Mod Setup](/docs/arma-reforger/mod-setup)
* [Startup Parameters](/docs/arma-reforger/startup-parameters)