How to Install Mods on Your Arma Reforger Server

Mods can dramatically change your Arma Reforger experience — from new weapons and vehicles to entirely new game modes and maps. The XGamingServer panel includes a built-in mod manager that lets you search and install Workshop mods directly.

Using the Config Editor (Recommended)

The easiest way to install mods is through the Arma Reforger Config Editor's Mods tab, which searches the Workshop and automatically resolves dependencies.

Importing Mods from Your Game Client

If you want to quickly copy your local mod list to the server:

Editing config.json Manually

For advanced users, you can also add mods directly to the config file:

"mods": [
  {
    "modId": "59674C21AA886D57",
    "name": "BetterMuzzleFlashes 2.0",
    "version": "2.0.8"
  }
]

Required vs. Optional Mods

When adding mods through the Config Editor, you'll see a Required toggle for each mod:

• Required (enabled) — Players must have this mod installed to join. The game will prompt them to download it automatically. Use this for mods that change gameplay, add new weapons, vehicles, maps, or game mechanics.
• Required (disabled) — The mod runs on the server but players can join without it. Useful for server-side-only mods like admin tools or logging plugins.

Finding Mods

Browse mods for your server on these platforms:

• Arma Reforger Workshop — The official mod repository. All mods here are compatible with the in-game mod manager and the Config Editor's search.
• In-game Workshop — Browse mods directly from Arma Reforger's main menu under the Workshop section.

Popular mod categories include:

• Weapons & Equipment — New firearms, uniforms, gear, and vehicles
• Maps — Custom terrains and islands beyond the official Everon, Arland, and Kolguyev
• Game Modes — Custom scenarios, missions, and gameplay systems
• Quality of Life — UI improvements, admin tools, and gameplay tweaks

Mod Compatibility After Updates

When Arma Reforger receives a game update, some mods may break until their authors release compatible versions. If your server crashes after an update:

1. Check Console for error messages — they usually identify which mod is causing the problem.
2. Try disabling recently updated or suspect mods in Arma Reforger Config → Mods tab.
3. Check the mod's Workshop page for update notes or compatibility information.
4. Re-enable mods one at a time to isolate the problematic one.

📝 Note: Players connecting to your modded server must have the same mods installed on their local client. Arma Reforger will usually prompt players to download missing mods automatically when they try to join. If crossplay is enabled, make sure your mods support all platforms — some mods are PC-only.

If you get stuck at any time, you can join our Discord.