ThreeChoiceChests

By Riiin.

ThreeChoiceChests changes supported Risk of Rain 2 containers so that opening them presents three choices instead of immediately dropping a single reward.

What it changes

Supported interactables:

• Small Chest
• Invisible Chest
• Large Chest
• Legendary Chest
• Damage Chest
• Healing Chest
• Utility Chest
• Large Damage Chest
• Large Healing Chest
• Large Utility Chest
• Equipment Barrel

The mod preserves the chest's original reward tier. Category chests keep their original Damage / Healing / Utility restriction, and Equipment Barrels choose from equipment.

The chest's original rolled reward remains one of the three candidates, with the other candidates drawn from the appropriate current-run pool.

If several supported chests are opened before earlier choices are finished, their rewards are queued and the choice screens are shown one at a time instead of losing rewards or overlapping prompts.

Candidate short descriptions (1.2.0)

• In Simplified Chinese (zh-CN), ThreeChoice tooltips use 217 hand-authored short descriptions, with reviewed on-hit / on-kill labels and consistent mechanic colors.
• Candidate names still use the game's current localization.
• The private catalog does not replace global pickup, description, name or lore tokens. Ordinary pickup notifications and the Logbook are unaffected.
• Other languages and unknown or modded candidates use their current localized pickup descriptions.
• Works with or without the independent Chinese Retranslation mod. Installing both lets candidate names follow that mod while these choice descriptions remain private to ThreeChoiceChests.

Scoreboard support

• Scoreboard / inventory can be opened normally while a three-choice reward is pending.
• Opening the scoreboard temporarily hides the choice UI without consuming or rerolling the reward.
• The hidden choice panel does not receive input while the scoreboard is open.
• Closing the scoreboard restores the exact same picker and candidates.
• A choice is finalized only after a valid candidate is selected.
• Escape / pause-menu interruption recovery remains supported.

The Command Artifact information card is suppressed only for ThreeChoiceChests' internal Command picker. Normal Artifact of Command behavior is preserved.

Intentionally unchanged

These special containers keep their vanilla behavior:

• Lunar Pods
• Void Cradles
• Free Chests
• Command Chests
• Adaptive Chests

Installation

Install with r2modman / Thunderstore Mod Manager.

For manual installation, place ThreeChoiceChests.dll in a folder under BepInEx/plugins/.

Compatibility

Single-player is the primary target. Multiplayer behavior has not yet been fully validated.

ThreeChoiceChests detects UniversalPause and leaves single-player pause to it; without that plugin, it uses its built-in single-player pause fallback. Multiplayer keeps per-player selection protection and the existing exit grace period.

The 1.2.0 text update passed catalog, rich-text, localization fallback and protected-code checks. Tooltip colors, clipping and in-game language / translation-mod combinations still benefit from visual confirmation in-game.

Requirements

• BepInExPack
• HookGenPatcher
• R2API.Networking
• R2API.Prefab

Changelog

1.3.2

• Publish the existing generic Choice Extension API v1 for independent companion mods.
• Expose stable reward identities, copied candidate data and queue/bind/success/cancellation notifications.
• Allow optional per-candidate tooltip text without replacing the native choice workflow.
• Preserve the existing reward ownership, native granting, shared queue, Sale Star behavior, Tab/pause recovery and short descriptions.
• Remain standalone: no AD/AP calculations, growth storage or companion-mod dependency.
• Advance the tested local API build's version metadata; no new gameplay changes in this packaging revision.

1.3.1

• Corrected native tooltip availability configuration on ThreeChoice candidate buttons.
• Bound localized candidate names and the existing short effect descriptions before the initial hover event.
• Restored the working tooltip provider setup before applying optional native inventory colors.
• Isolated native title-color lookup with a logged fallback to the working color if lookup fails or returns an invisible/invalid color.
• Kept the shared native tooltip appearance and native item/equipment title-color sources without introducing a custom palette.
• Kept the built-in Simplified Chinese descriptions and localization fallback for other languages and modded items.
• Added tooltip cleanup and restoration when hiding, reopening or switching between choice panels.
• Kept the existing multiplayer queue, Sale Star capture, picker distance handling and reward behavior unchanged.

1.3.0

• Added complete native reward-batch capture for supported chests, including Sale Star bonuses.
• Each actual reward enters ThreeChoice as an independent choice instead of bypassing the picker and dropping directly.
• Each reward preserves its own vanilla rolled pickup, tier and category context.
• Legendary chests use the same complete-batch capture path, including each native rolled red reward.
• Added the successful native purchase's activator as a fallback for delayed reward ownership.
• Removed distance-based dismissal for ThreeChoiceChests-owned pickers, so high-mobility players can move away after opening a chest without the choice UI repeatedly closing.
• Preserved the existing global serial multiplayer queue, owner validation, direct grants, scoreboard recovery and pause/protection behavior.
• Preserved all 217 Simplified Chinese short descriptions and rich-text colors.
• No AD/AP functionality is included.

1.2.2

• Removed the accidentally bundled AD/AP candidate attribute system from standalone ThreeChoiceChests.
• ThreeChoiceChests now only handles three-choice rewards, candidate descriptions, queueing, picker recovery, pause/protection, and its normal UI behavior.
• Candidate tooltips no longer generate, display, store, or synchronize AD/AP attributes.
• Preserved the 217-entry Simplified Chinese short-description catalog and reviewed rich-text colors.
• No changes to chest reward tiers, category restrictions, or special-container exclusions.

1.2.1

• Corrected the public package description after the 1.2.0 upload.
• No intended gameplay changes.

1.2.0

• Added dedicated hand-authored Simplified Chinese short descriptions for ThreeChoice candidates.
• Added reviewed rich-text coloring and on-hit / on-kill labels where applicable.
• Kept candidate names localized through the game's active language tokens.
• Preserved the existing queue, scoreboard recovery, pause/protection, and picker behavior.
• Non-Chinese languages continue to use their original pickup descriptions.

1.0.2

• Reworked scoreboard handling during an active three-choice reward.
• The scoreboard/inventory can be opened normally while choosing.
• Opening the scoreboard temporarily hides the choice panel instead of cancelling or consuming the reward.
• Closing the scoreboard restores the exact same picker and candidates without rerolling.
• Prevented the hidden choice panel from receiving input while the scoreboard is open.
• Fixed the Command Artifact information panel appearing in the scoreboard when ThreeChoiceChests uses its internal picker.
• Preserved normal Artifact of Command behavior.
• Retained the existing pause-menu recovery and reward queue behavior.

1.0.1

• Fixed unresolved chest rewards being consumed when the scoreboard dismisses the choice UI.
• UI dismissal no longer completes the choice or advances the reward queue.
• Preserve the original picker and candidates; restore an interrupted prompt after the pause menu closes, without rerolling.
• Finalize the reward only after the game accepts a valid candidate selection.

1.0.0

• Initial release.
• Added three-choice rewards for supported standard, category, and legendary chests.
• Added three-choice rewards for Equipment Barrels.
• Preserved original item tier and category restrictions.
• Added a reward queue for rapidly opened supported chests.
• Left Lunar Pods, Void Cradles, Free Chests, Command Chests, and Adaptive Chests unchanged.