Hades 2 Utility and Bugfix Modpack

This mod provides an in-game ImGui menu to configure targeted gameplay adjustments, starting hammer selection, and various bug fixes. All features can be toggled individually. Inspired by Hades 1 Speedrunning Modpack.

Design philosophy is keep the game vanilla but remove some frustrating design choices.

How to Use

Open the mod menu from the Modpack entry in the ImGui menu bar and click Toggle Mod Menu.

Mod Marker

When the mod is enabled, a config hash is displayed on the HUD. This hash encodes your current settings so runs can be verified at a glance. The marker automatically updates when settings change and disappears when the mod is disabled.

Master Toggle

The Enable Mod checkbox at the top enables or disables the entire modpack. Disabling it automatically reverts all game data mutations — no restart needed.

Tabs

1. Quick Setup — Pick a preset to configure the modpack in one click:

   • AnyFear — RTA disabled, Arachne pity disabled. For anyfear routing.
   • HighFear — RTA disabled, Arachne spawn forced. For highfear routing.
   • RTA — RTA enabled, all-weapons routing.
   • The dropdown auto-detects your current settings. If you manually tweak individual options it shows Custom.
   • Also includes quick toggles for all bug fixes (Enable All / Disable All) and a hammer selector for your currently equipped aspect.

2. Hammers — Select a guaranteed first hammer for each weapon aspect. Organized by weapon, with collapsible sections per aspect. If the selected hammer is ineligible due to weapon aspects or other conditions, the game defaults to vanilla random selection.

3. Run Modifiers — Toggle individual gameplay adjustments (see below). Settings grouped under collapsible headers.

4. Bug Fixes — Toggle individual bug fixes (see below). Each fix can be enabled or disabled independently.

5. QoL Settings — Quality-of-life options for cutscenes, dialogue, and spawn behaviour (see below) - Credit to PonyWarrior for their PonyQoL2 mod.

Applying Changes

Most settings require clicking the Apply Changes button (pinned to the bottom of the window) to take effect. The UI shows a warning when you have unapplied changes. Toggling a setting back to its applied state clears the warning automatically.

Live settings like RTA Mode, Skip Gem Boss Reward, Incrementing Fig Leaf, Suffering Fix, Auto Skip Dialogue, and Skip End Run Cutscene take effect immediately without needing Apply.

Run Modifiers

NPCs & Routing

• Force Medea Spawn: Forces Medea to spawn to reduce death resetting for pity.
• Force Arachne Spawn: Forces Arachne to spawn to reduce death resetting for pity.
• Disable Arachne Pity: Disables Arachne pity completely for Anyfear runs.
• Prevent Echo Scam: Blocks both minibosses from spawning at room 3 in the Fields, ensuring Echo always appears.
• Disable Selene Before First Boon: Prevents Selene's Gift from spawning until the player has acquired at least one core Olympian boon or a hammer.

World & Combat Tweaks

• RTA Mode: Disables all combat pausing encounters for RTA runs.
• Skip Gem Boss Reward: Bosses no longer drop gem rewards when using Grave Thirst.
• Incrementing Fig Leaf: Dionysus skip chance starts at the default value (37%) and increases by 13% after every encounter, resetting at the start of each biome.
• Less Sucky Surface: Three adjustments:
  1. Thessaly minibosses forced between rooms 2–4 (consistent with other biomes).
  2. Olympus mid-shop forced between rooms 5–7 (consistent with Oceanus mid-shop).
  3. Hercules cannot spawn on Thessaly anymore.
• Charybdis Behavior Adjustment: Tentacles despawn in 1 second instead of 9 seconds at phase transition. Spit attacks reduced from 8 to 6.

Bug Fixes

Weapons & Attacks

• Aspect of Selene Fix: Correctly registers the Hex upon run start for immediate Path of Stars eligibility. Sky Fall always at full Moonglow.
• Extra Dose Fix: Extra Dose now works with Coat second punch and dash strike.
• Staged Omega Fix: Adjusts minimum weapon charge time for Axe Omega Attack and Blade Omega Special to benefit from channeling bonuses.
• Tidal Ring Fix: Removes immunity duration on Poseidon Cast Splash, allowing multiple hits with Circe staff.

Boons & Hammers

• Poseidon Waves Fix: Poseidon wave effects correctly trigger on Axe special and Hidden Helix Torch.
• Shimmering Moonshot Fix: Applies intended damage bonus to Omega Special projectiles.
• Second Stage Channeling Fix: Removes secondary channeling for Glorious Disaster and Giga Moonburst, baking mana cost and damage bonuses into the primary stage. Glorious Disaster now works similar to other OCast expiring boons.
• Omega Cast Effects Fix: Omega Cast moves (Prominence Flare, Glorious Disaster, Meat Grinder) correctly classified as Cast damage.
• Cardio Torch Fix: Cardio gain works properly on all Torch specials (triggers multiple times on non-hidden aspect Torches and properly on Supay).
• Braid of Atlas Fix: Braid cast damage modifier correctly applies to all cast projectiles.
• ET Fixes: Fixes ET compatibility with Anubis Omega Attack by generating a closer field. Also fixes Anubis OAtk field distance based on casting angle.

NPC & Encounters

• Corrosion Fix: Prevents Corrosion on Sight from aggroing enemies on Thessaly boats.
• Suffering on Sight Fix: Suffering on Sight damage now bypasses wards (consistent with Corrosion on Sight).
• GGG Echo Fix: Allows GGG to be offered in Jpom runs.
• Miniboss Encounter Fix: All mini bosses with top screen health bars (Boar, Charybdis, Talos, Typhon Eye/Arm) correctly count toward room encounter depth.
• Familiar Spawn Delay Fix: Familiars spawn immediately upon entering a room.

QoL Settings

• Always Show Location Counter: Permanently displays the room depth counter on the HUD.
• Auto Skip Dialogue: Automatically skips dialogue prompts during gameplay.
• Skip End Run Cutscene: Skips the end-of-run cutscene.
• Skip Death Cutscene: Skips the death cutscene.
• Spawn in Training Grounds: Spawns you in the Training Grounds after death instead of the usual respawn area.

Changelog

Unreleased

1.2.1 - 2026-03-12

Changed

• Updated readme/tooltips for better readability and more through explanations

1.2.0 - 2026-03-12

Changed

• Profile system overhaul — Replaced the old hardcoded preset system (AnyFear/HighFear/RTA defined in code) with a fully user-driven profile manager. Users can now save, load, name, and share their own configurations without editing any files.
• Draft/commit model — All setting changes are now staged as a draft. Nothing takes effect until the user clicks Apply Changes. A Discard button reverts to the last applied state. This replaces the old behavior where some settings applied immediately and others required Apply.
• Config hash now includes hammer selections — The hash encoding has been extended to capture both boolean settings and first hammer choices. The HUD marker continues to show only the short boolean hash for readability.

Added

• Profiles tab — New dedicated tab for profile management:
  • Export/Import with Copy and Paste buttons for fully mouse-driven workflow
  • 10 saveable profile slots with custom names and tooltips
  • Restore Default Profiles button to reset slots to shipped defaults
  • "Exclude Hammers" checkbox on Copy to share toggle-only codes
• Quick Setup tab — Dropdown lists only populated profiles. Select and click Load to apply a saved profile in one click.
• Two-tone hash display — Export view shows boolean settings in green and hammer payload in gray, making it clear which part of the code is which.
• Mod marker now appears on game load (previously only showed after first Apply).

Removed

• Hardcoded preset definitions — replaced by user-managed profiles.
• Auto-detection of "Custom" preset state — replaced by simple hash comparison.
• Per-setting live apply behavior — all settings now go through the draft/commit flow.

1.1.0 - 2026-03-11

Added

• QoL option to allow KBM players to pause the game during boon/pom/hex selection menu, PoS menus, and during death sequences.

1.0.13 - 2026-03-10

Added

• Several QoL options, including: Death Cutscene skip, Spawn in Training Grounds directly, Auto Skip Dialogue.
• Credit to PonyWarrior for their PonyQoL2 mod.

Fixed

• Mod Marker implementation significantly improved and made independent of other game systems. now toggles when the mod is enabled/disabled
• Mod now fully applies its config when enabled and revert all changes when disabled.

1.0.12 - 2026-03-09

Fixed

• Implemented the Familiar Delay Fix in a less aggressive way to prevent a case where Raki attacked Chronos adds before the fight even started.
• Fixed an issue causing Location string to render offscreen from the Modded mark

1.0.11 - 2026-03-08

Added

• Modded Stamp to screen while running the mod to clarify that the run is modded as well as a hash code showing mod config
• Mod UI Theme
• Added an option to make Fig Leaf increment based on biome depth instead of a fixed percentage
• Added an option to disable gem drops from bosses when using Grave Thirst

Fixed

• Fixed a bug where passing a hammer room disabled the first hammer forcing
• Preset dropdown fix
• Preset description more clarified

1.0.10 - 2026-03-07

Added

• Improved UI handling
• Performance Optimization
• Code restructing for expandability

1.0.9 - 2026-03-06

Added

• Hammer selection now per aspect not just per weapon
• Overhaul of the UI for better UX
• Adding Backup/Restore system allowing changing configuration without returning to main men (BETA)

Fixed

• Tightened the hammer selection logic to ensure it is only reset when the player actually receives the hammer.

1.0.8 - 2026-03-06

Added

• Glorious Disaster now working with Aspect of Charon

Fixed

• Encounter banning for RTA and Surface fixes

1.0.7 - 2026-03-05

• Fixing RTA Mode missing two encounter sets

1.0.6 - 2026-03-05

• Removed Field Mid shop chance. Now Echo is 100%
• Adding RTA support by disabling all combat pausing encounters

1.0.5 - 2026-03-05

• Changing Echo chance to 0.75 instead of 50/50 with the shop
• Remove Arachne pity changes because some people use it and some people don't so no need to change it

1.0.4 - 2026-03-04

• Adding Familiar delay fix
• Adding Suffering on Sight Fix
• General Surface adjustments

1.0.2 - 2026-03-03

• Adding echo scam fix (experimental)
• Fix Charybdis behavior adjustment caused mod to crash

1.0.1 - 2026-03-03

• remove experimental code that made it to release

1.0.0 - 2026-03-03

• Initial release