载具工具箱 / VehicleTools

REPO 游戏交流 QQ 群：824639225

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

Scroll down for English ↓

⚙️ 核心功能说明

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

1. 👁️ 优化驾驶视角

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

2. 👥 载人挂载系统重构

• 禁止载人：仅允许驾驶员上车，强力拦截其余乘客的乘车请求。
• 左右悬挂：前 5 位乘车玩家挂载在载具左侧外壁，后续挂载在右侧外壁，依次排开。
• 头顶旋转：所有人悬挂在车顶并绕中轴均匀公转，每个人面向圆周外侧。
• 抓车即上车：用物理手套抓取车身即可自动被吸附并锁定到挂载点；在布娃娃状态下再次抓车即可瞬间下车。
• 强制防卫蹲姿：乘车挂载状态下强制乘员每帧下蹲最底部，乘车姿态端正。
• 默认最多乘车人数为 10 人。

3. 🏎️ 载具限速与跳跃

• 双重限速拦截：可自定义调整最高限速值，采用物理层双层速度剪裁，且关闭限速时完美恢复原版性能。
• 载具跳跃机制：支持按空格跳跃、空中连续跳跃、跳跃冷却调节以及跳跃后翻车保护，默认跳跃力为 40。

4. 🚛 载货车专属增强

• 库存无限：突破货箱的重量与价值上限限制。
• 无视物品大小限制：大型物品也可强行放入载货车货箱。
• 吸取范围倍率：支持 1.0倍 - 5.0倍 范围调节载货车自动吸附货物的物理范围。
• 每局自动生成载货车：该开关位于全局辅助分页，由主机或单机生效。

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

• 高级交互滑块与实心亮绿方块复选框，精细描边分区，带一键重置。
• 配置项隐藏与自动持久化，快捷键组件支持左右箭头“切换式”软限制选择。
• 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.

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.
   • Head/Top Rot: Mounts passengers above the roof, rotating while looking outwards.
   • Grab-To-Mount: Auto-mounts the player onto a free slot upon grabbing the vehicle; 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 dual-layer safety clamps. Spacebar jumping, continuous jumping, and tumble immunity. Default jump force is 40.
4. Cargo Truck Enhancements: Options for unlimited cargo capacity, ignoring item size limits, customizable cargo magnet range, and host-side automatic cargo truck spawning from the Global tab.
5. 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 前缀，并且工具箱按键变更为符合规范的“切换式”软限制选择组件。支持中英文语言包实时检测与热切。