Skip to content

deadlock-mod-manager/deadlock-mod-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

735 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Deadlock Mod Manager

Downloads Contributors GitHub Release GitHub Issues or Pull Requests Better Stack Badge Ask DeepWiki License Discord Built with Tauri


Logo

Deadlock Mod Manager

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

Download · Documentation · Report Bug · Request Feature

Windows Linux AUR

Deadlock Mod Manager
Table of Contents
  1. Screenshots
  2. Usage
  3. What's inside?
  4. Development
  5. Translation & Localization
  6. Contributing
  7. License
  8. Contact
  9. Acknowledgments
  10. Sponsors

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:

Development with Nix (Linux only)

Built with Nix

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 Български ✅ Complete macchiako
🇩🇪 German Deutsch ✅ Complete skeptic
🇫🇷 French Français ✅ Complete stormix
🇷🇺 Russian Русский ✅ Complete awkward_akio, Thyron
🇸🇦 Arabic العربية ✅ Complete archeroflegend
🇵🇱 Polish Polski ✅ Complete _manio
🇨🇭 Swiss German Schwiizerdütsch ✅ Complete degoods_deedos
🇹🇭 Thai ไทย ✅ Complete altqx
🇹🇷 Turkish Türkçe ✅ Complete kenanala
🇨🇳 Chinese (Simplified) 简体中文 ✅ Complete 待到春深方挽柳
🇹🇼 Chinese (Traditional) 繁體中文 ✅ Complete 白雲
🇪🇸 Spanish Español ✅ Complete chikencio
🇧🇷 Portuguese (Brazil) Português (Brasil) ✅ Complete meneee
🇮🇹 Italian Italiano ✅ Complete Constrat
🇯🇵 Japanese 日本語 ✅ Complete hiropiki

How to Help

  1. Join our Discord server: First join our Discord server to access the translation channels
  2. Visit the translation channel: Head to the #translations channel
  3. Suggest a new language: Open an issue to request support for your language
  4. Improve existing translations: Found an error or better phrasing? Submit a PR!

Translation Helper Script

We provide an interactive CLI tool to make translating easier:

pnpm translate

The script offers two modes:

  • Create a new translation: Guides you through creating a complete translation for a new language
  • Update an existing translation: Finds missing strings and lets you translate only what's needed

Features:

  • Step-by-step translation with English reference text
  • Pause anytime with pause command - your progress is saved
  • Continue later using "Update existing translation"
  • Automatic registration in all required files

Translation files are located in apps/desktop/src/locales/ - we use react-i18next for internationalization.

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:

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

Top contributors:

contrib.rocks image

(back to top)

License

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

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

Contact

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.
  • 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

Sponsors

SignPath

Free code signing on Windows provided by SignPath.io
Certificate by SignPath Foundation

(back to top)