An Arma Reforger mod ID is a 16-character hexadecimal GUID that every mod on the official Reforger Workshop is assigned, and it is what your server uses to download and load that mod. You can copy it straight from the mod's Workshop URL on reforger.armaplatform.com and paste it into the mods array in config.json, or use the LPV5 Mod Manager to add mods without touching JSON. This guide shows both methods plus how to bulk-paste lots of mods.
Where Mod IDs Come From
Reforger mods are hosted at the official Workshop on reforger.armaplatform.com. Every mod page has a unique URL containing the mod's 16-character hex ID. That ID, sometimes called the modId or the addon GUID, is the only thing the server actually needs to fetch the mod.
- The Reforger Workshop is the official source; Reforger does not use Steam Workshop
- Each modId is 16 hexadecimal characters, written without curly braces in the mods array
Finding a Mod ID on the Workshop
Open the mod's page on reforger.armaplatform.com and grab the ID from the URL. The address bar shows /workshop/ followed by the 16-character GUID and a slug for the mod name.
- Go to https://reforger.armaplatform.com/workshop
- Search for the mod you want, or open it by name
- Look at the address bar; the URL has the form /workshop/<16-char-id>-<name>
- Copy the 16-character ID, not the slug
- Note the mod name so you can label it in config.json
- The mod page often shows the same ID in its details panel as well, which is useful when the URL is shortened
- Bookmark mods you use often so you do not have to look them up again
The mods Array in config.json
Each entry in the mods array is an object with at least a modId. A name field is optional but recommended because it shows in logs and admin tools. A version field is optional and pins the mod to a specific version; leave it out to always get the latest.
"modId": "591AF5BDA9F7CE8B""name": "Capture & Hold""version": "1.0.8"- Leave version out unless you have a reason to pin a specific build
- Dependencies are resolved automatically; you only list the top-level mods
Adding a Single Mod by Hand
If you only want to add one mod, the file manager edit is quick.
- Open the LPV5 file manager and open config.json
- Find the mods array under the game block
- Add a new object with modId and a name
- Make sure commas separate entries and there is no trailing comma after the last one
- Save the file and restart the server
- Watch the console as the server downloads the mod and any dependencies
- Invalid JSON in the mods array stops the server from starting; lint the file before restarting
Bulk-Pasting a Modlist
If you are migrating from another host or building a new server, you usually have a full modlist already. Paste it straight into the mods array in one block instead of adding one at a time.
- Gather every modId and name in advance
- Open config.json
- Replace the entire mods array with your new list
- Validate the JSON before saving
- Restart the server and let it download every mod and dependency
- Group related mods together in the array so the list is easier to maintain
- Keep a copy of your modlist outside the panel as a backup
Using the LPV5 Mod Manager Instead
If you would rather not touch raw JSON, Loafhosts gives you a Mod Manager that browses the Reforger Workshop, supports hidden mods by ID, and writes the same mods array for you. It is the friendliest option for most admins.
- Open hub.loafhosts.com and select your Arma Reforger server
- Open the Mod Manager
- Search for a mod, or paste its 16-character modId for a hidden or unlisted mod
- Add the mod to your preset
- Save the preset to write the entries into config.json
- Restart the server and watch the console handle the downloads
- The Mod Manager keeps presets so you can swap modlists for different events without rewriting JSON
- Hidden mods that do not show up in the Workshop search still work as long as you have the modId