Creating Mods
Create a Helldivers 2 mod pack from start to finish with the Arsenal Mod Builder.
This guide walks you through creating a mod pack from start to finish using the legacy Mod Builder (Arsenal 0.30.2 and earlier). For 0.36 and later, see Creating mods.
Start a New Project
A fresh project starts with an empty folder structure, default manifest template, and auto-generated mod UUID.
Configure Basic Information
Edit the manifest in the right panel to set your mod's identity:
{
"Version": 1,
"Guid": "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
"Name": "Your Awesome Mod",
"Description": "A brief description of what your mod does",
"IconPath": ""
}| Field | Purpose |
|---|---|
Version | Manifest format version (always 1) |
Guid | Unique identifier (auto-generated) |
Name | Display name shown in mod managers |
Description | Brief explanation of the mod |
IconPath | Relative path to icon image (optional) |
Add Files and Set Icon
For mods without configurable options, add files directly to the root:
- Right-click in the file explorer area
- Select Add Files and choose your
.patch_0,.gpu_resources, and.streamfiles - Optionally, right-click and Set Mod Icon to add a thumbnail (PNG, JPEG, or WebP, 256x256 or 512x512 pixels)
Create Options and Sub-Options
For mods with user-selectable variants:
Adding Options:
- Right-click in the file explorer > Add Folder
- Rename the folder to something meaningful (e.g., "High Quality", "Low Quality")
- Right-click the folder > Add Files to populate it with patch files
Adding Sub-Options:
- Right-click an option folder > Add Sub Folder
- Rename and add files as needed
The manifest automatically reflects your folder structure:
{
"Options": [
{
"Name": "Weapon Skins",
"SubOptions": [
{ "Name": "Gold", "Include": ["Weapon Skins/Gold"] },
{ "Name": "Chrome", "Include": ["Weapon Skins/Chrome"] }
]
}
]
}Set Preview Images and Descriptions
Help users visualize and understand each option:
Preview Images:
- Right-click an option folder > Set Option Image
- Right-click a sub-option folder > Set Sub-Option Image
Descriptions: Add them directly in the manifest editor:
{
"Options": [
{
"Name": "High Quality",
"Description": "4K textures for maximum visual quality.",
"Include": ["High Quality"],
"Image": "High Quality/preview.png"
}
]
}Press Ctrl + S to save manifest changes.
Build and Test
When your mod is ready:
- Click the Build button
- Choose an output location
- The mod pack folder is generated:
Testing:
- Use Add Mod in Arsenal > select Folders > choose your built mod
- Enable the mod and configure options
- Deploy and test in-game
Common Mistakes
Missing Patch Files
Ensure every option folder has actual mod files, not just preview images.
Incorrect Include Paths
The Include array must match folder names exactly (case-sensitive).
Invalid JSON
Check for:
- Missing commas between items
- Trailing commas after the last item
- Unclosed brackets or braces