This is the README from the GitHub repository. For the full source code, please visit the project on GitHub.

About this project

This is my second mod for the game Hades. This one is a little more involved than the first one though. In Hades, the player can get certain upgrades 'Boons' that enhance their abilities. Throughout the game the player can also find 'Poms of Power'; pomegrenates that can upgrade these boons to a higher level to make them even more effective.

However, for some reason that never became quite clear to me while playing, some boons are excluded from this upgrade system. So, this mod addresses that, making a lot more of them available.

Technical details

To make more boons upgradable, I had to override the boons default configs. This took some time to figure out, but after some digging I found that in order to make a boon upgradable, the RequiresFalseTrait option had to be set to true.

First, we need to override the function that is called when the pom menu opens, to make sure that we grab all the boons that we want.

Lua
ModUtil.BaseOverride ( "GetAllUpgradeableGodTraits", function ( )
    local traitNames = {}
    for _, trait in pairs ( CurrentRun.Hero.Traits ) do
        if trait.RemainingUses == nil and IsGodTrait( trait.Name ) or string.find(trait.Name, "ChaosBlessing") then
            traitNames[trait.Name] = true
        end
    end
    return traitNames
end, MorePomOptions )

Next, we override the RequiredFalseTrait attribute of the boons:

Lua
function OverrideTraits ( )
    ModUtil.MapNilTable( TraitData,
    {
        RoomRewardBonusTrait = { RequiredFalseTraits = true },
        HealthRewardBonusTrait = { RequiredFalseTraits = true },
        AphroditePotencyTrait = { RequiredFalseTrait = true },
        ...
    } )

Finally, inside this function we then also have to set the modifiers for how much the boons should be upgraded at each level, as these values don't exist by default. It took a little bit of fine tuning and a lot of testing to get this to relatively balanced levels:

Lua
    ModUtil.MapSetTable( TraitData,
    {
        ChaosBlessingMetapointTrait =
        {
            MetaPointMultiplier =
            {
                IndenticalMultiplier =
                {
                    Value = -0.6
                }
            }
        }
        ...
    } )