Hades II Randomizer

Hades II Randomizer is a randomizer mod for the game Hades II. It randomizes certain parts of the game everytime you start a new run, requiring you to approach the game in a completely different way compared to the normal game.

Please keep in mind that this mod is in it's early stages, so there might be issues or crashes. Hades II is also in Early Access, so any update may break the mod or cause issues.

IMPORTANT: Please disable the Transmit Data setting in the Hades settings menu! Supergiant Games uses the data for balancing and fine tuning and the randomizer throws all balancing out of the window, making the data useless and noisy for the developers.

What can be randomized?

• Enemies: Enemies, elite enemies and minibosses are randomized. This means that you can encounter an enemy from, for example, the Fields of Mourning in Erebus or even surface enemies in the underworld.
• Boons: Boons/Offerings from gods are randomized. This means that, for example, Poseidon can offer upgrades from Aphrodite or Demeter instead of the usual Poseidon boons. Boons are only randomized at the start of the run, so a god will keep offering the same boons for the whole run, until you start a new run.
• Elemental Traits: The elemental traits (water, fire, etc.) offered by the gods are randomized. This affects the way you should approach infusion boons.
• Keepsake: The keepsake you start with is randomized. This only randomly selects a keepsake that you have unlocked, so you will not start with a keepsake you have not unlocked yet.
• Weapon: The weapon you start with is randomized. This only randomly selects a weapon that you have unlocked, so you will not start with a weapon you have not unlocked yet.
• Weapon Aspect: The aspect of the weapon you start with is randomized. This only randomly selects an aspect that you have unlocked.
• Arcana Cards: Randomly equips or unequips arcana cards at the start of the run according to the chance set in the config. Only changes the cards that you have already unlocked.

Some of these features are disabled by default and can be enabled in the config. See Configuration for more information.

Prerequisites

NOTE: These instructions are NOT for the Thunderstore version of the mod. If you are using the Thunderstore version, you will need to manually install the dependencies or use the fork of the r2modman that can be found here.

Before installing the mod, make sure you have the following installed:

1. The latest version of ModImporter: https://www.nexusmods.com/hades2/mods/1
2. The latest version of ModUtil: https://github.com/SGG-Modding/ModUtil/releases

Earlier versions of ModImport and ModUtil might not support Hades II yet, so make sure you are using a recent version!

Installation

NOTE: The instructions below are for ModImporter (or the Nexusmods version). These instructions are NOT for the Thunderstore version of the mod. It is recommended to use the ThunderStore version of this mod as it's easier to install. If you are using the Thunderstore version, you will need to use the fork of the r2modman that can be found here.

NOTE 2: Once r2modman (not the fork) supports Hades II and Hell2Modding stabilizes/matures, ModImporter will likely no longer be supported!

1. Download the latest release from the releases page
2. Extract the contents of the zip file.
3. In the Content folder of your Hades II installation folder (Usually C:\Program Files (x86)\Steam\steamapps\common\Hades II\Content), create a mods folder if it doesn't exist yet.
4. Copy the HadesIIRandomizer folder from the extracted zip file to the mods folder. You do not need the other files (README, LICENSE), only the HadesIIRandomizer folder.
5. Check the config.lua file in the HadesIIRandomizer folder to see if you want to change any settings.
6. Run ModImporter.
7. Enjoy!

Configuration

NOTE: When using Hell2Modding, the configuration file is located in the ReturnOfModding/config folder of your r2modman data folder under the name Dannyj1-Hades_II_Randomizer.cfg.

The mod comes with a config.lua file that allows you to change certain settings. The following settings are available:

• Enabled: Set to true to enable the mod, set to false to disable the mod. Default: true.
• RandomizeEnemies: Randomizes the enemies as described above. Default: true.
• RandomizeBoonOfferings: Randomizes the boon offerings as described above. Default: true.
• RandomizeElementalTraits: Randomizes the elemental traits as described above. Default: true.
• ScaleStats: Scales enemy and miniboss stats in the earlier areas, so you do not have to spent ages on a single enemy. Default: true.
• RandomizeKeepsake: Randomizes the keepsake you start with. Default: false.
• RandomizeWeapon: Randomizes the weapon and the weapon's aspect you start with. Default: false.
• RandomizeArcanaCards: Randomly equips or unequips arcana cards at the start of the run according to the chance set in the config. Default: false.
• ArcanaCardEquipChance: The chance that an arcana card is equipped at the start of the run. Should be between 1 and 100. Default: 50.

Limitations

Some of these limitations may be solved in the future, but I am currently unable to do so.

• The pre-placed satyrs in Chronos' room can not be randomized. I am unable to find a way to do so. Unless someone else knows how to do this, this won't be randomizable.
• The first run in a fresh file is not randomized. I could not get this working without causing crashes.
• Loading a run from a save file (so not starting a new run from the hub) after restarting the game is not randomized. You will have to give up and restart your run.

Known Issues

None at the moment.

Roadmap

• Randomize rooms
• Randomize enabled testaments/nightmare level
• Randomize music
• See what else can be randomized
• Add a UI in which settings can be changed in-game, without restarts. This will probably only happen once a UI library gets released.

I found a bug or my game crashed, what do I do?

Please create an issue (click here) with the following details:

• A detailed and clear description of what you were doing and what exactly happened.
• Any steps to reproduce the bug/crash, if possible.
• (Optional, but very helpful) A video showing the bug, if possible.
• The Hades II.log file located at C:\Users\<Your Username>\Saved Games\Hades II (I am unsure of the location on other operating systems)

License

Copyright 2024 Danny Jelsma

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.