UE MM

A mod manager for Unreal Engine games: installs pak, Blueprint and UE4SS mods safely, installs UE4SS itself, and lists the game's openmods mods.

  • GPL-3.0 · open source
  • 26 stars
  • Latest release v2.3.2
  • Updated 2 days ago
  • Tools
Description

UE MM

A mod manager for Unreal Engine games: Black Myth: Wukong, Mortal Shell II, Phantom Blade Zero and WUCHANG: Fallen Feathers, Stellar Blade as experimental, and Stellar Blade: Blood Rain as a preview of its look until the game is out. One app for every game: you pick the game, and the app takes its look.

What it does

  • Installs mods from a .zip, .7z or .rar download, a .pak file or a mod folder: drop it on the window. Every download is unpacked and checked first, and nothing inside it is ever run.
  • Handles pak mods (.pak, .utoc + .ucas), Blueprint mods (LogicMods), UE4SS Lua and DLL mods, for Phantom Blade Zero PBZModLoader mods, and for Black Myth: Wukong mods for the C# Loader.
  • Lists the open-source mods for your game on openmods.nexus, and installs or updates one with a click.
  • Enables, disables, updates and uninstalls mods. It keeps its own copy of every mod and records a checksum for every file it places. Files it did not place are never overwritten or removed.
  • Installs and updates UE4SS for the game, and shows the UE4SS log with its errors and warnings.
  • Changes nothing while the game runs, and keeps the settings you changed in a mod's config.lua across updates.
  • Backs up your saves each time it starts the game, or at a click: keep the backups you want for good, and give each a note, such as "Before the final boss".
  • Reset modding takes the game back to its original files in one step, so you can start clean.
  • Starts the game with the launch options you set; Black Myth: Wukong starts with -fileopenlog, which its pak mods need.
  • Speaks English, Simplified Chinese (简体中文), Traditional Chinese (繁體中文), Vietnamese (Tiếng Việt), Japanese (日本語) and Korean (한국어): choose in Settings ▸ Language.

Screenshots

The Home page of UE MM

How to install

  1. Install the .NET 8 Desktop Runtime (x64) if you do not have it.
  2. Download uemm_<version>.zip, one zip for every game, from the latest release.
  3. Unzip it into a folder you can write to, for example Documents\UE MM, not C:\Program Files.
  4. Start UEModManager.exe and choose your game. It finds the game through Steam or the Epic Games Launcher; otherwise choose the game folder in Settings. Switch game in the title bar changes the game at any time.

The app is portable: it keeps everything in a Data folder next to the exe.

Update: the app checks for a new version at every start and can update itself.

Remove: use Settings → Reset modding… first, so the game is back to its original files, then delete the app's folder.

How to use

  • Home: drop a download on the window, or use Install from 7z/zip/rar…. A review shows what goes where before anything reaches the game.
  • Mods: turn mods on and off, update or uninstall them, and edit or reset a mod's settings.
  • openmods: the open-source mods for your game, with a type on every card, search, sort and Hide installed. One click installs or updates a mod. Full view shows them over the whole window. A click on a mod's cover shows its cover and screenshots, one at a time. Changelog shows what changed in its newest releases.
  • UE4SS: install or update UE4SS, open its folder, and read its log.
  • Backups: back up your saves, choose how many the app keeps, keep some for good in Personal, and restore one.
  • Settings: the game folder, the tray icon, and the manager's data, logs and backups. Reset modding… removes every mod and UE4SS from the game; you choose whether the mods also leave the manager. Report a problem… makes a report for the help channel on Discord.

For scripts, the same exe is a command line tool: UEModManager.exe --cli --help lists its commands.

Compatibility

  • Black Myth: Wukong, Mortal Shell II, Phantom Blade Zero, Stellar Blade and WUCHANG: Fallen Feathers, on Steam, on the Epic Games Store where the game is sold there, or in a folder chosen by hand. Stellar Blade: Blood Rain shows its look only, until the game is out.
  • Stellar Blade is experimental: its support is new and not fully checked yet.
  • Mortal Shell II, Stellar Blade and WUCHANG: Fallen Feathers are in See all games in the game picker.
  • Your game is missing? In the game picker, Missing your game? Tell us on Discord scans its folder and makes a report to share.
  • Windows 10 or 11, 64-bit.

Known issues

  • No load order yet: neither pak priority nor UE4SS's mods.txt order.

How to build

On Windows, with the .NET 10 SDK (version 10.0.100 or a later feature band, pinned in global.json), from the repository root in PowerShell:

./publish.ps1

It runs the tests and builds the release file dist/release/uemm_<version>.zip, and the same zip under the name older versions of the app look for. The zip holds one UEModManager.exe for every game, a single file that needs the .NET 8 Desktop Runtime. To build only the app:

dotnet publish src/UEManager.UI/UEManager.UI.csproj -c Release -o dist/app

Credits

License: GNU General Public License, version 3, with additional terms in NOTICE.md.