Adding Mods

Install and manage mods on your Arma Reforger server

Adding Mods to Arma Reforger

Arma Reforger supports Steam Workshop mods. This guide explains how to install and configure mods on your server.

Finding Mods

Browse mods on the Steam Workshop for Arma Reforger.

When you find a mod you want, you’ll need:

1. Mod ID - The Workshop ID from the URL
2. Mod Name - The exact mod name

The Mod ID is found in the Workshop URL. For example: https://steamcommunity.com/sharedfiles/filedetails/?id=1234567890 The Mod ID is 1234567890

Installing Mods

Mods are configured in the config.json file:

1. Stop Your Server

   Go to the Console tab and stop your server

2. Open config.json

   Go to File Manager and open config.json

3. Add Mods to Config

   Find the "mods": [] section and add your mods

4. Save and Restart

   Save the file and start your server

Mod Configuration Format

Add mods to the mods array in config.json:

{
  "game": {
    "name": "My Server",
    "mods": [
      {
        "modId": "591AF5BDA9F7CE8B",
        "name": "Example Mod",
        "version": "1.0.0"
      },
      {
        "modId": "ANOTHER_MOD_ID",
        "name": "Another Mod",
        "version": "1.0.0"
      }
    ]
  }
}

Mod Entry Fields

Field	Description
modId	The Workshop mod ID (hexadecimal format)
name	Friendly name for the mod
version	Mod version (optional, helps with tracking)

Important: The modId in Arma Reforger uses a hexadecimal format, not the numeric Steam Workshop ID. You can find the correct mod ID on the mod’s Workshop page or in the mod documentation.

Example: Full Config with Mods

{
  "bindAddress": "0.0.0.0",
  "bindPort": 2001,

  "game": {
    "name": "Modded Arma Reforger Server",
    "password": "",
    "scenarioId": "{ECC61978EDCC2B5A}Missions/23_Campaign.conf",
    "maxPlayers": 32,
    "visible": true,

    "gameProperties": {
      "battlEye": true,
      "disableThirdPerson": false
    },

    "mods": [
      {
        "modId": "591AF5BDA9F7CE8B",
        "name": "Community Framework",
        "version": "1.0.0"
      },
      {
        "modId": "5965520F24A0E525",
        "name": "Custom Faction",
        "version": "2.1.0"
      }
    ]
  }
}

Client Requirements

Players connecting to your modded server must have the same mods installed. When a player connects, the game will prompt them to download required mods automatically.

Mod Load Order

Mods are loaded in the order they appear in the mods array. If you have mods that depend on other mods:

1. Put dependency mods first
2. Put mods that require dependencies after

Example:

"mods": [
  { "modId": "ABC123", "name": "Framework Mod" },
  { "modId": "DEF456", "name": "Mod That Requires Framework" }
]

Custom Scenarios from Mods

If a mod provides custom scenarios, you can use them by setting the scenarioId to the mod’s scenario ID:

{
  "game": {
    "scenarioId": "{MOD_SCENARIO_ID}Missions/CustomMission.conf",
    "mods": [
      {
        "modId": "SCENARIO_MOD_ID",
        "name": "Custom Scenario Mod"
      }
    ]
  }
}

Troubleshooting Mods

Mods Not Loading

• Verify the mod ID is correct (hexadecimal format)
• Check that the mod name is spelled correctly
• Ensure all dependency mods are listed first
• Check the console for error messages

Players Can’t Connect

• Ensure players have all required mods installed
• Verify mod versions match between server and clients
• Check if BattlEye is causing issues with certain mods

Server Crashes with Mods

• Remove mods one by one to identify the problem mod
• Check mod compatibility with current game version
• Verify mod dependencies are installed
• Review console output for error messages

Updating Mods

Mods update automatically when:

1. The server restarts with Auto Update enabled
2. You reinstall the server

To force a mod update:

1. Stop the server
2. Delete the mod files from the addons folder
3. Restart the server (mods will re-download)

Removing Mods

To remove a mod:

1. Stop your server
2. Open config.json
3. Remove the mod entry from the mods array
4. Save the file
5. Optionally delete mod files from addons folder
6. Start the server

Always test mods on a backup save first. Some mods may cause issues when removed from an existing save.