- Grimoire Mod Manager is a free, open-source Deadlock mod manager with 126k+ downloads and 17k+ weekly users.
- Setup takes minutes: install the right build, point it at your Deadlock folder, and enable your first mod.
- Load order controls everything: the last-applied mod wins when two mods replace the same file.
- Profiles and share codes let you save, export, and swap entire mod loadouts instantly.
- Hero Locker organizes skins, ability colors, and ability sounds per hero without rebuilding your loadout.
Getting Started with Grimoire Mod Manager
Grimoire Mod Manager is the community-standard tool for managing Deadlock mods. It handles mod discovery through GameBanana, load order control, conflict detection, profile management, and hero cosmetic switching — all in one open-source application. Before you manage a single mod, choose the correct build for your operating system.
| Platform | Package | Best For | Notes |
|---|---|---|---|
| Windows | Installer | Most users | Standard desktop installation |
| Windows | Portable | Folder-based use | Runs from extracted folder, no install |
| Linux | AppImage | Any distro | Make executable before launching |
| Linux | Debian Package | Ubuntu/Debian | Managed via system package workflow |
| macOS | macOS Application | Mac users | Follow security prompts on first launch |
Current release: v1.32.0, MIT-licensed, with updates shipping every few days. Download only from the official site or the GitHub releases page, and verify checksums against the published release values.
Only download Grimoire from grimoiremods.com or the official GitHub repository. Third-party mirrors and copycat Discord servers are the most common source of broken installs and security issues.
First-Run Setup: How to Connect Deadlock
First-time setup comes down to three things: launching the tool, confirming the game location, and understanding the main interface. Get these right and every later step becomes easier.
| Setup Task | What to Do | Common Mistake to Avoid |
|---|---|---|
| Launch Grimoire | Open app, allow first-time setup and OS permission prompts | Blocking the permission prompt silently |
| Game location | Select the actual Deadlock installation directory | Selecting a shortcut or parent library folder |
| Verify connection | Confirm Grimoire recognizes the game before adding mods | Installing mods before the path is confirmed |
| Learn the interface | Check the library view, enable/disable controls, and status indicators | Ignoring warning badges before launching |
Install and Launch
Install your platform's build and open Grimoire. Let first-time setup finish completely, and allow any OS security prompt when it appears — the manager needs access to game files and its own application data.
Confirm the Deadlock Path
Point Grimoire to the real Deadlock installation folder. If the manager cannot find the game, revisit the game path settings rather than guessing. Never select a shortcut or unrelated parent directory.
Review the Interface
Open the library area and identify the enable, disable, and reorder controls. Note any conflict or status warnings — these are your first diagnostic tool when something breaks later.
Enable One Mod and Test
Install a single mod, confirm it appears in the manager, enable it, and launch Deadlock. Starting with one mod makes problems trivial to isolate.
Exit Deadlock completely — to the desktop, not the background — before installing, removing, or reordering mods. Changing managed files while the game runs can prevent updates from applying correctly.
Installing Mods from GameBanana
Most Deadlock mods are hosted on GameBanana, and Grimoire connects browsing and installation into one flow. The 1-Click Install option handles download, extraction, and registration automatically when a listing supports it.
Installation workflow:
| Stage | Action | Verify |
|---|---|---|
| Browse | Open the mod listing, read description and install notes | Mod targets Deadlock and your content type |
| 1-Click Install | Select the option and allow the browser to open Grimoire | Correct mod and destination confirmed |
| Download | Keep the manager open until the download completes | No errors in status |
| Registration | Check the installed-mods view | Entry appears by listing name |
| Test | Enable the mod, launch Deadlock | Expected change appears in-game |
If the browser does not open Grimoire automatically, launch the manager manually and repeat the install action. And if a mod appears installed but has no effect, incorrect archive structure — usually an extra nested folder — is the most common cause.
You can also import local mod files directly. Preserve the archive structure described by the mod author, and avoid nesting the mod inside an additional folder unless the instructions require it.
Load Order and Conflict Fixes
Load order determines which mod wins when two enabled mods replace the same game file. In Grimoire, a later or higher-priority entry takes precedence, so arranging related content deliberately is how you control the final result.
Skins & Visuals
- Only one replacement per asset can show
- Move the preferred skin higher in the order
- Disable duplicates when troubleshooting
HUD & Crosshairs
- Large HUD packs can override smaller tweaks
- Place the defining package above overlapping mods
- Crosshair mods do not stack — pick one
Audio & Packs
- Competing audio packs supply overlapping sounds
- Put specialized mods above broad packs
- Disable duplicates to isolate the source
Conflict resolution process:
| Step | Action | Purpose |
|---|---|---|
| 1 | Check the mod list for conflict warnings | Identify overlapping files |
| 2 | Swap the order of the two conflicting mods only | See which entry controls the result |
| 3 | Disable one mod, test, re-enable, test the other | Binary isolation of the culprit |
| 4 | Restore a known-good snapshot if things worsen | Return to a clean state |
Cached assets can persist across launches. If a reordered mod shows no change, close Deadlock fully and restart before assuming the fix failed.
Profiles, Share Codes, and Hero Locker
Profiles store your entire mod selection and configuration as a reusable loadout. Export it as a .modprofile.json file for backup or transfer, or generate a share code to distribute the setup to other players.
| Feature | What It Does | When to Use |
|---|---|---|
| Mod Profile | Saves the active loadout as a named preset | Switching between setups (competitive, testing, visual) |
| Profile File | Exports/imports a .modprofile.json file | Backups and moving between installs |
| Share Code | Compact code that recreates your loadout | Sharing setups with friends or communities |
| Snapshots | Captures a working state | Safe restore point before experiments |
Hero Locker connects appearance mods to individual heroes, so you can assign a skin, ability color treatment, or ability sound per hero without touching the rest of your loadout. When several mods target the same asset, the selected override plus load order decide what appears in-game. Removing a locker selection returns that hero to the profile's remaining mods or the original asset.
Keep one stable profile for daily play and a separate experimental profile for testing new or conflicting mods. Switch back the moment testing is done.
Usage Milestones:
- Install the correct build for your platform
- Confirm Grimoire detects the Deadlock installation
- Install and test your first mod from GameBanana
- Resolve at least one load-order conflict
- Save a working loadout as a profile
Troubleshooting Common Problems
Symptom-first diagnosis saves time. Make the smallest controlled change possible, and preserve a working profile or snapshot before you start.
| Symptom | Likely Cause | First Fix |
|---|---|---|
| Mod enabled but not appearing | Another mod overrides it, or game not restarted | Check conflict indicators, reorder, restart Deadlock |
| Game crashes after new mod | Incompatible combination in the loadout | Disable the newest mod, restore a snapshot |
| Grimoire can't find the game | Wrong installation path selected | Revisit game path settings, select actual install folder |
| Wrong mod wins after reorder | Preferred entry not in effective position, cached assets | Close game fully, reapply, restart |
| macOS CrossOver / Linux oddities | Manager and game in different prefixes or bottles | Verify both point to the same installation |
To return to a fully unmodded game, disable active mods or switch to an empty profile, use the restore or undeploy workflow, and launch Deadlock clean to confirm.
For issues beyond this guide, the official documentation and the GitHub issues page are the most reliable resources. Join the official Discord through a link on grimoiremods.com to avoid impersonators.
FAQ
Q: Is Grimoire Mod Manager free to use?
Yes. Grimoire is free and open-source under the MIT license, with the source code published on GitHub. Official stats show 126k+ total downloads and 17k+ weekly users as of 2026.
Q: Do I need Deadlock installed before using Grimoire?
Yes. Install Deadlock first and confirm it launches normally, then point Grimoire to the actual installation directory during first-run setup before adding any mods.
Q: Why is my mod enabled but not showing in-game?
The usual causes are another mod overriding the same file, Deadlock needing a restart to reload the asset, or the profile not being applied after the change. Check conflict indicators, reorder if needed, and fully restart the game.
Q: How do I share my mod setup with a friend?
Save your loadout as a Mod Profile, then export it as a .modprofile.json file or generate a share code. Your friend imports the code or file, reviews the resulting loadout, and applies it.
Q: Can I go back to vanilla Deadlock after modding?
Yes. Disable all active mods or switch to an empty profile, use Grimoire's restore or undeploy workflow, and launch the game unmodded to confirm the clean state. Keep your exported profile if you want to reinstall the same loadout later.