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

Introduction / 简介

A trash box that can destroy excess shop items and recover a certain amount of their value. 一个可以销毁多余商店物品并回收一定价值的垃圾桶。

Description / 说明

1. Basic Function / 基本功能

• A trash box will automatically spawn in the truck at the beginning of the game.
• 游戏开局后，一个垃圾桶会自动在卡车内生成。
• You can put extra ShopItems into it.
• 你可以将多余的商店物品放入其中。
• After 3 seconds, the items will be automatically destroyed, and a money bag will be returned to you.
• 3秒后，物品将被自动销毁，并向你返还一个钱袋。

2. Money Return Logic / 金钱返还逻辑

• The value of the returned money bag is based on the value of your ShopItem.
• 返还的钱袋价值基于你所销毁的商店物品的价值。
• However, it is NOT equal to the original purchase price from the shop.
• 但是，它不等于你从商店购买该物品的原价。
• Instead, a new random price is generated that falls within the item's original value tier.
• 而是会重新生成一个符合该物品原始价位区间的随机价格。
  • (Typically, this price will not differ significantly from the original.)
  • （通常，这个价格与原价不会有太大差异。）
• The money bag's value is then set to 50% of this newly generated random price.
• 钱袋的最终价值被设定为此新生成随机价格的50%。
  • Recovery Rate: 0.5 (Default, Configurable) / 回收倍率: 0.5 (默认值，可配置)

3. Multiplayer Synchronization / 多人同步说明

• Tested and works correctly in single-player.
• 单人模式下测试无问题。
• Multiplayer synchronization requires further testing.
• 多人同步功能需要经过进一步测试。
  • Important: This MOD must be installed by the host AND all clients.
  • 重要：此模组需要主机以及所有客户端都安装。
  • If a client does not have the MOD installed, they will only see the items suddenly disappear, followed by a money bag popping out (which is the expected behavior).
  • 如果客户端未安装此模组，他们只会看到物品突然消失，然后一个钱袋蹦出来（这是预期中的现象）。

Author / 作者

小海 XiaoHai
BiliBili: https://space.bilibili.com/2055787437

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 修复了主机和客户端之间垃圾桶初始位置不同步的问题。