RedeeMOD 1.0.0

Release Notes

1.0.0 - Initial Release

Overview

RedeeMOD is a custom and easily extensible game launcher with modding capabilities. It provides a clean Qt-based interface for discovering game installations, managing mods per game, and launching with everything applied automatically.

Purpose

Managing mods across multiple game installations is tedious - different games, different file formats, different launch methods. RedeeMOD brings it all under one roof with a modular adapter system, so each game's quirks are handled independently while the user experience stays consistent.

Features

• Automatic Game Discovery - Scans known installation paths for Linux and Windows to locate your game files
• Mod Management - Add, track, and remove mods per game with persistent state
• Custom Path Overrides - Override default paths when games live in non-standard locations
• Modular Adapter System - Each game has its own adapter, keeping logic clean and game-specific
• Cross-Platform - Runs natively on Linux and Windows with platform-aware path resolution
• Standalone Builds - Single-file executables via PyInstaller, with automated CI via GitHub Actions

What's Included in The Package

• Standalone Binary - Prebuilt executables for Linux and Windows, ready to run
• Unreal Tournament '99 and 2004 adapters - These 2 games are the main targets of this launcher, with more to come!

What's Included in The Source Code

• Game Adapters - Modular code for seamless handling of game-specific quirks
• Discovery Engine - Platform-aware game installation path scanning with config-driven overrides
• Settings Manager - Persistent user data saving for added games and mods
• UI Components - Card designs, path check modals, dropdowns, a navigation sidebar and more!
• CI/CD Pipeline - GitHub Actions workflow building Linux and Windows binaries

Running RedeeMOD from source

After installing via pip, launch directly from the terminal:

redeemod

Or run as a Python module from the project directory:

python -m frontend.app

Build Instructions

Standalone Binary Using Pyinstaller (Default for Most)

1. Create a virtual environment (recommended):

Linux:

python -m venv venv
source ./venv/bin/activate

Windows CMD:

python -m venv venv
.\venv\Scripts\activate.bat

PowerShell:

python -m venv venv
.\venv\Scripts\Activate.ps1

2. Build with PyInstaller:

Linux:

python -m PyInstaller \
    -F -p . -n redeemod \
    -i frontend/assets/logo.ico \
    --add-data "frontend:frontend" \
    --add-data "backend:backend" \
    frontend/app.py

Windows CMD:

python -m PyInstaller ^
    -w -F -p . -n redeemod ^
    -i frontend/assets/logo.ico ^
    --add-data "frontend;frontend" ^
    --add-data "backend;backend" ^
    frontend/app.py

Powershell:

python -m PyInstaller `
    -w -F -p . -n redeemod `
    -i frontend/assets/logo.ico `
    --add-data "frontend;frontend" `
    --add-data "backend;backend" `
    frontend/app.py

NOTE: You'll find the executable in dist directory

Local CI Build (act)

act lets you run the GitHub Actions workflow locally, leaving nothing behind:

act workflow_dispatch

Configuration Options

Game discovery behavior is controlled via backend/config/config.json, which defines required paths per-game.

Custom path overrides can be provided at runtime through the application interface when defaults don't match your setup.

Known Limitations

• Linux case sensitivity - Some mods may fail to load on Linux due to case-sensitive filesystems. Renaming files or patching .int/.ini files is usually the fix
• Older UT99 mods - A small number of older mods may be broken regardless of platform; this is a mod-side issue, not a RedeeMOD limitation
• UT2K4 mod conflicts - Unreal Tournament 2004 was designed to load at most one mod at a time. Heavily customized or hardcoded mods may not work through RedeeMOD's stitching method, though the in-game Community tab can still trigger them natively

Support

For issues, feature requests, or questions, open an issue or pull request on GitHub.