ThreeChoiceChests

By Riiin.

Supported chests and equipment barrels offer three choices. The reward the game originally rolled is included, and the other candidates follow its item tier and chest category.

What is new in 1.3.2

This release publishes Choice Extension API v1 for independent companion mods. It provides stable reward identities, candidate snapshots, reward lifecycle notifications and optional candidate-tooltip additions.

ThreeChoiceChests works on its own. It contains no AD/AP stats, random attribute growth or AD/AP damage calculations. The separate ADAPPrototype mod can use this API without owning the chest workflow.

Supported containers

• Small and invisible chests
• Large and legendary chests
• Damage, healing and utility chests, including their large variants
• Equipment barrels

Lunar Pods, Void Cradles, Free Chests, Command Chests and Adaptive Chests retain their existing behavior.

Candidate tooltips

Hover a candidate for its localized name and short effect description, with native item/equipment title colors. Simplified Chinese (zh-CN) has 217 private short descriptions for supported vanilla items and equipment. Other languages and modded entries use the available game localization.

The short descriptions are limited to this mod's picker. The Logbook and global item text are not replaced. Chinese Retranslation is optional and remains a separate mod.

Rewards and multiplayer

Each supported chest reward belongs to the opener. The selected item is granted directly to that owner. Multiple pending rewards use a single shared queue, including in multiplayer; simultaneous per-player choice windows are not supported.

Sale Star and other native multi-reward chest results each produce their own choice, preserving the tier and category of each original reward. Native reward rolling and Sale Star consumption stay unchanged.

After opening a supported chest, you can move away without dismissing its pending choice. Reopening a pending choice preserves its candidates.

Scoreboard and pause

• Open the scoreboard / inventory while a choice is pending; the choice hides and returns with the same candidates.
• Escape / pause interruptions retain the pending reward.
• UniversalPause is optional. The existing single-player choice-pause fallback remains available.

The extension API does not replace the selection queue, input, reward ownership, native granting or pause/protection behavior. API users handle their own data and network synchronization.

Installation

Install with r2modman or Thunderstore Mod Manager. Dependencies:

• bbepis-BepInExPack-5.4.2122
• RiskofThunder-HookGenPatcher-1.2.9
• RiskofThunder-R2API_Prefab-1.1.1

For manual installation, copy the package's plugins content into BepInEx/plugins, with the dependencies installed. Keep one copy of ThreeChoiceChests; replace earlier manual DLLs rather than loading both.

简体中文

支持的宝箱和装备桶提供三选一，保留原版奖励、品质和分类。悬停可查看名称和精简说明；每份Sale Star额外奖励单独三选；联机奖励归开箱者，所有待选奖励共用一个串行队列。

1.3.2公开通用扩展API，供ADAP等独立Mod接入。TCC本身不计算AD/AP，也不生成随机属性，不需要ADAP即可独立使用。此次没有重新设计Tab、暂停或选择生命周期。

The existing API-enabled build has been used successfully with ADAP in the author's profile. This release changes its version metadata and startup version text; a fresh-profile and multiplayer release-pair installation has not been tested.

Code developed with AI assistance.

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.