ThreeChoiceChests
Three-choice chest rewards with tier/category preservation, short candidate tooltips and optional Choice Extension API v1. Works independently of ADAP.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.2122RiskofThunder-HookGenPatcher-1.2.9RiskofThunder-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.