You are viewing a potentially older version of this package. View all versions.
SMarBe-Improved_Boon_Info_UI-1.1.0 icon

Improved Boon Info UI

Improves the boon requirement UI by adding clear colors that show which boons are already picked, available, or unavailable due to requirements.

Date uploaded 6 months ago
Version 1.1.0
Download link SMarBe-Improved_Boon_Info_UI-1.1.0.zip
Downloads 116
Dependency string SMarBe-Improved_Boon_Info_UI-1.1.0

This mod requires the following mods to function

Hell2Modding-Hell2Modding-1.0.87 icon
Hell2Modding-Hell2Modding

Lua Mod Loader for Hades 2

Preferred version: 1.0.87
LuaENVY-ENVY-1.2.0 icon
LuaENVY-ENVY

A plugin to allow ReturnOfModding plugins greater control of their environment.

Preferred version: 1.2.0
SGG_Modding-Chalk-2.1.1 icon
SGG_Modding-Chalk

System for handling config files in ReturnOfModding

Preferred version: 2.1.1
SGG_Modding-ReLoad-1.0.2 icon
SGG_Modding-ReLoad

Provides helpers for managing hot reloading and waiting for the right time to load

Preferred version: 1.0.2
SGG_Modding-SJSON-1.0.0 icon
SGG_Modding-SJSON

A plugin for handling .sjson files in ReturnOfModding.

Preferred version: 1.0.0
SGG_Modding-ModUtil-4.0.1 icon
SGG_Modding-ModUtil

Utility mod for mod interactions within lua for SGG's games

Preferred version: 4.0.1

README

Improved Boon Info UI – Hades II Mod

This mod refines how boon information is displayed for all Olympian boon givers page during a run.

Explicit boon categories

Boons are split into categories based on their current availability.

For boons without requirements:

  • Picked: currently owned,
  • Available: any boon that could appear in your next offering,
  • Sacrifice: any available boon that take an occupied slot,
  • Unavailable – Keepsake Required: requires forcing an out-of-pool god using a keepsake,
  • Denied: any boons not picked when playing with Vow of Denial.

For boons with requirements:

  • Unfulfilled: boon requirements are still fulfillable but are not yet fulfilled,
  • Unavailable – Keepsake Required: any duo boon with one of the god out of the pool,
  • Denied: when all required boons for a given category are banned, those boons are thus implicitly banned as well.

This approach makes it immediately obvious:

  • Which boons you already have,
  • Which ones you can pick up next,
  • Which ones are locked behind sacrifice,
  • Which ones require forcing a god with a keepsake,
  • Which ones you have no chance of seeing.

It avoids guesswork and reduces UI ambiguity without touching gameplay logic.

Boon button

Boon picked Boon sacrifice Boon unfulfilled Boon unavailable

Boon buttons have been changed in Codex pages to give more information on their current availability state:

  • picked: title is colored in light green, the same color as when a requirement is fulfilled,
  • available: unchanged, uses classic rarity color,
  • sacrifice: title is colored in dark red and the current boon using the slot is shown in a similar way as if it appeared in an offering,
  • unfulfilled: same color as available boons but with half transparency (see screenshot above),
  • unavailable: title is colored in dark blue as long as the god pool is full and that the god is out of it,
  • denied: the full banned is still using the same style with chains, only difference is the title has the same behaviour than unfulfilled ones.

Requirements listing

Default Modded
Requirements default - sacrifice Requirements modded - sacrifice
Requirements default - keepsake Requirements modded - keepsake
Requirements default - vow of denial Requirements modded - vow of denial

Default

When looking at requirements for a given boon, the only information we get is:

  • a boon in the requirements is picked: boon name colored in white instead of grey,
  • a requirement is fulfilled: heading colored in light green instead of white.

Modded

Requirements

Headings coloring is now changed as well, based on the availability of the required boons:

  • light green: same as before, a required boon is picked,
  • white: same as before, except now it ensures that at least one boon is available,
  • dark blue: no available boon and at least one requires adding a new god to the maxed out pool,
  • dark red: all boons require a sacrifice,
  • black: all boons are banned (vow of denial).

Boons inside listing follow the same coloring scheme as default for available and picked ones. Then for the others, the coloring applies the same logic as above. Unfulfilled boons also have even more transparency than unpicked ones.

Page filtering

For even more granularity on the displayed information, extra controls (LB/RB, left/right arrows) have been added to the offering pages allowing to filter boons displayed based on their current category.

Filter buttons

Filter available

Current filter pages are the following in this order:

  • AVAILABLE: only show available and sacrifice boons,
  • UNFULFILLED: adds unfulfilled requirements boons,
  • UNAVAILABLE: adds boons from gods out of current pool,
  • ALL: adds picked and banned boons.

Highly suggested: Run Boon Overview

Run Boon Overview aggregates all boons from the current god pool into Melinoe's Codex page. This makes the information given from this even clearer.

Planned updates

  • Add the possibility to choose the coloring to apply to categories
  • Perhaps a fifth category (both requiring keepsake AND sacrifice)

Compatibility

  • Should be safe with all mods as long as they don't interact with Boon info listing.
  • It lightweight and doesn't touch to any game components so your save files are safe.

Issues and Feedback

Feel free to contact me on the official Hades modding Discord and/or add an issue on the repository for any encountered bugs or suggested improvements.

CHANGELOG

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

1.4.0 - 2026-01-25

Added

  • Default filter landing page configuration option as suggested by @surytrap

1.3.1 - 2026-01-17

Fixed

  • Situation when only one slot was available for 2 unfulfilled requirements was uncorrectly identifying it as unfulfilled instead of unavailable. Special thanks to Kanamahk for reporting this.
  • Filtering page would sometimes give an invalid page that made it impossible to scroll and forced users to change filter, scroll then reapply filter. Changing filter now tries to stay selected on the previous boon if possible.

1.3.0 - 2026-01-12

Added

  • Configuration parameters for the coloring and overall style of boon info availability states

Changed

  • Set sacrifice boons as banned if the current boon rarity for the slot is Heroic as it can't ever be offered unless sold.
  • God discovery is better, any newly added god should be compatible by default
  • Fallback filter to unavailable if applying filter would result in an empty page.
  • Changed the previous filter button behaviour to hide and disable if it would result in an empty page.

Fixed

  • Sacrifice boons now display their current rarity icon in boon info page.

1.2.0 - 2025-12-30

Added

  • Banned boons are now prefixed with a lock icon in requirement lists.
  • Tracked/pinned boons are now prefixed with a pin icon in the requirements lists
  • The icons above can be separately disabled in configuration. Both defaults to enabled.

Fixed

  • Small issue with default filter wrongly applied when out of a run

1.1.0 - 2025-12-29

Added

  • Configuration parameter for default availability logic of sacrifice boons

Changed

  • Default availability logic for sacrifice boons is now always unavailable
  • Improved duo boon unavailability logic to trigger only when both gods wouldn't fit into god pool

Fixed

  • Out of pool gods now correctly displayed as in-pool when currently being offered
  • Issue with some unavailable duo boons that were wrongly displayed as unfulfilled

1.0.1 - 2025-12-17

Fixed

  • Used bad image extensions for readme

1.0.0 - 2025-12-17

Added

  • Unfulfilled nuanced states for more granularity
  • Filtering behaviour on Boon offering pages for Olympian gods

Changed

  • Gave more "availability" weight to god unavailable relative to sacrifice boons as those are theoretically always available

Fixed

  • Bug with requirement heading displayed in white even when fulfilled
  • Gods sometimes were shown as unavailable when a run was not ongoing
  • 4th god picked during a run would show his/her offerings as unavailable
  • God unavailable behaviour will be more consistent with duo boons

Removed

  • Public API access as the mod should work in all situations since it directly relies on game data

0.3.0 - 2025-12-10

Added

  • Unfulfilled boon category to further improve clarity to better differentiate which boons are available to those that still need a requirement.
  • Color transparency for Denied boons, should look much better now in the codex.

Changed

  • Game namespace to game specific calls for an improved readability.

0.2.1 - 2025-12-09

Added

  • Public definitions for consumption

Fixed

  • Crash when scrolling down Chaos boon offerings.

0.2.0 - 2025-12-08

Added

  • Boons banned from vow of denial follow the same logic as other boons applied to requirements.
  • Boon state getter added to public space for to get consumed as dependency.

0.1.0 - 2025-12-08

Added

  • First version of the mod!