- Grimoire Mod Manager GitHub repo hosts the open-source code at github.com/Slush97/grimoire.
- MIT license: free to use, modify, and inspect the full source code.
- Official releases: download Windows, Linux, and macOS builds from the Releases page.
- Security tip: verify checksums and avoid third-party mirrors when downloading.
- Community support: report bugs through GitHub Issues and the official Discord.
Grimoire Mod Manager GitHub Repository Overview
Grimoire Mod Manager is a free, open-source mod manager for Deadlock, and its entire codebase lives on GitHub under the repository Slush97/grimoire. Because the project is open source under the MIT license, anyone can inspect how the manager handles mod deployment, load order, conflict detection, and profiles — a significant trust advantage for a tool that modifies your game files.
The GitHub repository serves three main purposes for the community:
| Purpose | What You'll Find | Who Uses It |
|---|---|---|
| Source code | Full application code, commit history, branches | Developers, contributors |
| Releases | Versioned installers for Windows, Linux, macOS | Regular users |
| Issue tracker | Bug reports, feature requests, community answers | All users |
A mod manager writes directly into your Deadlock installation. With the Grimoire Mod Manager GitHub repository public, the community can audit every deployment change instead of trusting a closed binary — and the MIT license means the project can be forked or audited freely.
Releases and Download Options
The Releases section of the GitHub repository is the canonical place to download official builds. The official Grimoire website mirrors these downloads, so either source is acceptable — just avoid unverified third-party mirrors.
| Platform | Package Type | Best For |
|---|---|---|
| Windows | Installer | Most Windows users, standard desktop setup |
| Windows | Portable | Self-contained folder, no installation |
| macOS | Apple Silicon app | Mac users, native desktop launch |
| Linux | AppImage | Distribution-independent use |
| Linux | Debian package | Ubuntu, Debian, and compatible distros |
The project publishes updates frequently — the website lists an average release cadence of every few days, with the current shown version at v1.32.0 and over 126k total downloads across builds.
Installer Builds
- Standard setup for Windows and Debian-based Linux
- Integrates with your desktop environment
- Simplest option for most users
Portable Builds
- No installation required, runs from folder
- Good for removable drives or locked-down systems
- Keep everything in one self-contained directory
Checksums
- Verify downloads against published release hashes
- Confirm file integrity before running
- Compare local checksum with the release asset value
Always download from the official GitHub Releases page or grimoiremods.com. Mod managers are a common target for repackaged malware on third-party download sites. If a mirror offers a build you cannot find on official channels, treat it as untrusted.
How to Get Started from GitHub
Follow this workflow to go from the GitHub repository to a working Deadlock mod setup. You do not need to compile anything — prebuilt binaries are attached to each release.
Install Deadlock First
Install Deadlock through Steam and confirm the game launches normally. Close the game completely before setting up any mod manager — changing managed files while the game runs can prevent updates from applying.
Download from GitHub Releases
Visit the Releases page on the Grimoire Mod Manager GitHub repository, pick the package matching your operating system, and verify the checksum against the published release metadata.
Launch and Grant Permissions
Open Grimoire and allow the first-time setup. If your OS shows a security or permission prompt, review it and allow the manager to access its own application data and game files.
Point Grimoire at Deadlock
Select the actual Deadlock installation directory when prompted — not a shortcut or a parent library folder. Grimoire must recognize the game before it can deploy mods.
Install and Enable Your First Mod
Browse GameBanana listings inside Grimoire, use 1-Click Install where available, confirm the mod appears in your library, enable it, then launch Deadlock and test the result.
Enable one mod at a time for your first session. This makes it easy to verify each installation works and to isolate the cause if something behaves unexpectedly later.
Key Features You Can Audit in the Source
Because the code is public, every headline feature on the official site corresponds to code you can review on GitHub. The core feature set includes:
| Feature | What It Does | GitHub Coverage |
|---|---|---|
| GameBanana browsing | Discover and install Deadlock mods in-app | Fully auditable |
| Load order | Control which enabled mod takes priority | Fully auditable |
| Conflict detection | Flags mods replacing the same files | Fully auditable |
| Hero Locker | Per-hero skins, ability colors, sounds | Fully auditable |
| Profiles | Save and share full mod loadouts via codes | Fully auditable |
| Vanilla Launch | Start Deadlock without any mods applied | Fully auditable |
Grimoire also supports snapshots — saved states of your mod loadout you can restore when an experiment goes wrong. Combined with the Vanilla Launch option, this gives you a reliable path back to a clean install at any time.
Safe GitHub Workflow Checklist:
- Download only from official GitHub Releases or grimoiremods.com
- Verify checksums before running any installer
- Report bugs through GitHub Issues, not third-party forums
- Join the official Discord via the website footer link
- Keep profiles exported before major loadout changes
Troubleshooting Through GitHub Issues
When something breaks, the GitHub issue tracker is the official channel for bug reports. Before filing an issue, run through the most common fixes:
| Symptom | Likely Cause | First Fix |
|---|---|---|
| Manager won't open | Permission or blocked install | Re-download, verify checksum, allow permissions |
| Mod enabled but no effect | Another mod overrides the same file | Check load order and conflict indicators, restart game |
| Game crashes after enabling mod | Incompatible mod combination | Disable newest mod, restore snapshot |
| Wrong game path detected | Shortcut selected instead of install dir | Re-select the actual Deadlock installation |
| Mods break after Deadlock update | Game files changed by the patch | Check GitHub Issues for a manager update, restore vanilla, wait for fix |
When filing a GitHub issue, include your Grimoire version, OS and package type, the exact symptom, and your loadout. Issues with reproduction steps get resolved faster than general complaints.
FAQ
Q: Where is the official Grimoire Mod Manager GitHub repository?
The official repository is github.com/Slush97/grimoire, released under the MIT license. It hosts the full source code, release builds for Windows, Linux, and macOS, and the public issue tracker.
Q: Is Grimoire Mod Manager free?
Yes. The project is open source under the MIT license and distributed at no cost through GitHub Releases and the official website. Anyone can use, inspect, and modify the code within the terms of the license.
Q: Should I download from GitHub or the official website?
Both are official. The GitHub Releases page is the canonical source with checksums, while grimoiremods.com presents the same builds with platform guidance. Avoid third-party mirrors entirely.
Q: Can I contribute to the Grimoire Mod Manager GitHub project?
Yes. As an MIT-licensed open-source project, the repository accepts community contributions. Review the repository's guidelines, and use GitHub Issues for bug reports and feature requests. Community discussion also happens on the official Discord, linked from the website footer.