Skip to main content

Overview

Welcome to the HoyoModManager documentation. This guide will help you get started with managing mods for Hoyo games and Wuthering Waves.

Getting Started

To begin, ensure you have the necessary setup and follow the instructions in the Setup section.

Features

  • Browse Game Banana mod listings.
  • Direct downloads of .rar, .zip, and .7zip files.
  • Use alternative textures for mods.
  • HTTP server to manage enabled mod state.
  • Companion Android app.
  • Create and load playlists.
  • Runs skin fix .exe automatically when regenerating the mod folder if it exists.
  • Dark and light themes using Catapuccin Mocha and Latte.

Setup

Go to settings and select the Mods folder. It is recommended to create a new folder within 3dmigoto/Mods (e.g., create Mods/managed) to use as this folder. This will decrease the work done when unzipping as no other folders need to be checked.

If you have any previous mods inside the folder that you want to keep, do the following: Settings > + Add Exclusion Directory > Select any folders that should not be deleted.

All mods are kept inside C:\Users\USER\AppData\Local\HoyoModManagerGo\cache (USER being your user). If space saver is enabled, all mods will be stored in .zip files. To delete all data after deleting the app, delete the root of this folder.

Button Actions

ButtonAction
GenerateUnzips all files from the mods that are enabled into the games export Dir.
RefreshFetches character data and rechecks local mod files for the game.
Refresh LocalRechecks local mod files. (This only needs to be pressed if you dragged a file into the cache/mods/...)

Generating

To update the mods folder after toggling the checkboxes, click generate. This will go through the mods that you have enabled and unzip them into the export Directory selected in Settings.

THIS WILL CLEAR THE FOLDER IF AN EXCLUSION IS NOT SET AND CLEAN EXPORT DIR IS ON (To set this go to settings or see setup)

It will also fill any keymaps or textures that are selected for the mod.

Showcase

Desktop

Android

Development

For development instructions, refer to the Overview section.