- Grimoire Mod Manager is a free, open-source mod manager built for Deadlock, currently at v1.32.0.
- Core features cover GameBanana browsing, 1-Click Install, load order, conflict detection, and Hero Locker.
- Profiles and share codes let you save, export, and swap full mod loadouts without rebuilding them.
- Platform support includes Windows, Linux (AppImage, Debian, Flatpak), and macOS Apple Silicon options.
- Community scale exceeds 126k downloads, 17k weekly users, and 6.1k daily launches.
What Is Grimoire Mod Manager?
Grimoire Mod Manager is a free, MIT-licensed, open-source tool that keeps all Deadlock mod management in one place. Instead of manually copying .vpk files into the game folder, you browse GameBanana listings, install with one click, arrange load order, and detect file conflicts from a single interface. The project is developed openly on GitHub - Slush97/grimoire, with documentation published in the official Grimoire User Guide.
Always download Grimoire from the official website or the GitHub releases page. Avoid third-party mirrors, and join the Discord community through the link on the official site to steer clear of impersonated servers.
Feature Overview
| Feature | What It Does | Best Used For |
|---|---|---|
| GameBanana Browser | Browse Deadlock mods inside the manager | Discovering new content |
| 1-Click Install | Install GameBanana mods directly | Fast single-mod setup |
| Load Order | Control which mod overrides which | Resolving overlapping files |
| Conflict Detection | Flags mods replacing the same resource | Preventing broken loadouts |
| Hero Locker | Assign skins, colors, and sounds per hero | Cosmetic management |
| Profiles | Save and share full loadouts via codes or .modprofile.json | Switching setups |
| Vanilla Launch | Start Deadlock without mods applied | Clean testing and updates |
| Snapshots | Capture and restore known-good states | Safe troubleshooting |
Downloads and Platform Support
Choosing the right package depends on your operating system and how you prefer to install software. Grimoire publishes platform-specific builds alongside release metadata and checksums for verification.
Windows Installer
- Standard desktop installation
- Adds Grimoire like a typical app
- Recommended for most Windows users
Windows Portable
- Runs from extracted folder
- No installation process
- Good for removable drives
Linux Packages
- AppImage for any distribution
- Debian package for Ubuntu-based systems
- Make AppImage executable first
macOS users can run Grimoire on Apple Silicon through the supported macOS workflow, and cross-platform setups such as CrossOver are addressed in the troubleshooting documentation.
| Platform | Package | Recommended For |
|---|---|---|
| Windows | Installer | Most users, regular desktop use |
| Windows | Portable | Self-contained folder use |
| macOS | macOS Application | Mac users, Apple Silicon |
| Linux | AppImage | Distribution-independent use |
| Linux | Debian Package | Ubuntu, Debian-based systems |
| All | Checksums | Verifying download integrity |
Compare your downloaded file's checksum against the value published for the corresponding release asset on GitHub. This confirms the file is intact and unmodified before you run it.
Step-by-Step: From Install to Your First Mod
The first session usually involves installing the game, opening Grimoire, confirming the Deadlock directory, and enabling one mod before launch. Follow this sequence to avoid the most common first-run mistakes.
Install Deadlock First
Install Deadlock through your game library and confirm it starts normally. Close the game completely before touching any mod files so Grimoire can work with a stable installation.
Launch Grimoire and Grant Permissions
Open Grimoire after installing the right build for your OS. If your system shows a security or permission prompt, review it and allow Grimoire access to the game files and its own application data.
Confirm the Game Location
Point Grimoire to the actual Deadlock installation directory. Do not select a shortcut, a library folder, or an unrelated parent directory, or mod deployment will target the wrong path.
Install a Mod via GameBanana
Find a Deadlock mod on GameBanana, read its listing notes, and use 1-Click Install. Let Grimoire finish downloading, extracting, and registering the mod before doing anything else.
Enable and Test One Mod
Confirm the mod appears in your library, enable it, and launch Deadlock. Test only the asset the mod changes so you can cleanly attribute any problem to that single installation.
Start with exactly one mod enabled. If something breaks, you know immediately which change caused it. Add more mods one at a time, testing after each addition.
Load Order and Conflict Fixes
When two or more mods replace the same game file, the effective result is decided by load order and the mod applied last. Grimoire's conflict indicators show which entries overlap so you can arrange priorities deliberately.
Priority Guidance by Mod Type
| Mod Category | Priority Guidance | Conflict Result |
|---|---|---|
| Skins and visuals | Put the preferred skin above others for the same hero | Lower-priority skin hidden or partially overridden |
| HUD and interface | Full HUD overhauls above small panel tweaks | Overlapping elements use the higher-priority package |
| Crosshairs | Keep one reticle package active | Only one replacement appears |
| Audio packs | Preferred audio pack above competing sound mods | Mixed sources if events overlap |
| Large combined packs | Specialized mods above broad packs | Broad pack wins unless reordered |
Isolating a Conflict
| Step | Action | Purpose |
|---|---|---|
| 1 | Review conflict warnings in the mod list | Identify overlapping entries |
| 2 | Change only the relative order of the two mods | Test priority in isolation |
| 3 | Disable one mod and retest | Determine the source of the issue |
| 4 | Restore a snapshot if things worsen | Return to a known-good state |
| 5 | Re-enable mods one at a time | Confirm the fix holds |
Always close Deadlock completely before installing, removing, or reordering mods. Changing managed files while the game runs can prevent updates from applying and leave cached assets in place.
Profiles, Share Codes, and Hero Locker
Profiles store your full mod selection and configuration as a reusable loadout. A share code is compact for quick distribution, while a .modprofile.json file suits export, import, and archiving between installations.
Profile Workflow Comparison
| Method | Format | Best For |
|---|---|---|
| Profile | Saved in manager | Switching between setups |
| Profile File | .modprofile.json | Backup, transfer, archive |
| Share Code | Code string | Quick sharing with friends |
| Snapshot | Captured state | Restoring after troubleshooting |
Hero Locker connects cosmetic mods to individual heroes. You can assign a skin, ability color treatment, or ability sound to each hero, apply it to the current profile, and remove or swap overrides without rebuilding the whole loadout. When several mods target the same hero asset, the selected override and load order determine what actually appears in-game.
Export the working profile first, then share the code or file, import on the other end, review any missing or conflicting entries, and apply only after verification. Keep an exported copy before major changes so you can always roll back.
Essential Mod Management Milestones:
- Download Grimoire from the official site and verify the checksum
- Confirm the Deadlock installation directory on first run
- Install and test your first mod with only it enabled
- Save a stable profile before adding experimental mods
- Create a snapshot before adjusting load order
Troubleshooting and FAQ
Most Grimoire and mod problems fall into a few recognizable patterns: the manager or game will not start, a mod is enabled but does not appear, the game crashes after enabling a mod, or the load order produces the wrong result. In each case, restore a known-good profile or snapshot first, then reintroduce changes one at a time.
Q: Why is my mod enabled but not showing in Deadlock?
Another mod may override the same file, the game may need a restart to reload cached assets, or the selected profile was not applied after the change. Confirm the correct profile is active, check conflict indicators, disable competing replacements, apply the loadout, and restart the game.
Q: How do I restore the original unmodded game files?
Disable active mods or switch to an empty profile, then use Grimoire's restore, undeploy, or snapshot workflow. Verify the correct game installation is selected, and launch Deadlock without mods to confirm the clean state. Keep an exported profile if you want to reinstall the same loadout later.
Q: Can I use Grimoire Mod Manager on Linux or macOS?
Yes. Linux users can choose an AppImage or Debian package, and macOS users have an Apple Silicon option. On CrossOver or Linux setups, confirm Grimoire points to the same game installation the launcher actually uses and that the manager can read and write the mod and game directories.
Q: What should I do if Deadlock updates and mods stop working?
Restore a clean or vanilla launch first, then check the Grimoire GitHub releases and issue tracker for an updated build. Re-enable mods one at a time after the manager and game versions are aligned, testing after each change.