- Grimoire Mod Manager is a free, open-source mod manager built for Deadlock, supporting Windows, Linux, and macOS.
- Install mods via GameBanana 1-Click Install or local
.vpkfile import. - Load order decides which mod wins when two mods replace the same game file.
- Profiles and share codes let you save, export, and swap full mod loadouts instantly.
- Hero Locker organizes skins, ability colors, and sounds per hero without rebuilding your setup.
What Is Grimoire Mod Manager?
Grimoire Mod Manager is a free, MIT-licensed, open-source tool for browsing, installing, and organizing Deadlock mods. According to the official website, it has passed 126k+ total downloads, serves 17k+ weekly users, and records 6.1k+ daily launches, with new releases shipping every few days (current version v1.32.0).
The tool replaces manual .vpk file juggling with a single interface that handles mod discovery, deployment, ordering, and recovery. Its source code is publicly available on GitHub (Slush97/grimoire), and full documentation lives in the Grimoire User Guide.
Core features at a glance:
| Feature | What It Does | Best For |
|---|---|---|
| Mod Browser | Browse GameBanana mods inside the app | Discovering new content |
| 1-Click Install | Install directly from a GameBanana listing | Fast, error-free setup |
| Load Order | Control which mod overrides another | Resolving overlaps |
| Conflict Detection | Flags mods replacing the same files | Preventing broken loadouts |
| Hero Locker | Per-hero skins, colors, and sounds | Cosmetic organization |
| Profiles | Save and share full loadouts | Competitive vs. casual setups |
| Vanilla Launch | Start Deadlock without mods | Clean testing |
| Snapshots | Capture and restore known-good states | Safe troubleshooting |
Windows Builds
- Installer for standard desktop use
- Portable build runs from any folder
- Ideal for most players
Linux Builds
- AppImage works across distributions
- Debian package for Ubuntu-based systems
- Flatpak-style flexibility
macOS
- Native application build
- Apple Silicon supported
- CrossOver setups also documented
Always compare your downloaded file's checksum against the values published with each release on GitHub Releases. This confirms the file is intact and matches the official build.
First-Time Setup and Installing Your First Mod
A clean first run prevents most problems later. Complete these six steps in order, and do not launch Deadlock while Grimoire is still processing mod files.
Install Deadlock First
Confirm Deadlock is installed and launches normally through Steam. Close the game completely before touching any mod files.
Launch Grimoire
Open Grimoire from your installed application or portable folder. Allow any operating-system permission prompts so the manager can access game files and its own data directory.
Confirm the Game Location
Point Grimoire at the actual Deadlock installation directory — not a shortcut, not a Steam library folder, not an unrelated parent directory.
Install a Mod
Use 1-Click Install from a compatible GameBanana listing, or import a downloaded archive. If the browser does not hand off to Grimoire automatically, launch the manager first and retry.
Verify Registration
Check the Library view for the new entry. A completed browser download does not always mean the mod is registered — confirm its status and any warnings before enabling it.
Enable and Test
Enable the mod, launch Deadlock, and check the exact asset it changes. Start with one mod at a time so problems are easy to isolate.
Changing managed files while Deadlock is running can prevent updates from applying correctly. Exit to the desktop fully — do not leave the game running in the background.
A common failure mode is incorrect archive structure: if a mod appears installed but has no effect in-game, the .vpk is likely nested inside an extra folder. Preserve the structure described by the mod author and avoid adding wrapper directories.
Load Order and Conflict Resolution
When two or more enabled mods replace the same Deadlock file, the final result is decided by load order — the entry in the effective override position wins. Grimoire's conflict detection highlights overlapping mods so you can resolve them deliberately instead of guessing.
| Mod Category | Priority Guidance | Conflict Result If Wrong |
|---|---|---|
| Skins / character visuals | Preferred skin above other skins for the same hero | Lower-priority skin hidden or partially overridden |
| HUD and interface | Full HUD overhaul above smaller panel tweaks | Mixed elements from different packages |
| Crosshairs and reticles | Keep only one replacement active per element | Duplicate or missing crosshair |
| Audio replacements | Preferred audio pack above competing packs | Sounds split between two packs |
| Combined mod packs | Specialized mods above broad packs | Broad pack overwrites focused changes |
Isolating a conflict safely:
Identify the Conflict
Open the active mod list and note every entry flagged for overlapping files, plus the exact in-game asset that is missing or wrong.
Change One Variable
Keep both conflicting mods enabled and change only their relative order. Apply the loadout and restart the game to test.
Binary Testing
Disable one of the two mods, test, then swap. This shows whether the fault lies in one mod or their interaction.
Restore If Needed
If experiments introduce new problems, restore the latest known-good snapshot and reintroduce mods one at a time.
Deadlock may keep visual and audio assets cached from an earlier session. If a change appears to do nothing, restart the game before assuming the mod failed.
Profiles, Share Codes, and Hero Locker
Profiles turn your mod list into a reusable loadout. Instead of re-enabling two dozen mods by hand, save the arrangement once and switch between setups — competitive, experimental, or cosmetic — in seconds.
Profile workflow:
| Action | Method | Use Case |
|---|---|---|
| Save a loadout | Create a Mod Profile from the active selection | Lock in a working setup |
| Export to file | Export as .modprofile.json | Backup or transfer between installs |
| Share with others | Generate a share code | Send a loadout to friends |
| Import | Load a code or profile file | Recreate someone else's setup |
When importing a shared profile, review missing, disabled, or conflicting entries before applying it — the recipient may not own every mod in the original loadout.
Hero Locker works alongside profiles for cosmetics. Instead of managing skins globally, you assign each hero its skin, ability color treatment, and ability sound replacement individually. If several appearance mods target the same hero, the selected override plus load order determines which one is active, and removing a locker selection returns that hero to the profile's remaining mods or the original asset.
Hero Locker Strengths
- Per-hero skin assignment
- Separate ability colors and sounds
- Reversible overrides
- Conflict-aware switching
Profile Best Practices
- Export before major changes
- Keep a stable and an experimental profile
- Name profiles by purpose
- Test imported loadouts before ranked play
Cosmetic mods such as skins, HUDs, and announcer packs affect only what you see and hear locally. Other players in a match will not see your custom hero appearance.
Troubleshooting Common Problems
Start from the visible symptom and make the smallest controlled change possible. Keep a working profile or snapshot available so every repair attempt is reversible.
| Symptom | Likely Cause | First Fix |
|---|---|---|
| Mod enabled but no effect | Another mod overrides it, or game cached old assets | Check conflict flags, restart Deadlock |
| Game crashes after new mod | Incompatible combination in the loadout | Disable the newest mod, restore snapshot |
| Load order change does nothing | Game still running, or profile not applied | Exit game fully, apply profile, relaunch |
| Manager cannot find game | Wrong installation path selected | Re-select the actual Deadlock directory |
| Weird behavior on macOS/Linux | Manager and game in different prefixes or bottles | Match Grimoire to the active game install |
Recovering the original game files: disable all active mods or switch to an empty profile, then use Grimoire's restore, undeploy, or snapshot workflow. Verify the correct game installation is selected, launch Deadlock unmodded to confirm the clean state, and keep your exported profile saved separately in case you want the loadout back later.
For persistent issues, the official documentation and the GitHub issues page are the primary channels; the official Discord community is linked from the website footer — enter through the official site to avoid impersonated servers.
Manual file deletion can leave the game in a broken state. Prefer Grimoire's snapshot restore workflows, which reverse deployments cleanly.
Your Modding Setup Is Ready When:
- Grimoire recognizes the correct Deadlock installation
- First mod installed, enabled, and verified in-game
- Load order reviewed for conflicting mods
- A working profile exported as backup
- Vanilla launch tested for clean recovery
FAQ
Q: Is Grimoire Mod Manager free to use?
Yes. Grimoire is open-source software released under the MIT license, with public source code on GitHub. Downloads are available for Windows, Linux, and macOS from the official website and GitHub releases.
Q: How do I install Deadlock mods with Grimoire?
Browse Deadlock mods on GameBanana, use the 1-Click Install option on a compatible listing, and let Grimoire handle download, extraction, and registration. You can also import local mod archives through the Library view.
Q: Why is my mod enabled but not showing in-game?
The most common causes are another mod overriding the same file, cached assets requiring a game restart, or the active profile not being applied after the change. Check conflict indicators, disable competing replacements, apply the profile, and restart Deadlock.
Q: Can I share my Grimoire mod setup with friends?
Yes. Save your loadout as a Mod Profile, then either export a .modprofile.json file or generate a share code. Recipients import the code or file and should review the resulting loadout for missing or conflicting entries before applying it.