An open API service indexing awesome lists of open source software.

https://github.com/modrexio/modrex

Mod Manager for Payday games
https://github.com/modrexio/modrex

linux mod-manager payday payday-2 payday-3 payday-the-heist windows

Last synced: 7 days ago
JSON representation

Mod Manager for Payday games

Awesome Lists containing this project

README

          

Modrex icon

# Modrex

[![Latest Release](https://img.shields.io/github/v/release/modrexio/modrex?style=flat-square&label=release)](https://github.com/modrexio/modrex/releases/latest)
[![Downloads](https://img.shields.io/github/downloads/modrexio/modrex/total?style=flat-square)](https://github.com/modrexio/modrex/releases)
[![Windows](https://img.shields.io/badge/Windows-0078D4?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyBmaWxsPSJ3aGl0ZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSIwIDAgNDQ4IDUxMiI+PCEtLSEgRm9udCBBd2Vzb21lIEZyZWUgNi43LjIgYnkgQGZvbnRhd2Vzb21lIC0gaHR0cHM6Ly9mb250YXdlc29tZS5jb20gTGljZW5zZSAtIGh0dHBzOi8vZm9udGF3ZXNvbWUuY29tL2xpY2Vuc2UvZnJlZSAoSWNvbnM6IENDIEJZIDQuMCwgRm9udHM6IFNJTCBPRkwgMS4xLCBDb2RlOiBNSVQgTGljZW5zZSkgQ29weXJpZ2h0IDIwMjQgRm9udGljb25zLCBJbmMuIC0tPjxwYXRoIGQ9Ik0wIDkzLjdsMTgzLjYtMjUuM3YxNzcuNEgwVjkzLjd6bTAgMzI0LjZsMTgzLjYgMjUuM1YyNjguNEgwdjE0OS45em0yMDMuOCAyOEw0NDggNDgwVjI2OC40SDIwMy44djE3Ny45em0wLTM4MC42djE4MC4xSDQ0OFYzMkwyMDMuOCA2NS43eiIvPjwvc3ZnPg==)](https://github.com/modrexio/modrex/releases/latest)
[![Linux](https://img.shields.io/badge/Linux-FCC624?style=flat-square&logo=linux&logoColor=black)](https://github.com/modrexio/modrex/releases/latest)
[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/tenzpx8JRM)

A desktop mod manager for [PAYDAY 3](https://store.steampowered.com/app/1272080/PAYDAY_3/), [PAYDAY 2](https://store.steampowered.com/app/218620/PAYDAY_2/), [PAYDAY: The Heist](https://store.steampowered.com/app/24240/PAYDAY_The_Heist/), and [Crime Boss: Rockay City](https://store.steampowered.com/app/2933080/Crime_Boss_Rockay_City/) powered by [modworkshop](https://modworkshop.net).

Modrex app screenshot

## Installation

| Platform | Download |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Windows | [modrex_x86_64.exe](https://github.com/modrexio/modrex/releases/latest/download/modrex_x86_64.exe) |
| Linux .deb | [modrex_x86_64.deb](https://github.com/modrexio/modrex/releases/latest/download/modrex_x86_64.deb) |
| Linux .rpm | [modrex_x86_64.rpm](https://github.com/modrexio/modrex/releases/latest/download/modrex_x86_64.rpm) |
| Linux .AppImage | [modrex_x86_64.AppImage](https://github.com/modrexio/modrex/releases/latest/download/modrex_x86_64.AppImage) |

## Features

- Supports PAYDAY 3, PAYDAY 2, PAYDAY: The Heist, and Crime Boss: Rockay City, with a searchable game picker
- Browse and search mods from modworkshop
- In-app News tab with the latest posts for each game
- Full mod detail page: description, images, downloads, changelog, dependencies, and install instructions
- Rich description rendering: formatted text, tables, collapsible sections, colored text, and inline video embeds (YouTube, Streamable)
- One-click install, uninstall, enable, and disable for `.pak`, `.zip`, `.7z`, `.rar`, `.tar.gz`/`.tar.xz`, and `.pdmod` (PDTH) mods
- Organize mods into folders with arbitrary nesting depth and drag-and-drop reordering
- Mods with multiple installed files grouped as a single card, with per-file management
- Health Check scans your entire library and bulk-repairs missing files, broken archives, outdated installs, and missing dependencies
- Update detection with selective per-mod updates
- Launch modded or vanilla directly from the app
- Automatically detects your game installation (Steam, Epic Games Store, Xbox App)
- One-click install for mod loaders: SuperBLT (PD2), DAHM and PDTHModOverrides (PDTH), UE4SS (PD3, Crime Boss)
- Identifies manually placed mod files via SHA256 lookup against a live mod index
- Discord Rich Presence shows the active game on your profile
- Automatic update checks with one-click in-app updates

## Requirements

Steam works on Windows and Linux for every supported game. Epic Games Store and Xbox App are Windows-only.

| Game | Steam | Epic Games | Xbox App |
| ----------------------- | :-----------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------: |
| PAYDAY 3 | ![yes](https://img.shields.io/badge/Yes-brightgreen) | ![yes](https://img.shields.io/badge/Yes-brightgreen) | ![yes](https://img.shields.io/badge/Yes-brightgreen) |
| PAYDAY 2 | ![yes](https://img.shields.io/badge/Yes-brightgreen) | ![yes](https://img.shields.io/badge/Yes-brightgreen) | ![no](https://img.shields.io/badge/No-red) |
| PAYDAY: The Heist | ![yes](https://img.shields.io/badge/Yes-brightgreen) | ![no](https://img.shields.io/badge/No-red) | ![no](https://img.shields.io/badge/No-red) |
| Crime Boss: Rockay City | ![yes](https://img.shields.io/badge/Yes-brightgreen) | ![yes](https://img.shields.io/badge/Yes-brightgreen) | ![no](https://img.shields.io/badge/No-red) |

## Troubleshooting

If something goes wrong, attach your log file to a [bug report](https://github.com/modrexio/modrex/issues).

| Platform | Path |
| -------- | ---------------------------------- |
| Windows | `%APPDATA%\Modrex\logs\modrex.log` |
| Linux | `~/.config/modrex/logs/modrex.log` |

## Development

| Command | Description |
| ------------------------ | ---------------------------------- |
| `pnpm install` | Install dependencies |
| `pnpm dev` | Start with hot reload |
| `pnpm build` | Production build |
| `pnpm typecheck` | Type-check renderer |
| `pnpm format` | Format all files with Prettier |
| `pnpm lint` | Lint renderer source |
| `pnpm test` | Run all tests (Rust + renderer) |
| `pnpm generate-licenses` | Regenerate THIRD_PARTY_LICENSES.md |

## Tech stack

Tauri v2 · React · Tailwind CSS · Lucide · TypeScript

## License

Modrex is open source under the [MIT License](LICENSE).