载具工具箱 / VehicleTools

REPO 游戏交流 QQ 群：824639225

支持 R.E.P.O. 最新 v0.4。

Scroll down for English ↓

💡 快速乘车/下车指南

为了防止玩家在推车、整理物资时误触上车，模组设计了高精度的防误触挂载逻辑，请按照以下方式乘车：

1. 抓取中后部：用物理手套抓取车辆的中后部、两侧车厢栏板、或车尾部位（抓取车头或引擎盖属于驾驶区，无法上车）。
2. 原地静止2秒：抓车后原地保持绝对不动 2 秒（或您在 F1 面板中设置的时间），即可自动被吸附上车。
3. 乱动即作废：抓车等待期间，如果您发生了任何明显的走动或推车位移，本次计时将立即作废。若想再次上车，必须松开抓取键，重新抓车并保持静止。
4. 如何下车：在布娃娃状态下，抓取一下车辆即可瞬间下车。

⚙️ 核心功能说明

按下 F1 即可打开载具工具箱，集中设置各种载具扩展功能。这个模组的主要用途是让好友也能坐上车，同时提供载货、跳跃、限速、车辆保护等辅助功能。

1. 👁️ 优化驾驶视角

• 驾车时视角高度平滑升高（提供2.2米开阔高视野），下车自动还原。
• 采用平滑插值过渡，杜绝瞬间瞬移，车辆行驶与颠簸时具备高水平防抖表现。

2. 👥 载人挂载系统重构

• 禁止载人：仅允许驾驶员上车，强力拦截其余乘客的乘车请求。
• 左右悬挂：前 5 位乘车玩家挂载在载具左侧外壁，后续挂载在右侧外壁，依次排开。
• 叠罗汉（默认）：乘客挂载在车顶正上方，并垂直依次向上叠加，形成滑稽的叠罗汉效果。
• 头顶旋转：所有人悬挂在车顶并绕中轴均匀公转，每个人面向圆周外侧。
• 抓车后静止上车（防误触）：抓取车身中后部或两侧车厢，并保持原地不动即可自动吸附挂载；单次物理抓取只有一次静止判定机会，抓车期间有任何相对位移本次抓取即宣告作废，必须放开重新抓车静止方可上车，彻底杜绝推车和拿取货箱物资时的误触。在布娃娃状态下再次抓车即可瞬间下车。
• 强制防卫蹲姿：乘车挂载状态下强制乘员每帧下蹲最底部，乘车姿态端正。
• 默认最多乘车人数为 10 人。

3. 🏎️ 载具限速与跳跃

• 双重限速拦截：可自定义调整最高限速值，采用物理层速度剪裁，默认最大限速已由旧版 45 提升至 55 km/h。
• 载具跳跃机制：支持按空格跳跃、空中连续跳跃、跳跃冷却调节以及跳跃后翻车保护，默认跳跃力为 40。

4. 🚛 载货车专属增强

• 库存限制调节：支持开启自定义库存价值限制（上限默认 50k）。彻底解决了修改限额超限后车子罢工不吸货，以及超载物品堵在吸附口导致车门反复抽风开关门的 Bug。
• 无视物品大小限制：大型物品也可强行放入载货车货箱。
• 吸取范围倍率：支持 1.0倍 - 10.0倍 范围调节载货车自动吸附货物的物理范围。
• 智能自动生成载货车：支持每局开局自动生成载货车（限主机/单机）。优先在场景内的**玩家出生点（SpawnPoint）**生成，防止车子刷出地图外的 Bug，并限制只在正式游戏关卡中生效。

5. 🏟️ 死亡竞技场与赛车模式防干扰（功能静默禁用）

• 自动场景感知识效：当检测到当前处于赛车比赛（Race）或死亡竞技场王冠赛（Crown/Arena）中时，Mod 所有的核心功能（限速、跳跃、挂载、刷车、传送等）会自动静默失效。
• 纯净原版竞技（F1仍可开启）：物理与位置修改补丁全部跳过（完全回归官方原生物理规则），防坠崖及防爆传送保护在此期间不介入；但 F1 控制面板依然能在局内随时按键正常开启与查看。

6. 🎨 现代高对比度控制面板

• 高级交互滑块与实心亮绿方块复选框，精细描边分区，带一键重置。
• 配置项隐藏与自动持久化，快捷键组件支持左右箭头“切换式”软限制选择。
• F1 面板只管理运行时功能，模组总开关仅保留在游戏内模组菜单。

多人联机只需主机安装。若客机也安装了同样的模组，可通过网络实现参数同步。

兼容性

与其他载具限速或挂载类模组加载时可能有冲突提示，建议只保留 VehicleTools。

按键

配置

BepInEx/config/zichen.vehicletools.cfg，版本更新后自动重置。

English

A comprehensive in-game vehicle tool panel for R.E.P.O. Host-only installation required. If clients have the same mod installed, config parameters will sync automatically. Press F1 anywhere (including Main Menu, Lobby, Loading, In-Game, and Pause Menu) to open the control panel.

💡 Quick Start: How to Mount / Dismount

To prevent unwanted mounting during vehicle pushing or item handling, a precise anti-accident logic is implemented. Follow these steps:

1. Grab Rear/Sides: Grab the rear bumper, tail cargo box, or side walls of the vehicle with your physics gloves (grabbing the front hood/front cabin is reserved for driving and won't trigger passenger mounting).
2. Stay Still for 2s: Keep completely still for 2 seconds (or the time configured in the F1 panel) to auto-mount.
3. Move to Cancel: If you move or walk during grabbing, the timer is instantly disqualified. To try again, you must release the grab key and grab it again while staying still.
4. How to Dismount: While in ragdoll state, grab the vehicle once to dismount instantly.

Features

1. Optimize Driving Camera: Smoothly raises camera height when driving with interpolation and high stabilization.
2. Redesigned Mounting Modes:
   • No Passengers: Only the driver is allowed to get on board.
   • Sides: Mounts passengers on left/right outer walls.
   • Totem (Default): Mounts passengers vertically stacked on top of the vehicle roof.
   • Head/Top Rot: Mounts passengers above the roof, rotating while looking outwards.
   • Still-To-Mount (Anti-Accident): Grab the rear/sides of the vehicle and keep still to auto-mount. Moving during grabbing instantly disqualifies the current session; you must release and grab again while staying still to mount, preventing unwanted mounting during pushing or cargo handling. Grab it again to dismount.
   • Enforced Crouch: Automatically forces seated avatars into a crouch pose.
   • Default maximum passenger count is 10.
3. Speed Limiter & Jumping: Custom maximum speed limiter with physical speed clamping. Default maximum speed has been raised to 55 km/h (previously 45). Spacebar jumping, continuous jumping, and tumble immunity. Default jump force is 40.
4. Cargo Truck Enhancements:
   • Cargo Limit Customization: Set custom weight value limits (default 50k). Fixed native bugs causing vacuum failure when limits change and infinite door opening/closing loop when over-limit items block the inlet.
   • Ignore Size Limit: Large items can be sucked into the cargo box without size checks.
   • Sucking Range Multiplier: Support 1.0x to 10.0x range to expand cargo absorption areas.
   • Cargo Truck Spawning: Spawns a cargo truck at the start of each level (host-only). Spawns safely at the level's SpawnPoint to prevent vehicles clipping through walls or falling off bounds, and is restricted strictly to active levels.
5. Arena & Race Mode Feature Bypass: Automatically detects when a Race or Arena Match starts, and completely disables all physical patches (speed limit, jump, mounting, teleportation, spawning) to ensure fair play, while keeping the F1 control panel accessible.
6. Modern High-Contrast UI: Standard toggle-style controls with top-left "Reset All" button. The F1 panel manages runtime features only; the master mod toggle remains in the in-game Mods menu.

Compatibility

Using other speed-limiting or mounting mods alongside VehicleTools may cause warnings or conflicts. It is recommended to use only VehicleTools.

Controls

Settings

BepInEx/config/zichen.vehicletools.cfg — resets to defaults after version update.

1.0.3

• 乘客挂载默认改为叠罗汉：默认的挂载乘客模式变更为更具娱乐性的“叠罗汉”挂载。
• 全新“移动即废弃”静止上车防误触逻辑：
  • 玩家抓握车身后面后需要保持原地静止不动 2 秒方可上车；
  • 抓车计时的等待周期内只要有任何明显的走动或推车相对位移，当前抓握会话立刻判定失效（HasMoved = true），继续站立再久也绝不会误触发上车。必须松手并重新抓车不动才能开启新一轮的 2 秒计时检测，彻底杜绝了推车与整理物资时的乘车误触。
• 载货车货箱吸附死锁 Bug 修复：
  • 修复了修改库存价值限额超载后，改回上限或拿空货物车厢依然不再吸取任何货物的状态机死锁缺陷（通过反射自动在低于上限时恢复 Idle 状态）；
  • 修复了超载物品放在吸口导致货箱门反复开关门抽风的死循环问题（在 Idle 状态提前过滤掉引起超载的候选吸附物品）。
• 载货车吸附范围与价值限额优化：
  • 载货最大限制支持界面滑条控制（默认 50k）；
  • 载货吸附范围上限从原本 5 倍增加到 10 倍。
• IMGUI 排版文本汉化修正：修正了漏字语病，改为更通顺的“抓住车身后面后原地不动上车时间：”。
• 清单与文档适配：移除了 manifest.json 最后的 QQ 交流群广告文字；README 文档头部加入显眼的快速乘车与下车指南，方便玩家浏览上手。

1.0.2

• 补回移速控制与限速滑条，并将默认最高限速提升为 55 公里/小时。
• 配置文件新增版本号追踪，版本升级后自动将控制面板设置重置为新版默认值。
• 在赛车与王冠竞技场中自动静默失效（不注入任何物理修改），但控制面板仍可开启。
• 自动刷车仅在正式关卡触发，且优先在场景出生点生成，防止刷出地图外。

1.0.1

• 优化载具工具箱界面，整体布局更清晰，按钮和文字更易查看。
• 优化全局功能开关，现在可以统一控制载具工具箱的所有功能。
• 新增和调整多项载具辅助功能，让载人、载货、跳跃和车辆保护的使用体验更顺手。
• 优化默认参数，重置后会使用更适合多人游玩的默认设置。
• 优化配置保存和重置逻辑，减少旧配置影响新版本默认值的问题。

1.0.0

• 初始版本发布，集成所有载具管理核心功能。
• 全新物理挂载载人系统：支持“不载人”、“左右悬挂”与“头顶旋转”三种模式。通过高精度物理拉力挂载，实现抓车自动上车与再次抓车下车，具备完备的双端物理同步预测，且不干扰主驾驶交互与操作。
• 载具跳跃与操控：支持按空格跳跃、空中连跳及翻车保护。
• 安全双重限速：前置软限速与后置刚体剪裁双层拦截，防止超速，且关闭限速时完全恢复原版性能。
• 载货车货箱增强：支持开启载货车“库存无限”和“吸取范围倍率”调节。
• 流畅开车视角：驾驶座物理位置优化并提供平滑的 Lerp 相机缓冲运镜。
• 全新交互 UI：提供高对比度霓虹绿/草绿/明黄状态指示大热区滑条与复选框，界面优雅细腻，支持一键重置。
• 前缀隐藏与快捷键优化：隐藏了模组信息键名在 UI 中的 Vehicle Tools 前缀，并且工具箱按键变更为符合规范的“切换式”软限制选择组件。支持中英文语言包实时检测与热切。