- Grimoire Mod Manager is a free, open-source mod manager for Deadlock, currently at v1.32.0
- Supports Windows, Linux, and macOS (Apple Silicon) with installer, portable, AppImage, and Debian packages
- Key features: GameBanana browsing, 1-Click Install, load order, conflict detection, Hero Locker, Profiles
- Solve conflicts by adjusting load order, isolating mods, and restoring Snapshots
- Save full loadouts as .modprofile.json files or share them via share codes
What Is Grimoire Mod Manager?
Grimoire Mod Manager is a free and open-source tool (MIT licensed) built specifically for managing Deadlock mods. Instead of manually dropping .vpk files into game folders, Grimoire gives you a single interface to browse mods on GameBanana, install them with one click, control load order, detect conflicts, and switch between saved mod configurations.
As of late 2026, the project reports 126k+ total downloads, 17k+ weekly users, and 6.1k+ daily launches, with updates shipping every few days. You can download it from the official website, read the official documentation, or review the source code on GitHub.
Mod Browsing & Install
- Browse GameBanana listings inside Grimoire
- 1-Click Install from compatible mod pages
- Import local archives and
.vpkfiles
Load Order & Conflicts
- Enable, disable, and reorder mods
- Automatic conflict detection for overlapping files
- Priority control decides the effective replacement
Profiles & Snapshots
- Save full loadouts as Profiles
- Export/import
.modprofile.jsonfiles - Snapshots restore known-good states
| Platform | Package Options | Best For |
|---|---|---|
| Windows | Installer, Portable | Most users; portable for self-contained use |
| Linux | AppImage, Debian package | Distribution-independent or system package workflows |
| macOS | Apple Silicon application | Native Mac launch via official download |
Only download Grimoire from the official website or its GitHub releases page. Verify checksums published with each release before installing, and join the community Discord through the link on the official site to avoid impersonated servers.
First-Time Setup: Step-by-Step
Getting Grimoire connected to Deadlock takes only a few minutes if you follow the correct order. The most common first-run mistakes are pointing the manager at a shortcut instead of the real game directory, or editing mods while the game is still running.
Install Deadlock First
Install Deadlock through Steam and confirm it launches normally. Close the game completely before touching any mod files.
Launch Grimoire
Open Grimoire from your installed application or portable folder. Allow any OS security or permission prompts during first-time setup.
Confirm the Game Location
Select the actual Deadlock installation directory when prompted—never a shortcut, library folder, or unrelated parent directory.
Review the Interface
Explore the mod library, browse view, and enable/disable controls. Note any status or warning indicators before launching.
Install and Enable One Mod
Add a single mod, confirm it appears in the library, enable it, then launch Deadlock and verify the change. Starting with one mod makes problems easy to isolate.
Always close Deadlock completely—back to the desktop, not just minimized—before installing, removing, or reordering mods. Changing managed files while the game runs can prevent updates from applying correctly.
Installing Deadlock Mods
Grimoire connects mod discovery and installation into one workflow. For compatible GameBanana listings, the 1-Click Install button hands the download and extraction directly to Grimoire; for everything else, you can import a downloaded archive.
| Install Method | How It Works | When to Use |
|---|---|---|
| 1-Click Install | Browser hands the mod to Grimoire automatically | Compatible GameBanana listings |
| Archive import | Drag or browse to a downloaded .zip/.vpk | Mods from other sources or backups |
| Manual extraction | Unpack preserving the author's structure | When auto-extraction is unavailable |
A completed browser download does not always mean the mod is registered in Grimoire. Open the installed-mods view, locate the new entry by name, and check its status and warnings before enabling it.
Incorrect archive structure—such as nesting the mod inside an extra folder—is one of the most common reasons a mod appears installed but has no effect in-game. Preserve the layout described by the mod author.
Load Order and Conflict Fixes
When two mods replace the same Deadlock file, the load order decides which one wins: the entry in the effective override position supplies the final asset. Grimoire flags overlapping mods so you can resolve them deliberately.
| Mod Category | Priority Guidance | Conflict Result If Wrong |
|---|---|---|
| Skins / visuals | Keep only the preferred skin active, or place it highest | Lower-priority skin hidden or partially overridden |
| HUD / interface | Put full HUD overhauls above small element tweaks | Mixed elements from different packages |
| Crosshairs | Disable duplicates; one reticle can only display | Wrong or default crosshair |
| Audio packs | Place the preferred sound pack above competitors | Mixed sounds from multiple packs |
| Combined packs | Specialized mods above broad packs | Broad pack overwrites focused changes |
Identify the Conflict
Check the mod list for overlap warnings and note which mods are flagged before changing anything.
Adjust the Order
Keep both mods enabled and change only their relative order. Apply the loadout and restart the game to clear cached assets.
Isolate If Needed
Disable one conflicting mod and test, then swap. This binary comparison reveals whether the problem is one mod or the interaction.
Restore a Snapshot
If experiments make things worse, close the game and restore the last known-good snapshot, then reintroduce mods one at a time.
When diagnosing a problem, disable all but the suspected mod, test, and re-enable entries one at a time. Changing several things at once makes it impossible to tell which change caused the result.
Hero Locker, Profiles, and Sharing
Hero Locker ties appearance mods to individual heroes, so you can switch a skin, ability color, or ability sound without rebuilding your whole loadout. If multiple mods target the same asset, the selected override plus load order determine what appears in-game.
Profiles save your entire mod selection as a reusable loadout. Export to a .modprofile.json file for backups or transfers, or generate a compact share code so friends can recreate your setup.
Hero Locker
- Assign skins, ability colors, sounds per hero
- Apply or remove overrides without touching the rest
- Restart the game if effects stay cached
Profiles
- Save loadouts for competitive, test, or cosmetic setups
- Keep experimental mods in a separate profile
- Switch back to a stable profile anytime
Share Codes
- Copy the full code without spaces or line breaks
- Include load-order or compatibility notes
- Review an imported loadout before applying it
Always export your working profile to a .modprofile.json file before making major changes. It takes seconds and gives you a guaranteed rollback path.
Healthy Grimoire Workflow:
- Deadlock installed and confirmed launching normally
- Grimoire pointed at the correct game directory
- Mods installed one at a time and tested in-game
- Working loadout exported as a profile backup
- Conflicts resolved via load order, not blind disabling
Troubleshooting Common Problems
Most Grimoire issues fall into a few recognizable patterns. Start from the visible symptom, make the smallest controlled change possible, and keep a snapshot available so you can always return to a clean state.
| Symptom | Likely Cause | First Fix |
|---|---|---|
| Mod enabled but no effect | Another mod overrides the same file, or profile not applied | Check conflict indicators, apply profile, restart game |
| Game crashes after new mod | Incompatible combination or inconsistent deployment | Disable the newest mod, restore a snapshot |
| Wrong mod keeps winning | Preferred mod not in override position, cached assets | Close game, fix order, apply, restart |
| Grimoire/game won't start | Bad recent replacement in active profile | Restore known-good profile, re-add mods one by one |
| Issues on macOS/Linux | Manager and game in different prefixes or paths | Verify the game directory matches the active client |
To return to an unmodded game, disable active mods or switch to an empty profile, then use Grimoire's restore or snapshot workflow rather than manually deleting files. Keep your exported profile if you may want the same loadout later.
For issues beyond this guide, check the official documentation, browse open reports on GitHub Issues, or ask in the r/DeadlockTheGame community on Reddit.
Q: Is Grimoire Mod Manager free?
Yes. Grimoire is free and open-source under the MIT license, with source code available on GitHub and downloads published through the official website and GitHub releases.
Q: Which platforms does Grimoire support?
Windows (installer and portable), Linux (AppImage and Debian package), and macOS on Apple Silicon. Linux users should make the AppImage executable before launching it.
Q: Why is my Deadlock mod enabled but not showing in-game?
Usually another mod overrides the same file, the profile was not applied after the change, or the game needs a restart to reload cached assets. Check conflict indicators in Grimoire, apply the profile, and restart Deadlock.
Q: How do I share my Deadlock mod setup with a friend?
Export your loadout as a profile and share either a generated share code or the .modprofile.json file. Your friend imports it into Grimoire, reviews any missing or conflicting entries, then applies the loadout.
Q: What should I do if Deadlock updates and my mods break?
Restore a vanilla state using Grimoire's restore or snapshot workflow, confirm the game runs cleanly, then re-enable mods one at a time. Mods that depend on outdated game files may need updates from their authors.