TrashBox

ShopItem Trash Box MOD / 商店物品垃圾桶模組

Introduction / 簡介

A trash box that can destroy excess shop items and recover part of their value.

一個可以銷燬多餘商店物品並返還部分價值的垃圾桶。

Description / 說明

• Basic Function / 基本功能
• A trash box will automatically spawn in the truck after the run starts.
• 遊戲開局後，一個垃圾桶會自動在卡車內生成。
• You can put extra ShopItems into it.
• 你可以將多餘的商店物品放入其中。
• Items inside the trash box will smoothly scale down to half size instead of changing size instantly.
• 物品進入垃圾桶後會平滑縮小到原本體積的一半，而不是瞬間變大變小。
• After the collect window ends, the trash box will close, process all items together, and then return one money bag.
• 收集窗口結束後，垃圾桶會統一關蓋、處理所有物品，並返還一個錢袋。
• The trash box only spawns in normal run levels, not in tutorial, shop, or lobby menu levels.
• 垃圾桶只會在正常關卡生成，不會在教程、商店或大廳菜單關卡生成。
• Money Return Logic / 金錢返還邏輯
• The returned money bag value is based on the value of the ShopItems you destroy.
• 返還的錢袋價值基於你所銷燬的商店物品價值。
• However, the calculation is now done per item, not by rolling once on the total value.
• 但是，當前版本的計算方式是按每個物品單獨結算，而不是對總價值只隨機一次。
• Each item first reads its own value, then rolls a random recovery ratio, and finally all item results are added together into one final money bag.
• 每個物品會先讀取自己的價值，再單獨隨機一個回收比例，最後把所有物品的結果累加成一個最終錢袋。
• Default config range:
• 默認配置區間：
• RecoveryRatioMin = 0.3
• RecoveryRatioMin = 0.3
• RecoveryRatioMax = 0.8
• RecoveryRatioMax = 0.8
• Example:
• 例如：
• Item A: 3000 x 0.31
• 物品 A：3000 x 0.31
• Item B: 3000 x 0.67
• 物品 B：3000 x 0.67
• Item C: 3000 x 0.48
• 物品 C：3000 x 0.48
• Final money bag value = sum of all item results
• 最終錢袋價值 = 所有單件回收結果之和
• The final money bag value is rounded to the nearest hundred and will not be lower than 1000.
• 最終錢袋價值會按百位取整，並且不會低於 1000。
• AssetBundle Loading / 資源包加載說明
• TrashBox.dll and the trashbox AssetBundle file must be placed in the same folder under BepInEx/plugins.
• TrashBox.dll 和 trashbox 資源包文件必須放在 BepInEx/plugins 下的同一個目錄裏。
• The folder name does not matter.
• 目錄名本身不重要。
• As long as the DLL and AB file exist together in any subfolder under plugins, the mod can load correctly.
• 只要 DLL 和 AB 文件同時存在於 plugins 下任意同一個子目錄，模組就能正確加載。
• Multiplayer Synchronization / 多人同步說明
• Tested and works correctly in single-player.
• 單人模式下測試可正常使用。
• In multiplayer, item destruction and value calculation are executed by the host.
• 多人模式下，物品銷燬和回收金額計算由主機執行。
• Lid open/close animations are synchronized through RPC.
• 垃圾桶開蓋與關蓋動畫通過 RPC 同步。
• Important: For best results, this MOD should be installed by the host AND all clients.
• 重要：爲了獲得最佳效果，此模組建議由主機以及所有客戶端都安裝。
• Config / 配置項
• RecoveryRatioMin
• RecoveryRatioMin
• Minimum recovery ratio rolled for each item.
• 每個物品單獨結算時使用的最小回收比例。
• Default: 0.3
• 默認值：0.3
• RecoveryRatioMax
• RecoveryRatioMax
• Maximum recovery ratio rolled for each item.
• 每個物品單獨結算時使用的最大回收比例。
• Default: 0.8
• 默認值：0.8
• If both values are set to the same number, every item will use a fixed recovery ratio.
• 如果把兩個值設爲相同數字，那麼每個物品都會按固定比例回收。

Author / 作者

小海 XiaoHai

BiliBili:

ChangeLog

• 1.0 Initial release
• 1.0 正式版本發佈

• 1.1 Added automatic half-scale when items overlap the trash collider; fixed bug causing destroyed items to respawn in later levels
• 1.1 新增自動體積縮放功能；修復銷燬的物品在後面的關卡會重新生成的 BUG

• 1.2 Fixed the issue where the initial position of the trash box was not synchronized between the host and clients
• 1.2 修復了主機和客戶端之間垃圾桶初始位置不同步的問題

• 1.3 Updated for latest game API compatibility; improved AssetBundle loading so DLL and AB can be placed in any subfolder under plugins; changed item scaling to smooth transitions; changed recycle logic to roll a random recovery ratio for each item individually and sum all results
• 1.3 適配最新版本遊戲 API；調整 AB 加載邏輯，只要 DLL 和 AB 位於 plugins 下任意同一子目錄即可加載；將物品縮放改爲平滑過渡；將回收邏輯改爲每個物品單獨隨機回收後再累加