BoonStacker

BoonStacker transforms the boon system in Hades II, unlocking the ability to stack boons on your core slots (Attack, Special, Cast, Sprint, Magick) rather than being forced to replace them.

Ever found a perfect boon but didn't want to sacrifice the one you already had? With BoonStacker, you don't have to choose. Combine the might of multiple Olympians on a single move to create devastating synergies and unique builds that simply weren't possible before.

This mod is integrated into the game's incantation system and allows for steady progression by gathering materials and performing incantations at the Crossroads Cauldron. Alternatively, set SkipIncantations to true in the config to unlock everything immediately.

Disclaimer: This mod significantly alters the game's balance. Stacking multiple gods' effects on a single move can lead to extremely powerful combinations.

Features

• Boon Stacking: You can now accept new boons for your Attack, Special, Cast, Sprint, and Magick slots even if they are already filled. The new boon will be added alongside the existing one.
• No Replacements: "Swap" or "Replace" offers are disabled for these slots. You will simply add to your arsenal.
• Probability Balancing: To keep things somewhat grounded, the probability of finding a boon for a specific slot decreases slightly as you stack more boons into that slot.

How to Use

By default, the mod uses a progression system unlocked through incantations at the Crossroads Cauldron.

Want immediate access? Set SkipIncantations to true in the configuration to bypass all incantations and enable full mod functionality (all slots, unlimited stacking) from the start.

Slot Unlocks

Each slot can be unlocked independently using boss materials:

• Superposition of Essence (Magick) – 1 Cinder
• Superposition of Momentum (Sprint) – 1 Pearl
• Superposition of Binding (Cast) – 1 Wool
• Superposition of Finesse (Special) – 1 Tears
• Superposition of Ferocity (Attack) – 1 Golden Apple

Incantations appear once you've discovered the required material.

Stack Limits

By default, each unlocked slot allows 2 stacked boons. You can increase this:

• Rite of Triple Capacity (2→3) – 1 Eagle's Feather
• Rite of Quadruple Capacity (3→4) – 1 Zodiac Sand
• Rite of Infinite Capacity (unlimited) – 1 Void Lens

Configuration

You can adjust the mod's behavior by editing config.lua (if manually installed) or using the Config Editor in r2modman.

• SkipIncantations (Default: false)
  • True: Full mod functionality is active immediately—all slots unlocked, unlimited stacking. No incantations appear.
  • False: Use the progression system via incantations (recommended for balanced play).
• StackPenaltyScalar (Default: 1.0)
  • Adjusts the probability penalty for finding stacked boons. Higher values make it harder to find 3rd/4th stacks. Set to 0.0 to disable.

Installation

Recommended: Mod Manager

The easiest way to install is using a mod manager like r2modman or the Thunderstore Mod Manager.

Manual Install

If you prefer to install manually, ensure you have the following dependencies installed in your Hades II/Content/Mods directory (or equivalent):

1. Hell2Modding
2. LuaENVY
3. Chalk
4. ReLoad
5. SJSON
6. ModUtil
7. IncantationsAPI

Then, extract the BoonStacker folder into your Mods directory.

Feedback

Please submit bug reports and feature requests via the GitHub Issue Tracker.

License

MIT

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.5.1 - 2026-02-17

Fixed

• Fixed StackPenaltyScalar having no effect on boon offer probability.
• Fixed Supplemental Hymn level bonus only applying cosmetically (now grants full stat boosts via trait reprocessing).
• Fixed StackPenaltyScalar of 0 causing a divide-by-zero error.
• Fixed empty boon pool crash when probabilistic filter removes all options.
• Fixed vanilla boon replacement being blocked for non-unlocked slots.
• Fixed stale OriginalSlot on trait data preventing re-enable after disable.

Changed

• Verbose logging is now gated behind a Debug config option (default: off).

Improved

• Removed redundant weight recalculation in GetEligibleUpgrades.
• Removed dead code branch in TraitUIRemove.
• Deduplicated incantation requirement builders.

0.5.0 - 2025-12-10

• New Feature: Progression System
  • Replaced all-or-nothing unlock with individual slot unlocks.
  • Five slot-specific incantations: Magick, Sprint, Cast, Special, Attack.
  • Each requires different boss materials (Cinder, Pearl, Wool, Tears, Golden Apple).
  • Incantations are hidden until you discover the required materials.
• New Feature: Stack Limit Upgrades
  • "Rite of Triple Capacity" (2→3 stacks) – requires Eagle's Feather.
  • "Rite of Quadruple Capacity" (3→4 stacks) – requires Zodiac Sand.
  • "Rite of Infinite Capacity" (unlimited) – requires Void Lens.
• Backwards Compatibility: Existing saves with the old BoonStacker_Unlock retain full functionality.
• Improvements:
  • Renamed incantations with thematic names ("Superposition of...", "Rite of...").
  • Improved flavor text for all incantations.
  • Fixed incorrect voicelines in incantations.
• Configuration:
  • Deprecated EasyUnlock option (no longer used with new progression system).

0.4.1 - 2025-12-05

• Configuration:
  • Added option to turn on/off prioritization for certain boon types.
• Fixes & Improvements:
  • Corrected system for calculating "stacked" boon probabilities.
  • Corrected issue where all boons were being prioritized on run start.

0.4.0 - 2025-12-05

• New Feature: Supplemental Hymn
  • Repurposed "Sacrificial Hymn" (LimitedSwapTraitDrop) to "Supplemental Hymn".
  • Prioritizes offering boons for slots that are already occupied (stacking).
  • Grants a level bonus (default +2) to stacked boons acquired this way.
  • Updated in-game text and descriptions via SJSON hooks.
• Fixes & Improvements:
  • Refactored GetReplacementTraits to support stacking logic.
  • Improved trait selection and bonus application stability.

0.3.0 - 2025-12-03

• Configuration:
  • Added SkipIncantations option (Default: false). When enabled, the mod is active immediately and incantations are removed from the game.
  • Allowed for descriptions to appear when adjusting config in mod manager.
• Documentation:
  • Improved introduction text in README.

0.2.2 - 2025-12-03

• Attempt 2 at previous patch

0.2.1 - 2025-12-03

• Bug Fixes:
  • StackOnly upgrades (e.g., Pom of Power) are no longer subject to the stack penalty probability reduction.
• Documentation:
  • Added Feedback section to README pointing to the GitHub Issue Tracker.

0.2.0 - 2025-12-01

• UI:
  • "Stacked" boons now appear in the boon menu list.
• Bug Fixes:
  • Fixed a bug where stacked boons' images were causing crashes.

0.1.1 - 2025-12-01

• Initial release.
• Core Logic:
  • Implemented logic to bypass occupied slot checks (GetPriorityTraits).
  • Disabled boon replacement logic (GetReplacementTraits).
  • Overrode slot status checks (HeroSlotFilled).
• Incantation System:
  • Added "Superposition of Divine Favor" incantation to unlock the boon stacking capability.
  • Added "Separation of Divine Favor" incantation to disable the mod and refund resources.
• Balancing:
  • Implemented probability reduction for finding boons for slots that are already occupied (configurable).
• Configuration:
  • Added config.lua with options for EasyUnlock (recipe cost) and StackPenaltyScalar (probability balancing).