-
-
Notifications
You must be signed in to change notification settings - Fork 2
Installation & Uninstallation
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.
Caution
To be able to use the mod, Hades must be installed at ALL TIMES.
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 modded Hades, please remove any mods before installing and when playing Hades II with this mod 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.
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.
That's it - when you next start the game, the mod will copy any required files from your Hades installation into your Hades II installation.
This installation may take a while depending on your hardware, and you will see a black screen during the process.
Windows may tell you the application is unresponsive - select Wait for it to respond and give it some time.
You can follow along the installation progress in the console window that opens when playing the game modded.
If the mod was installed successfully, a popup will open in the Training Grounds to let you know.
Please also review the FAQ page for any questions around the mod and installation.
Note
Some of the files required by the mod will stay in the installation folder and be read by the game even if you switch r2modman profiles, disable the mod or play vanilla.
This is not expected to cause any issues, as the data within the affected files can be read even without the mod's code being present.
If you want to make a clean switch, use the uninstall option in the mod config to remove the files from your game folder.
Important
This mod requires at least 1GB of additional disk space.
For how to install this mod on Steam Deck, please follow the instructions in the FAQ.
Before removing the mod from r2modman, you should set the uninstall option in the mod config to true and start the game once.
This will remove any files that were copied from the Hades game folder to your Hades II installation.
If you remove the mod before uninstalling, these loose files will remain in the Hades II folder indefinitely, and may cause issues further down the line.
If you ever have any issues with the mod, set both the uninstall and firstTimeSetup options to true and start the game once.
This will first uninstall, and then install the mod again.
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.