Skip to content
GameModManagerPublic

Latest commit

 

History

1,471 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GameModManager

A cross-platform, plugin-driven game mod manager. Game-specific logic lives in shared libraries loaded at runtime, so adding a new game never requires a core rebuild.

Warning

This project is under active development and may break between releases.

Main UI Preview


Overview

GameModManager is a mod manager built around a stable C ABI and a Qt-free engine core. It runs on Linux and Windows, with macOS planned. The UI follows the familiar MO2-style layout, while the engine keeps platform-specific logic behind a clean abstraction layer.

Notable Features

  • Plugin-driven game support - each game is a separate shared library loaded via a stable C ABI (dlopen/LoadLibrary). No core rebuild to add a game.
  • Cross-platform deploy strategies - OverlayFS (Linux default), symlink, hardlink, and FUSE VFS, with Windows USVFS and NTFS junction planned.
  • MO2-style mod list - virtual mod list with drag-and-drop reordering, a fixed game-native band, separators, and conflict status icons.
  • Conflict detection - priority-ordered file overwrites with resolution dialogs.
  • Downloads - Nexus and Steam Workshop sources, per-file progress and pause, nxm:// link routing via IPC.
  • modl:// protocol - Mod.Pub link handler: paste a modl:// URL into the app or CLI to trigger a download. Source attribution distinguishes Mod.Pub from arbitrary direct URLs.
  • Headless CLI - launch games and handle nxm:// / gmm:// links without the UI.
  • Themeable UI - QSS token templates (Dark and Nord bundled).
  • Python scripting - embedded via pybind11.
  • Multi-instance - portable and global instances.

Supported Games

Game Status Plugin
The Binding of Isaac: Rebirth Supported TheBindingOfIsaacRebirth.so / .dll
Skyrim Special Edition Supported SkyrimSpecialEdition.so / .dll

Tool plugins (non-game): ImageDiff, IsaacModSorter.

Adding a new game requires only a new plugin file.


Building from Source

Dependencies

Library Version Purpose
Qt 6 >= 6.0 UI framework
Qt6Keychain >= 0.14 OS keyring backend
libzip - Archive extraction
sqlite3 - Mod cache
yaml-cpp - Config / masterlist parsing
libcurl - HTTP downloads
nlohmann/json - JSON parsing
pybind11 2.13.6 (fetched) Python embedding
Python 3 >= 3.10 Plugin scripting
libfuse3 (optional) VFS/OverlayFS deploy

Linux (Ubuntu/Debian)

# Install dependencies
sudo apt-get update
sudo apt-get install -y \
    qt6-base-dev cmake g++ \
    libzip-dev libsqlite3-dev libyaml-cpp-dev \
    libcurl4-openssl-dev nlohmann-json3-dev \
    libfuse3-dev libpython3-dev \
    qtkeychain-qt6-dev \
    icoutils

# Clone with submodules
git clone --recurse-submodules https://github.com/PetricaT/GameModManager.git
cd GameModManager/Core

# Configure (Release recommended - Debug bloats the binary ~12x)
cmake -B build -DCMAKE_BUILD_TYPE=Release

# Build
cmake --build build -j$(nproc)

# The binary is at build/gamemodmanager
# Plugins are at build/plugins/

Windows

# Install dependencies via vcpkg
vcpkg install qt6-base qtkeychain libzip sqlite3 yaml-cpp libcurl nlohmann-json pybind11 python3 --triplet x64-windows

# Clone with submodules
git clone --recurse-submodules https://github.com/PetricaT/GameModManager.git
cd GameModManager/Core

# Configure
cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake"

# Build
cmake --build build --config Release

macOS

Note

macOS support is planned. The build should work, but platform-specific paths and native launch are not yet implemented.

# Install dependencies via Homebrew
brew install qt@6 qtkeychain libzip sqlite3 yaml-cpp curl nlohmann-json python@3

# Clone with submodules
git clone --recurse-submodules https://github.com/PetricaT/GameModManager.git
cd GameModManager/Core

# Configure
cmake -B build -DCMAKE_BUILD_TYPE=Release \
    -DCMAKE_PREFIX_PATH="$(brew --prefix qt@6)"

# Build
cmake --build build -j$(sysctl -n hw.ncpu)

Thank You

GameModManager would not exist without the incredible work of the modding community. We stand on the shoulders of giants, and we want to give credit where it is due.

ModOrganizer 2 Community

The single biggest inspiration for this project. MO2's architecture, plugin system, virtual filesystem, and UX have shaped GameModManager at every level.

Plugin & Tool Authors

NIFSkope

The NIF file format library and tools. Our shader lighting math is derivative of NIFSkope's work and is used under its BSD license.

Nexus Mods

Other Mod Managers

Game Studios

  • Bethesda Game Studios - for creating the Elder Scrolls and Fallout series, and for the modding-friendly file formats (NIF, BSA/BA2, ESP/ESM) that this project supports
  • Valve - for Steam, the Steamworks SDK, and for fostering a modding ecosystem
  • Edmund McMillen & Nicalis - for The Binding of Isaac, and for the ANM2 animation format our viewer supports

The Modding Community

To every mod author, every tool creator, every wiki contributor, and every player who has ever installed a mod - thank you. This project exists because of you.

Releases

Packages

Contributors

Languages