WoT Mod Assistant

A simple cross-platform mod manager for World of Tanks.

Compatibility

• Windows (10+)
• Linux

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 support is not planned but not explicitly impossible.

Features:

• Install, Uninstall mods
• Deactivate, Activate mods
• Import mods from previous game versions
• Browse wgmods.net for mods
• Drag and drop mod installation for .wotmod files

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
  • Modpack support
  • Mod update checking
• res_mods directory support
• Localization / language support
• Styling and theming
• Autoupdater for ModManagerCore

Installing

Following is an unfinished guide on how to install ModManagerCore and ModManagerCoreGUI.

Tip

If you have trouble with automatic setup, please consult the Manual Installsection of this readme.

Linux

Tip

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

1. Download or build the project.
2. Run ModManagerGUI.
3. It should prompt you to select your game directory.
4. Select the directory containing WorldOfTanks.exe

Windows

Tip

Please download the latest Windows release build from the release tab.

1. Download and unzip the latest release.
2. Run ModManagerGUI.exe.
3. On first run, it will prompt you to select the game directory, you can find it by checking the WargamingGameCenter->World Of Tanks->Modify Installation->open game directory.
4. Select the path to WorldOfTanks.exe.

Manual Install & Setup

Linux

1. Create a new directory wotmodmanager, and a directory called Core inside it.
2. Build or install the ModManagerCore to the newly created wotmodmanager/Core directory.
3. Install the CoreGUI in the parent folder, so that the Core directory one directory deeper as the CoreGUI executable.
4. Important step: Run the ModManagerCore executable, it will prompt you to enter your World of Tanks install directory path. This means the directory where WorldOfTanks.exe resides.
5. Now, run the CoreGUI and you should see it automatically listing mods.

Windows

1. Download the .zip archive and extract.
2. Inside it, find the _internal/Core folder.
3. Run ModManagerCore.exe and set up your World Of Tanks install path (the directory where WorldOfTanks.exe resides.)
4. Run the CoreGUI from the main directory.

Dependencies

• PySide6, PyInstaller, Python 3.11x (ModManagerCoreGUI)
• Newtonsoft.Json, .NET 8.0 (ModManagerCore)

Please check the project's subdirectories readme files for more information on how to build.

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.