缩物搬运 / ShrinkHaulSimple

把贵重物品放进 推车（C.A.R.T） 或 提取点 时，按体型自动缩小，方便搬运；拿出来后自动恢复原尺寸。

交流：#腾讯频道：pd77525911

---

依赖

依赖	说明
BepInExPack	插件加载框架
ScalerCore 1.1.1	缩放库（作者 Vippy），负责缩放 / 物理 / 碰撞 / 音频 / 多人同步

用 r2modman / Thunderstore Mod Manager 安装时，这两个依赖会自动下载，不需要手动装。 手动安装时请把 ShrinkHaulSimple.dll 与 ScalerCore.dll 都放进 BepInEx/plugins。

---

测试范围

⚠️ 目前仅经过单人游戏测试（缩物、恢复、体型倍率、推车与提取点判定均已验证）。 多人（联机）尚未验证 —— 缩放同步由 ScalerCore 负责，「仅房主执行」已默认开启， 但队友端表现可能与本机不同。多人遇到问题请附房主与队友双方的日志。

---

功能

功能	说明
推车缩小	物品进入推车后自动缩小；判定优先用游戏自己的 PhysGrabInCart.inCartObjects（权威信号），碰撞包围盒作为回退
提取点缩小	物品进入提取点 2.5m 范围内后自动缩小
按体型分类倍率	用游戏自带 ValuableVolume.Type 的七档体型，各自可配倍率
推车里再缩一点	在体型倍率基础上再乘 0.7
拿出即恢复	离开推车与提取点后恢复原尺寸
只动自己缩过的	不会被本模组恢复其它缩放类模组缩放的对象
仅房主执行	多人时由房主调用缩放，ScalerCore 负责同步

---

安装

1. 安装 BepInExPack
2. 安装 ScalerCore 1.1.1（截图里的依赖，管理器会自动装）
3. 把 ShrinkHaulSimple.dll 放进 BepInEx/plugins
4. 启动游戏

---

配置

配置文件：BepInEx/config/cn_xc.ShrinkHaulSimple.cfg（改动后重启生效）

触发范围

配置项	默认	说明
推车缩小	true	物品放进推车就缩小
提取点缩小	true	物品进入提取点就缩小

以下三项为固定参数，不提供配置项（按实测写死）： 提取点判定半径 2.5m、推车额外倍率 0.7、推车判定外扩 0。

体型倍率（1.0 = 该体型不缩小）

体型	默认倍率	推车里实际
微小 Tiny	0.8	0.56
小 Small	0.7	0.49
中 Medium	0.5	0.35
大 Big	0.4	0.28
宽 Wide	0.4	0.28
高 Tall	0.4	0.28
超高 VeryTall	0.3	0.21

通用

配置项	默认	说明
仅房主执行	true	多人时只让房主决定缩放，避免重复执行
详细日志	false	输出每次缩放/恢复的明细（含体型与倍率）

---

日志示例

开启 详细日志 后，LogOutput.log 里会出现：

[缩小] Valuable Manor Toy Monkey(Clone) 体型=Small → x0.49（推车）
[缩小] Valuable Arctic Server Rack(Clone) 体型=VeryTall → x0.3（提取点）
[恢复] Valuable Arctic Server Rack(Clone)

启动时应看到（ScalerCore 先加载，本模组随后）：

Loading [ScalerCore 1.1.1]
Loading [缩物搬运 0.1.1]
缩物搬运 v0.1.1 已加载（依赖 ScalerCore）。

如果只看到 缩物搬运 而没有 ScalerCore，说明依赖没装好，本模组会因为 HardDependency 而拒绝加载。

---

已知限制

1. 判定基于游戏状态与包围盒，不是游戏内建的「已入库」状态：物品停在提取点半径内就会被缩
2. 在提取点边缘来回走动时物品会反复「缩小 ↔ 恢复」（抖动），属正常现象
3. **倍率过低（< 0.2）**可能导致穿模或掉落判定异常
4. 不要与 ShrinkCart / ShrinkerCartPlus / Shrinkercart2 等同类推车缩小模组同时启用 —— 会重复缩放同一批物品

---

致谢

• Vippy（Justin Wells） —— ScalerCore 的作者。 本模组的缩放、物理、碰撞、音频与多人同步全部由 ScalerCore 完成，没有它就没有这个模组。 按作者要求，本模组以依赖方式使用 ScalerCore，不重复分发其二进制。
• semiwork —— R.E.P.O. 的开发者，模组生态全靠他们的游戏。
• BepInEx 团队 —— 插件加载框架。
• 帮忙测试与反馈的玩家 —— 感谢提供实测数据（体型判定、推车行为、提取点半径）。

---

授权

• 本模组自身代码为独立实现，未使用任何第三方模组的源码
• 体型分类取自游戏自带的 ValuableVolume.Type 枚举