Deadlock Mod Manager

A mod manager for the Valve game Deadlock, built with Tauri, React, and TypeScript.

Download · Documentation · Report Bug · Request Feature

Table of Contents

Features
Installation
Usage
Sponsors
Development
Translation & Localization
Contributing
License
Contact
Acknowledgments

Features

Mods Store - Browse the GameBanana catalog of mods, sounds, maps, and WIPs with search, hero and category filters, favorites, and sorting.
One-click installs - Download mods, pick files or variants, and pause, resume, or retry downloads. Local mod files can be imported too.
Mods Library - Enable, disable, reorder, update, and reinstall mods, with conflict warnings and backups.
Hero Skins - Pick the active skin per hero, manage variants, and toggle sounds and other hero mods separately.
Profiles - Keep separate mod setups and share them with friends using a Profile ID.
Mod Foundry - Edit and build hero skins inside the app.
Customization - Crosshair editor, autoexec config editor with a command library, and themes.
Server Browser and Stats - Find community servers (required maps and addons are checked before joining) and view match, hero, and item stats.
Discord game presence - Show what you're playing in Deadlock on Discord.

See the features overview for the full list.

Installation

Download the latest installer for Windows or Linux (.exe, .deb, .rpm, .flatpak) from the releases page, or use a package manager:

# Windows (winget)
winget install --id=Stormix.DeadlockModManager

# Ubuntu/Debian (APT) - for the CEF (Chromium) build, replace "stable main" with "stable cef"
curl -fsSL https://apt.deadlockmods.app/key.gpg | sudo tee /usr/share/keyrings/deadlock-mod-manager.gpg > /dev/null
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/deadlock-mod-manager.gpg] https://apt.deadlockmods.app stable main" | sudo tee /etc/apt/sources.list.d/deadlock-mod-manager.list
sudo apt update && sudo apt install deadlock-mod-manager

# Arch Linux (AUR)
yay -S deadlock-modmanager

# nixpkgs
nix-shell -p deadlock-mod-manager --run deadlock-mod-manager

# Gentoo (third-party ::deftera overlay)
sudo eselect repository add deftera git https://github.com/Deftera186/deftera-overlay.git
sudo emaint sync --repo deftera
sudo emerge -av games-util/deadlock-modmanager-bin

See the installation guide for platform-specific steps, CEF builds, and the development AUR package.

Usage

For detailed installation instructions, getting started guides, troubleshooting, and feature documentation, please visit our comprehensive documentation:

Player Guide - Installation, usage, and troubleshooting

For help and support:

Warning

Linux Support - Limited

Linux support is provided on a best-effort basis. Due to a lack of contributors with Linux expertise and the maintainer's limited experience distributing software across the many Linux distributions, you may encounter packaging issues, missing dependencies, or platform-specific bugs. If you're a Linux user and want to help improve support, contributions are very welcome! Please reach out on Discord or open a PR.

Development

For development setup, project architecture, contributing guidelines, and API integration documentation, please visit:

Developer Documentation - Development setup and architecture
API Reference - Interactive API documentation

Quick start

You need Node.js 24.8+, pnpm, Bun 1.4.2+, and Rust (stable), plus the Tauri prerequisites for your platform (Visual Studio C++ Build Tools and WebView2 on Windows, WebKitGTK and friends on Linux).

git clone https://github.com/deadlock-mod-manager/deadlock-mod-manager.git
cd deadlock-mod-manager
pnpm install
pnpm desktop:dev

The desktop app talks to the production API by default, so you don't need a local database to work on it. To run the API, web app, and other services locally, follow the development setup guide (Docker, .env, pnpm db:push).

Development with Nix (Linux only)

For Linux developers, we provide a complete Nix development environment:

# Clone and enter the project
git clone https://github.com/deadlock-mod-manager/deadlock-mod-manager.git
cd deadlock-mod-manager

# Start development shell (or use direnv for automatic loading)
nix develop

# Install dependencies and start
pnpm install
pnpm desktop:dev

The Nix environment includes everything you need: Rust, Node.js, pnpm, Docker, system libraries, and all development tools.

For detailed Nix setup instructions, see CONTRIBUTING.md.

Translation & Localization

🌍 Help us translate Deadlock Mod Manager!

We're actively working to make Deadlock Mod Manager accessible to users worldwide. Join our translation efforts and help bring the mod manager to your language!

Currently Supported Languages

Language	Native Name	Status	Contributors
🇺🇸 English (Default)	English	✅ Complete	-
🇧🇬 Bulgarian	Български	🚧 5%	macchiako
🇧🇾 Belarusian	Беларуская	🚧 In Progress	drodn
🇩🇪 German	Deutsch	🚧 39%	skeptic
🇫🇷 French	Français	🚧 35%	stormix
🇷🇺 Russian	Русский	🚧 28%	awkward_akio, Thyron
🇸🇦 Arabic	العربية	🚧 12%	archeroflegend
🇵🇱 Polish	Polski	🚧 52%	_manio
🇨🇭 Swiss German	Schwiizerdütsch	🚧 5%	degoods_deedos
🇹🇭 Thai	ไทย	🚧 8%	altqx
🇹🇷 Turkish	Türkçe	🚧 6%	kenanala
🇨🇳 Chinese (Simplified)	简体中文	🚧 48%	待到春深方挽柳
🇹🇼 Chinese (Traditional)	繁體中文	✅ Complete	白雲
🇪🇸 Spanish	Español	✅ Complete	chikencio
🇧🇷 Portuguese (Brazil)	Português (Brasil)	🚧 35%	meneee
🇮🇹 Italian	Italiano	🚧 7%	Constrat
🇯🇵 Japanese	日本語	🚧 11%	hiropiki
🇰🇷 Korean	한국어	🚧 16%	Quinnly_IRL

How to Help

All translations are managed on Crowdin. Translations are synced back into this repository automatically via the Crowdin GitHub action, so you don't need to edit JSON files directly.

Translate on Crowdin: Head to translate.deadlockmods.app and pick your language - approved translations are proposed as a PR automatically
Join our Discord server: join our Discord server and visit the #translations channel for coordination
Suggest a new language: Open a request on Crowdin, or file an issue if the language isn't listed there

Translation files are located in apps/desktop/src/locales/ and loaded via react-i18next. Only en.json is edited directly in the repo; all other locales are managed through Crowdin.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

For comprehensive contributing guidelines, development setup, code style standards, and best practices, please see:

CONTRIBUTING.md
Contributing Documentation

AI-Assisted Contributions: We welcome AI-assisted contributions! Please review our AI Policy for guidelines on disclosure and quality expectations.

Top contributors:

(back to top)

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE.md file for details.

Vendored and copied-in third-party source (vpkmerge, ValveResourceFormat, shadcn/ui, and others) is documented in THIRD-PARTY-NOTICES.md.

Disclaimer: This project is not affiliated with Valve Corporation. Deadlock and the Deadlock logo are registered trademarks of Valve Corporation.

Contact

Project Repository: GitHub
Issues & Bug Reports: GitHub Issues
Feature Requests: GitHub Discussions
Discord Community: Join our Discord
Author: Stormix

For support and questions, please use GitHub Issues or join our Discord community. We're always happy to help!

Acknowledgments

This project was only possible thanks to the amazing open source community, especially:

Special Thanks

GameBanana - Our primary mod source and the backbone of this application. GameBanana provides the comprehensive mod database and API that makes browsing, discovering, and downloading Deadlock mods possible. This project would not exist without their excellent platform and community-driven content.
Jelloge/Deadlock-Rich-Presence - Discord Game Presence was only possible thanks to this project and its work mapping Deadlock console log events for rich presence.
vpkmerge - Source 2 texture, KV3 and sound codecs used by the Mod Foundry (MIT).
ValveResourceFormat - Source 2 resource format research the Foundry's codecs and model preview are adapted from (MIT).
RapidRAW - A Tauri project that inspired our CI pipelines, Linux optimizations, and packaging/distribution approach. Thank you for sharing your setup and best practices.

Open Source Libraries

Framework & Build

Backend

UI & Styling

TanStack

Other

(back to top)

Name		Name	Last commit message	Last commit date
.agents		.agents
.changeset		.changeset
.cursor		.cursor
.github		.github
.tauri		.tauri
.vscode		.vscode
apps		apps
distribution/aur		distribution/aur
docker/initdb		docker/initdb
docs		docs
infrastructure		infrastructure
packages		packages
rfcs		rfcs
scripts		scripts
tools		tools
.bun-version		.bun-version
.coderabbit.yaml		.coderabbit.yaml
.dockerignore		.dockerignore
.envrc		.envrc
.gitignore		.gitignore
.mcp.json		.mcp.json
.npmrc		.npmrc
.nvmrc		.nvmrc
.oxfmtrc.json		.oxfmtrc.json
.oxlintrc.json		.oxlintrc.json
.pnpmfile.mjs		.pnpmfile.mjs
.todo		.todo
AGENTS.md		AGENTS.md
AI_POLICY.md		AI_POLICY.md
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.md		LICENSE.md
README.md		README.md
SECURITY.md		SECURITY.md
THIRD-PARTY-NOTICES.md		THIRD-PARTY-NOTICES.md
compose.yml		compose.yml
crowdin.yml		crowdin.yml
env.example		env.example
flake.lock		flake.lock
flake.nix		flake.nix
knip-baseline.txt		knip-baseline.txt
knip.json		knip.json
languages.json		languages.json
lefthook.yml		lefthook.yml
package.json		package.json
package.nix		package.nix
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
skills-lock.json		skills-lock.json
tsconfig.json		tsconfig.json
turbo.json		turbo.json

Navigation Menu

Repository navigation

About

Repository files navigation

Deadlock Mod Manager