BoonStacker

BoonStacker is a Hades II mod that fundamentally changes the boon system by allowing you to stack boons on your core slots (Attack, Special, Cast, Sprint, Magick) instead of replacing them.

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

For players seeking a more "earned" progression, this mod is integrated into the game's incantation system. You can disable EasyUnlock in the config file to require endgame materials, treating it as a powerful mid-to-late game upgrade rather than a default capability.

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.

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.

How to Use

Installing the mod does not enable its effects immediately. You must unlock it within the game at the Crossroads Cauldron.

1. Superposition of Divine Favor: Perform this incantation to enable Boon Stacking.
   • Cost (Default): 1 Moly
2. Separation of Divine Favor: If you wish to disable the mod's effects and return to standard rules, perform this incantation. It will refund the materials used for the unlock.

Configuration

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

• EasyUnlock (Default: true)
  • True: The incantation costs 1 Moly. Useful for immediate access or testing.
  • False: The incantation costs 1 Zodiac Sand and 1 Void Lens. This setting is intended for a balanced playthrough where this ability is treated as a significant mid-game upgrade that must be earned.
• StackPenaltyScalar (Default: 1.0)
  • Adjusts the probability penalty for finding stacked boons. Higher values make it harder to find 3rd/4th stacks for the same slot. Set it to 0.0 for no penalization.

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).