ShrinkCart v0.2.33

适配 R.E.P.O. 4.0 的购物车缩小搬运 mod。 作者 / Author: AngelcoMilk

ShrinkCart 会在物品放入 C.A.R.T / 购物车后自动缩小，方便搬运；物品真正离开购物车后会恢复原尺寸。底层缩放由 ScalerCore 负责，ShrinkCart 负责购物车触发、分类倍率、边缘防抖、恢复冷却、商店用品过滤、车类载物过滤、主机同步，以及可选的玩家站车缩放和敌人进车秒杀。

依赖

• BepInEx-BepInExPack-5.4.2305
• Vippy-ScalerCore-0.6.1
• nickklmao-REPOConfig-1.2.6

Thunderstore/r2modman 安装时会自动拉取依赖。推荐房间内所有玩家都安装 ShrinkCart 和这些依赖，缩放表现最一致。

主要功能

• 购物车缩小搬运：支持的物品放入购物车后自动缩小，拿出并离车后恢复。
• 可配置物品/武器缩放：枪、血包、近战、手雷、工具、无人机、宝珠、升级、追踪器、地雷等商店用品默认不缩小，可在配置中开启“启用商店用品缩小”并使用商店用品倍率。
• 玩家缩放：默认开启，独立在“玩家缩放”配置分组中。开启后，玩家站在正式购物车中心区域一段时间会切换缩小/恢复；关闭时 ShrinkCart 不运行玩家扫描或玩家缩放逻辑。
• 代币/外观箱支持：新版本代币类箱子独立开关和倍率，默认倍率 0.4。
• 特殊物品支持：敌人球 Small/Medium/Big/Berserker 使用独立倍率；钱袋/Surplus 使用独立倍率；普通非贵重物默认不缩小。
• 主机权威同步：多人游戏中由主机配置决定缩放倍率、速度、特殊物品和恢复时机。

动图演示

商店用品默认不缩小

枪械、血包等商店购买类实用品默认不会被购物车缩小，避免影响战斗、治疗和工具使用。需要时可以在配置里开启“启用商店用品缩小”。

敌人球和钱袋会缩小

敌人球使用独立的敌人球配置；钱袋/SurplusValuable 使用特殊物品配置。

大型贵重物会缩小

大型、宽型、高型、超高型贵重物会按各自分类倍率缩小，适合搬运原本难以放进车里的物品。

R.E.P.O. 4.0 特殊物品支持

R.E.P.O. 新版本的特殊物品同样可以被识别并缩小；v0.2.33 保留 CosmeticWorldObject / ItemValuableBox 代币/外观箱适配。

配置说明

配置界面由 REPOConfig 提供，主要配置项为中文：

• 购物车：启用购物车缩小、放入时缩小速度、取出后放大速度、离车防抖延迟、恢复后重新缩小冷却、启用重量随缩放降低、启用商店用品缩小、防止碰撞弹回原尺寸。
• 玩家缩放：启用玩家缩放、玩家进车缩放倍率、玩家站车触发时间、玩家离车判定宽容时间、启用玩家受伤后自动恢复。
• 贵重物分类：Tiny、Small、Medium、Big、Wide、Tall、VeryTall 各自开关和倍率。
• 敌人球：启用敌人球缩小、Small/Medium/Big/Berserker 倍率。
• 特殊物品：钱袋/Surplus 开关和倍率、代币/外观箱开关和倍率。
• 商店用品：商店用品缩小倍率。
• 车辆碾压：敌人进车秒杀。
• 诊断：启用调试日志，默认 false。

默认值：缩小速度 0.5，放大速度 0.2，离车防抖 0.5，恢复冷却 0.5，启用重量随缩放降低 false，启用商店用品缩小 false，启用玩家缩放 true，玩家缩放倍率 0.55，玩家站车触发时间 2 秒，玩家离车判定宽容时间 0.6 秒，启用玩家受伤后自动恢复 true。车类载物过滤固定为内部保护，不再作为配置项显示。贵重物倍率：Tiny 0.8，Small 0.6，Medium 0.45，Big 0.4，Wide 0.35，Tall 0.35，VeryTall 0.25。敌人球倍率：Small 0.8，Medium 0.65，Big 0.45，Berserker 0.45。商店用品倍率 0.5，钱袋/Surplus 0.25，代币/外观箱 0.4。

已知限制

• 缩放动画和可选质量缩小由 ScalerCore 控制，ShrinkCart 不手动写入 Rigidbody.mass，只传递 PreserveMass 选项。
• ShrinkCart 不接管车对车物理碰撞，也不会使用穿透修正或速度钳制；车辆真实碰撞表现以原版为准。
• 如果其他缩放类 mod 已经控制同一个对象，ShrinkCart 会尽量避免覆盖该对象。
• 客户端未安装 ShrinkCart 时，仍可能看到 ScalerCore 默认闪光/声音；全员安装效果最稳定。
• ShrinkCart 不 patch 死亡或复活流程。REPOFidelity 与提取点复活类 mod 的冲突请使用独立的 ExtractionReviveFix，不要在 ShrinkCart 内处理。
• 多人中缩小和恢复由主机统一确认并通过 ScalerCore 同步，物品离车后可能略等原版购物车刷新和防抖确认再恢复，但所有客户端会跟随同一主机时机。

English

ShrinkCart is a R.E.P.O. 4.0 cart-scaling mod by AngelcoMilk.

When supported objects are placed into a C.A.R.T. / shopping cart, ShrinkCart asks ScalerCore to shrink them for easier hauling. Objects restore to their original size after the host confirms they have truly left the cart. ShrinkCart handles cart triggers, category factors, edge debounce, restore cooldowns, shop-item filtering, cart-object filtering, host-authoritative sync, optional player cart-floor scaling, and enemy-in-cart instant kill.

Dependencies

• BepInEx-BepInExPack-5.4.2305
• Vippy-ScalerCore-0.6.1
• nickklmao-REPOConfig-1.2.6

Thunderstore/r2modman installs dependencies automatically. For the most consistent multiplayer experience, all players should install ShrinkCart and its dependencies.

Features

• Cart shrink hauling: supported objects shrink when placed into the cart and restore after leaving it.
• Configurable shop-item scaling: guns, medkits, melee items, grenades, tools, drones, pearls, upgrades, trackers, mines, and similar shop items do not shrink by default. Enable shop-item scaling in config if you want them to use the shop-item factor.
• Player scaling: enabled by default in its own config section. A player standing in the center floor area of a regular cart for the configured duration toggles shrink/restore. When disabled, ShrinkCart does not run player scanning or player-scaling logic.
• Token/cosmetic box support: token/cosmetic boxes use their own toggle and factor. Default factor is 0.4.
• Special object support: enemy orbs use independent enemy-orb factors; money bags / Surplus use their own factor; normal non-valuable objects do not shrink by default.
• Host-authoritative sync: in multiplayer, the host decides scaling factors, speeds, special-object behavior, and restore timing. ScalerCore then syncs the final result to clients.

GIF Demos

Shop Items Do Not Shrink By Default

Shop items such as guns and medkits do not shrink by default, so combat, healing, and tools remain usable unless shop-item scaling is enabled.

Enemy Orbs And Surplus Shrink

Enemy orbs use the enemy-orb config group. Money bags / SurplusValuable use the special-object config group.

Large Valuables Shrink

Large, wide, tall, and very tall valuables shrink with their own category factors, making oversized valuables easier to carry in carts.

R.E.P.O. 4.0 Special Item Support

R.E.P.O. 4.0 special items are detected and scaled. v0.2.33 keeps support for CosmeticWorldObject / ItemValuableBox token and cosmetic boxes.

Configuration

Configuration is provided through REPOConfig. Main groups:

• Cart: enable cart shrinking, shrink speed, restore speed, leave-cart debounce, reshrink cooldown, enable mass scaling with size, enable shop-item scaling, and suppress collision restore.
• Player scaling: enable player scaling, player cart scale factor, stand trigger time, exit grace time, and restore player on damage.
• Valuable categories: toggles and factors for Tiny, Small, Medium, Big, Wide, Tall, and VeryTall.
• Enemy orbs: enemy-orb toggle plus Small / Medium / Big / Berserker factors.
• Special objects: money bag / Surplus toggle and factor, token/cosmetic box toggle and factor.
• Shop items: shop-item scale factor.
• Vehicle crush: enemy instant kill in cart.
• Diagnostics: debug logging, default false.

Default values: shrink speed 0.5, restore speed 0.2, leave-cart debounce 0.5, reshrink cooldown 0.5, mass scaling with size false, shop-item scaling false, player scaling true, player scale factor 0.55, player stand trigger time 2 seconds, player exit grace time 0.6 seconds, restore player on damage true. Cart-object filtering is an internal protection and is no longer exposed as a config option. Valuable factors: Tiny 0.8, Small 0.6, Medium 0.45, Big 0.4, Wide 0.35, Tall 0.35, VeryTall 0.25. Enemy-orb factors: Small 0.8, Medium 0.65, Big 0.45, Berserker 0.45. Shop-item factor 0.5, money bag / Surplus 0.25, token/cosmetic box 0.4.

Known Limits

• ScalerCore controls scaling animations and optional mass scaling. ShrinkCart does not manually write Rigidbody.mass; it only passes the PreserveMass option.
• ShrinkCart does not control cart-to-cart physics collision, does not run penetration correction, and does not clamp vehicle velocity. Real cart collision behavior stays vanilla.
• If another scaling mod already controls the same object, ShrinkCart tries to avoid overriding it.
• If a client does not install ShrinkCart, they may still see or hear ScalerCore default flash/sound effects. Full-room installation is recommended.
• ShrinkCart does not patch death or revive flow. Use the separate ExtractionReviveFix for REPOFidelity and extraction-point revive compatibility.
• In multiplayer, shrink and restore are confirmed by the host and synced through ScalerCore. Restore after leaving the cart may wait for vanilla cart refresh plus debounce, but all clients follow the same host timing.