This guide explains how to add mods to a Mordhau server using the official Mod.io integration. Mods allow you to add custom game modes, maps, weapons, mechanics, and server utilities to your Mordhau server.
Mordhau’s mod system is simple once understood, but it is very strict about where and how mods are defined. Incorrect placement or formatting will prevent mods from downloading or loading.
How Mordhau Server Mods Work #
Mordhau uses Mod.io as its official mod distribution platform. Unlike older systems, Mordhau mods are not subscription-based and do not require multiple Mod.io accounts.
Instead, mods are loaded by directly referencing their Mod ID inside the server’s configuration files. When configured correctly, the server will automatically download and update mods from Mod.io.
Before You Add Mods #
Before editing any configuration files:
- Stop your Mordhau server completely
- Ensure no configuration files are being written to
- Have a list of Mod IDs ready
Editing configuration files while the server is running can cause mods to fail loading or corrupt server settings.
Where Mods Are Added (Critical) #
Mods are added through the Game.ini file and must be placed inside the correct section:
[/Script/Mordhau.MordhauGameSession]
If mods are not placed in this section, they will not load and the server will not download them from Mod.io.
Example: Adding Mods to Game.ini #
Below is a working example of a Mordhau server with multiple mods installed.
[/Script/Mordhau.MordhauGameSession] MaxSlots=48 ServerName=yourservername ServerPassword= AdminPassword=yourpassword Mods=71385 Mods=71020 Mods=126237 Mods=131150 Mods=132309 BannedPlayers=() MutedPlayers=()
Each mod is defined using its own Mods= line. This is required for proper loading.
Important Rules for Adding Mordhau Mods #
- Each mod must be on its own line
- Each line must start with
Mods= - Only numeric Mod IDs are used
- Mods must be inside the MordhauGameSession section
Do not separate mod IDs with commas or spaces. Mordhau will ignore incorrectly formatted entries.
Finding Mod IDs on Mod.io #
Mod IDs are listed directly on each mod’s page on Mod.io.
The Mod ID appears under the mod title on the mod’s page. This numeric value is what you place after the = sign in Game.ini.
Example:
Mods=131150
Do You Need Multiple Mod.io Accounts? #
No. Mordhau’s current mod system does not require multiple Mod.io accounts, even if you are running multiple servers or different game modes.
Mods are linked directly to the server configuration, not to a Mod.io user subscription. This makes it easy to:
- Run multiple game mode servers
- Use different mod sets per server
- Change mods without account switching
Starting the Server After Adding Mods #
After saving Game.ini:
- Start the server
- Allow extra startup time
- Watch the console for mod download progress
On first launch, the server may take several minutes to download and install all mods. This is normal.
Common Mod Issues and Fixes #
Mods Not Downloading #
- Mod ID is incorrect
- Mods not inside the correct section
- Server was not restarted
Server Fails to Start After Adding Mods #
- Incompatible mods
- Corrupted download
- Too many heavy mods for the server hardware
Players Cannot Join After Mods Are Added #
- Clients are still downloading mods
- Mod mismatch between server and client
Best Practices for Modded Mordhau Servers #
- Add mods incrementally
- Test after each change
- Avoid overloading the server with unnecessary mods
- Ensure CPU resources are sufficient
Mods increase server-side processing. High player counts combined with many mods can require stronger hardware.
Adding mods to a Mordhau server is straightforward when done correctly. By placing Mod IDs in the proper Game.ini section and following formatting rules, the server will automatically download and load mods from Mod.io.
Proper mod management allows you to create unique gameplay experiences while maintaining stability and performance.
