WoT Mod Assistant

A simple mod manager for World of Tanks. Developed primarily on Linux, with Windows support.

Compatibility

• Linux
• Windows (10+)

Important

As this tool is primarily developed on Linux, bugs and issues may arise on Windows. Please report any issues to the issue tracker.

MacOS/darwin is not currently supported.

Features:

• Install, Uninstall mods
• Deactivate, Activate mods
• Import mods from previous game versions
• Choose which game version to import mods to
• Move mods between different game versions
• Persist your theme preference (Light/Dark)
• View mod information
• Browse wgmods.net for mods
• Drag and drop mod installation for .wotmod files
• Version control for mods
  • Example: If there's a dependency for two mods, and one of them is updated, the other will be automatically updated to the latest compatible version.

Screenshots:

Planned features:

• wgmods.net compatible mod browser integration:
  • Mod listing
  • Mod search by query
    • Local cache can be searched
  • .wotmod file download and install
  • .zip file download and install
  • Mod update checking
• res_mods directory support
• Localization / language support
• Styling and theming
  • Persist theme preference across restarts

Executable installers for modpacks (.exe) will not be supported, as they won't run on Linux anyways. People should just stop creating modpacks as .exe installers and instead use .wotmod or .zip files.

Install

The recommended way to run the app is to use the Flatpak build. As the app has not yet been submitted to Flathub, you will need to build it manually for now.

Automatic releases: Tagging a commit with a v* tag (e.g. v1.0.0) triggers a CI pipeline that builds the Flatpak bundle and publishes it as a GitHub release. Install the latest release:

flatpak install --user --bundle WoTModAssistant.flatpak

Update an existing install:

flatpak install --user --reinstall --bundle WoTModAssistant.flatpak

The WoTModAssistant.flatpak bundle is attached to each release on the releases page.

• Building — build a distributable executable directory with PyInstaller.
• Running from source — run the app directly without building.
• Manual Setup — point the app at your World of Tanks install.

Running from source

The GUI is a pure Python + PySide6 application, so you can run it directly without building an executable.

1. Create a virtual environment (recommended):

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

2. Install dependencies:

   pip install -r ModManagerGUI/requirements-local.txt

3. Run the app from the ModManagerGUI directory:

   cd ModManagerGUI
   python3 main.py

   Or use the wrapper script: ./run.sh

On first run you will be prompted to select your World of Tanks install directory — choose the folder containing WorldOfTanks.exe.

Building

The project is built with PyInstaller into a single executable directory. Linux, Windows and Flatpak build workflows are provided in .github/workflows/ and can be triggered manually from the Actions tab.

The flatpak build file always takes the flatpak branch as a source, so if you want to build a flatpak release, make sure to merge your changes into the flatpak branch first.

Building the GUI

1. Set up a virtual environment with Python 3.11:

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

2. Install dependencies:

   pip install -r ModManagerGUI/requirements-local.txt

3. Build with PyInstaller from the ModManagerGUI directory:

   cd ModManagerGUI
   pyinstaller --name ModManagerGUI --windowed main.py

4. The built app is in ModManagerGUI/dist/ModManagerGUI/. Zip that directory for distribution.

Tip

You can also execute the build_linux.sh script after setting up a venv with pyside6 and pyinstaller installed. Builds can be found in the release tab.

Manual Setup

The app bundles everything it needs; there is no separate core executable to install. You only need to point it at your World of Tanks installation.

1. Run the app (python3 main.py from ModManagerGUI, or run a built release).
2. On first run, select your World of Tanks install directory — the folder containing WorldOfTanks.exe.
   • On Windows you can find it via WargamingGameCenter → World Of Tanks → Modify Installation → open game directory.
3. The app will now list your installed mods. Your settings (including theme) are saved to ~/.config/wotmodassistant/config.json.

Dependencies

• PySide6, PyInstaller, Python 3.11 (ModManagerGUI)
• modcore is a pure-Python backend, so no separate C# core is required to run the GUI.

Contributing

If you want to report bugs, request features or contribute to the project, please open an issue or a pull request. Pull requests should be made to the dev branch. Also, please make sure your code follows cross-platform standards and is tested on both Windows and Linux.

Important

Please make sure to provide a detailed description of issues. If you are submitting a pull request, please make sure to provide a detailed description of the changes.