载具工具箱 / VehicleTools

REPO 游戏交流 QQ 群：824639225

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

Scroll down for English ↓

⚙️ 核心功能说明

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

1. 👁️ 优化驾驶视角

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

2. 👥 载人挂载系统重构

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

3. 🏎️ 载具限速与跳跃

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

4. 🚛 载货车专属增强

• 库存无限：突破货箱的重量与价值上限限制。
• 无视物品大小限制：大型物品也可强行放入载货车货箱。
• 吸取范围倍率：支持 1.0倍 - 5.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.

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 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 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.2

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

1.0.1

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

1.0.0

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