ThreeChoiceChests

By Riiin.

Opening a supported chest now gives you three choices instead of immediately dropping one random reward.

The original rolled reward is always kept as one of the three options, while the other two are drawn from the same valid reward pool. Chest tier and category restrictions are preserved.

Supported containers

• 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

Multiplayer

ThreeChoiceChests works in multiplayer.

The player who opens a chest owns that reward. After a choice is made, the selected item is granted directly to that player instead of being left on the ground for someone else to steal.

If several rewards are waiting at once, they are handled by a global queue and shown one at a time. This is intentional for stability: only one ThreeChoice picker is active at once.

Sale Star support

Sale Star is fully supported.

If a supported chest produces multiple native rewards, each real reward becomes its own three-choice selection.

Each reward keeps the tier and category that the base game actually rolled. For example:

• a Large Chest that rolls a green reward and a red Sale Star bonus produces one green choice and one red choice;
• a Legendary Chest with Sale Star produces two separate red choices.

Sale Star itself is still controlled entirely by the base game. This mod only catches the rewards the game actually generates.

High-mobility support

Once a chest has been successfully opened, its ThreeChoice picker no longer cares how far away the opener moves.

You can sprint, launch, teleport, or otherwise leave the chest behind without causing the choice UI to repeatedly close and reopen.

Only ThreeChoiceChests' own picker ignores this distance check. Normal chest interaction range and normal Artifact of Command behavior are unchanged.

Candidate descriptions

For Simplified Chinese (zh-CN), ThreeChoiceChests includes a private set of 217 hand-authored short descriptions for vanilla items and equipment.

These descriptions include:

• clearer short-form effect summaries;
• reviewed on-hit / on-kill labels where useful;
• consistent mechanic coloring.

Candidate names still follow the game's active localization.

The private catalog does not replace global item names, pickup text, descriptions, or lore. Other languages and unknown/modded candidates fall back to their normal localized pickup descriptions.

It works with or without my independent Chinese Retranslation mod.

Scoreboard and pause behavior

• The scoreboard / inventory can be opened while a choice is pending.
• Opening it temporarily hides the choice UI without consuming or rerolling the reward.
• Closing it restores the same picker and candidates.
• Escape / pause-menu interruption recovery is supported.
• A reward is finalized only after a valid candidate is selected.

The Command Artifact information card is suppressed only for ThreeChoiceChests' internal 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

ThreeChoiceChests can coexist with UniversalPause.

Without UniversalPause, the mod uses its built-in single-player choice-pause fallback.

Multiplayer currently uses a stable global serial choice queue rather than simultaneous per-player pickers.

Requirements

• BepInExPack
• HookGenPatcher
• 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.