GoH Mod Manager is a PySide6 desktop app for managing mods for Call to Arms - Gates of Hell.
It is built for the everyday Gates of Hell modding loop: find installed mods,
shape a load order, save presets, share setups with friends, and get back into
the game without hand-editing options.set.
- Discovers local and Steam Workshop mods.
- Reads and writes the active load order from the game profile.
- Keeps named presets for different play sessions.
- Imports mods from folders and archives.
- Exports and imports share codes.
- Supports translated UI strings through Qt
.ts/.qmfiles.
Requirements:
- Python 3.12+
- uv
Install dependencies:
uv syncRun the desktop app:
uv run python -m src.mainRun the CLI status command:
uv run python -m src.cli.main statusInstall development and documentation tools:
uv sync --group dev --group docsCommon checks:
uv run pre-commit validate-config
uv run python -m compileall -q src tests scripts
uv run python scripts/validate_translations.py
uv run python scripts/build_translations.py --no-update
uv run deptry .
uv run ruff check .
uv run ruff format --check .
uv run basedpyright
uv run pytest -qInstall local git hooks:
uv run pre-commit installsrc/core/: domain-facing facade, events, config model, constantssrc/application/: query surfaces, use cases, immutable state objectssrc/services/: persistence, parsing, Steam discovery, imports, share codessrc/ui/: PySide6 windows, widgets, controllers, workers, translationssrc/cli/: command-line entry pointtests/: pytest suite and stable fixturesdocs/: hand-written project documentation and static site pageswww/: static GitHub Pages site root; Zensical writes docs towww/doc/scripts/: build, packaging, and translation helpers
The architecture overview lives in docs/architecture.md.
Translations are hosted on Weblate, which makes contributing UI translations possible without setting up a local development environment: GoH Mod Manager - Qt UI on Weblate.
- Source files:
src/ui/i18n/*.ts - Runtime files:
src/ui/i18n/*.qm - Validation:
scripts/validate_translations.py - Build helper:
scripts/build_translations.py
For the actual translation workflow, naming rules, and maintainer checklist, see src/ui/i18n/README.md.
Build the docs site:
uv run --group docs zensical buildServe it locally:
uv run --group docs zensical serveThe public project site is deployed from main to GitHub Pages from www/,
with the docs generated under /doc/.
Prebuilt Windows and Linux binaries are published in GitHub Releases.
Local release-style builds use:
uv run python scripts/build_app.pyUseful variants:
uv run python scripts/build_app.py --onedir
uv run python scripts/build_app.py --onefile --package
uv run python scripts/build_app.py --skip-testsThis project is licensed under the MIT License. See LICENSE.
- Logo design by awasde
- Original mod manager concept by Elaindil (MrCookie). This project is an independent implementation and does not reuse its code.