Prerequisites

In order to use this mod you must have Hades installed on your system when playing Hades II. You cannot uninstall Hades after installing the mod, as the mod will not work without it.

It is recommended to have both Hades and Hades II installed through the same platform (e.g. both through Steam or both through Epic), and in the same parent directory, but it is not necessary.

[!CAUTION] To be able to use the mod, Hades must be installed at ALL TIMES.

Installation

[!CAUTION] You should always make backups of your save files before installing mods, and regularly create new backups when using mods. If something changes in the game, mods might break and your save files might not be able to be loaded until they are updated. To back up a save slot, back up all files starting with Profile<Your Save Slot Number> located in C:\Users\<username>\Saved Games\Hades II.

[!WARNING] If you have mods for Hades installed, please remove them before installing and when playing Hades II with Zagreus' Journey enabled, as mods for Hades directly modify game files and very likely will interfere with this mod's ability to read required data. You can uninstall mods by renaming the Mods folder in your Hades installation to something else, and running modimporter.exe.

You can install this mod just like any other Hades II mod available on Thunderstore, the recommended mod manager is r2modman. Install r2modman by using Manual Download on the linked page, and running the setup executable in the downloaded .zip file.

Afterwards, you can find Zagreus' Journey on the Online tab in r2modman, or use Install with Mod Manager on the mod's Thunderstore page. The mod manager will automatically install any other mods this mod needs to work correctly. Start the game through the mod manager to make sure mods are enabled - use the Start Modded button on the top left. You can find Steam launch arguments on the Help page in r2modman, which will start the game with mods from Steam once set.

If you have both Hades and Hades II installed in the same folder (i.e. the default steamapps/common folder for Steam games), you don't need to do anything else. Otherwise, change the hadesGameFolder config option in the mod config to point to the folder that contains your Hades installation, as an absolute path, such as C:\Program Files (x86)\Steam\steamapps\common\Hades for a Steam installation or C:\Program Files (x86)\Epic Games\Games\Hades for Epic Games (your paths may be different from the example). You will need to start the game once with the mod enabled to have r2modman generate the config file.

Starting the game the first time with the mod enabled will install a number of files. This may take a few minutes depending on your hardware, and will cause the initial loading screen to take longer than usual.

If the mod was installed successfully, you will see a new logo appear in the main menu.

Please also review the FAQ page for any questions around the mod and installation.

[!IMPORTANT] This mod requires an additional 5GB of disk space.

Installing on Steam Deck

For instructions on how to install this mod on Steam Deck, please follow the instructions in the FAQ.

Uninstallation

To uninstall this mod, simply remove it in r2modman. You can also disable it, which will have the same effect, but leave the mod's files on your device in case you would like to enable it again in the future. When disabled, the game and mod manager will not be influenced by these files, so you can play vanilla and with other profiles without any issues.

(Not recommended) Manual installation

[!WARNING] This approach is not recommended. Use it only if you want to contribute to the mod or get an early version and need to manually build a local copy.

Fork and clone the repository (for contributions), or download a .zip of the latest main branch, using the <> Code button on the main page (for early testing).

You will need the Thunderstore CLI executable, and place the tcli.exe in the root directory of the repository, at the level of the thunderstore.toml file.

Use tcli build from a command line to build the package, it will be placed in the build folder. In r2modman, use Import local mod to add the built package .zip to your profile.