Add Workshop Scenarios

Install and play custom Workshop scenarios on your Arma Reforger server, including community-made missions and game modes.

Arma Reforger supports custom scenarios from the Steam Workshop. You can install workshop scenarios alongside mods to run community-made missions on your server.

How Workshop Scenarios Work

Workshop scenarios are delivered as mods that contain custom .conf scenario files. To use one, you need to:

Add the mod to your server's mod list
Set the scenario's scenarioId to the workshop scenario's .conf path

Find a Workshop Scenario

Browse the Workshop

Visit the Arma Reforger Steam Workshop and filter by scenarios or game modes.

Get the mod ID

On the workshop page, find the mod's GUID. You'll need this for your server config.

Install a Workshop Scenario

Add the mod to your config

On XGamingServer, go to Files and open your server config JSON. Add the workshop mod to the mods array:

server-config.json

"mods": [
    {
        "modId": "WORKSHOP_MOD_GUID_HERE",
        "name": "Custom Scenario Mod"
    }
]

💡 Tip: On XGamingServer, you can also add mods via the Arma Reforger Config page, which has a visual mod manager. Navigate to the Mods tab, and use the Workshop tab to search and add mods. Then copy the mod list to your config from the JSON tab.

Set the scenarioId

Change the scenarioId to the workshop scenario's .conf file path:

server-config.json

"game": {
    "scenarioId": "{SCENARIO_GUID}Missions/CustomScenario.conf"
}

📝 Note: The exact .conf path depends on the mod. Check the mod's Workshop page or description for the correct scenario ID.

Save and restart

Save your config and restart the server from the Dashboard.

Find the Scenario ID

If the workshop mod doesn't list its scenario ID, you can use the -listScenarios startup parameter to discover it:

Add the mod to your server
Add -listScenarios to your startup parameters
Start the server and check the Console output
The scenario .conf paths will be listed under "Workshop scenarios"

Troubleshooting

Scenario not appearing: Make sure the mod is correctly added to the mods array and that the modId is correct.

Server crashes on start: The scenario may be incompatible with the current server version. Check the mod's Workshop page for compatibility notes.

Mod not downloading: Ensure your server has internet access and the mod ID is correct. Some mods may have dependencies that also need to be added.

If you need help, join our Discord.

Add Workshop Scenarios

On this page