VehicleTools

載具工具箱 / VehicleTools

REPO 遊戲交流 QQ 羣：824639225

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

Scroll down for English ↓

💡 快速乘車/下車指南

爲了防止玩家在推車、整理物資時誤觸上車，模組設計了高精度的防誤觸掛載邏輯，請按照以下方式乘車：

• 抓取中後部：用物理手套抓取車輛的中後部、兩側車廂欄板、或車尾部位（抓取車頭或引擎蓋屬於駕駛區，無法上車）。
• 原地靜止2秒：抓車後原地保持絕對不動 2 秒（或您在 F1 面板中設置的時間），即可自動被吸附上車。
• 亂動即作廢：抓車等待期間，如果您發生了任何明顯的走動或推車位移，本次計時將立即作廢。若想再次上車，必須鬆開抓取鍵，重新抓車並保持靜止。
• 如何下車：在布娃娃狀態下，抓取一下車輛即可瞬間下車。

⚙️ 核心功能說明

按下 F1 即可打開載具工具箱，集中設置各種載具擴展功能。這個模組的主要用途是讓好友也能坐上車，同時提供載貨、跳躍、限速、車輛保護等輔助功能。

• 👁️ 優化駕駛視角
• 駕車時視角高度平滑升高（提供2.2米開闊高視野），下車自動還原。
• 採用平滑插值過渡，杜絕瞬間瞬移，車輛行駛與顛簸時具備高水平防抖表現。
• 👥 載人掛載系統重構
• 禁止載人：僅允許駕駛員上車，強力攔截其餘乘客的乘車請求。
• 左右懸掛：前 5 位乘車玩家掛載在載具左側外壁，後續掛載在右側外壁，依次排開。
• 疊羅漢（默認）：乘客掛載在車頂正上方，並垂直依次向上疊加，形成滑稽的疊羅漢效果。
• 頭頂旋轉：所有人懸掛在車頂並繞中軸均勻公轉，每個人面向圓周外側。
• 抓車後靜止上車（防誤觸）：抓取車身中後部或兩側車廂，並保持原地不動即可自動吸附掛載；單次物理抓取只有一次靜止判定機會，抓車期間有任何相對位移本次抓取即宣告作廢，必須放開重新抓車靜止方可上車，徹底杜絕推車和拿取貨箱物資時的誤觸。在布娃娃狀態下再次抓車即可瞬間下車。
• 強制防衛蹲姿：乘車掛載狀態下強制乘員每幀下蹲最底部，乘車姿態端正。
• 默認最多乘車人數爲 10 人。
• 🏎️ 載具限速與跳躍
• 雙重限速攔截：可自定義調整最高限速值，採用物理層速度剪裁，默認最大限速已由舊版 45 提升至 55 km/h。
• 載具跳躍機制：支持按空格跳躍、空中連續跳躍、跳躍冷卻調節以及跳躍後翻車保護，默認跳躍力爲 40。
• 🚛 載貨車專屬增強
• 庫存限制調節：支持開啓自定義庫存價值限制（上限默認 50k）。徹底解決了修改限額超限後車子罷工不吸貨，以及超載物品堵在吸附口導致車門反覆抽風開關門的 Bug。
• 無視物品大小限制：大型物品也可強行放入載貨車貨箱。
• 吸取範圍倍率：支持 1.0倍 - 10.0倍 範圍調節載貨車自動吸附貨物的物理範圍。
• 智能自動生成載貨車：支持每局開局自動生成載貨車（限主機/單機）。優先在場景內的玩家出生點（SpawnPoint）生成，防止車子刷出地圖外的 Bug，並限制只在正式遊戲關卡中生效。
• 🏟️ 死亡競技場與賽車模式防干擾（功能靜默禁用）
• 自動場景感知識效：當檢測到當前處於賽車比賽（Race）或死亡競技場王冠賽（Crown/Arena）中時，Mod 所有的核心功能（限速、跳躍、掛載、刷車、傳送等）會自動靜默失效。
• 純淨原版競技（F1仍可開啓）：物理與位置修改補丁全部跳過（完全迴歸官方原生物理規則），防墜崖及防爆傳送保護在此期間不介入；但 F1 控制面板依然能在局內隨時按鍵正常開啓與查看。
• 🎨 現代高對比度控制面板
• 高級交互滑塊與實心亮綠方塊複選框，精細描邊分區，帶一鍵重置。
• 配置項隱藏與自動持久化，快捷鍵組件支持左右箭頭“切換式”軟限制選擇。
• F1 面板只管理運行時功能，模組總開關僅保留在遊戲內模組菜單。

多人聯機只需主機安裝。若客機也安裝了同樣的模組，可通過網絡實現參數同步。

兼容性

與其他載具限速或掛載類模組加載時可能有衝突提示，建議只保留 VehicleTools。

按鍵

| 按鍵 | 功能 |

| --- | --- |

| F1（可配置） | 打開 / 關閉車輛工具箱面板 |

| 空格鍵 (Space) | 載具跳躍 (需在面板中開啓) |

配置

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

| 分組 | 配置項 | 默認值 | 說明 |

| --- | --- | --- | --- |

| B.全局設置 | 模組啓用 | true | 總開關 |

| B.全局設置 | 工具箱按鍵 | F1 | 呼出控制面板快捷鍵 |

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:

• 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).
• Stay Still for 2s: Keep completely still for 2 seconds (or the time configured in the F1 panel) to auto-mount.
• 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.
• How to Dismount: While in ragdoll state, grab the vehicle once to dismount instantly.

Features

• Optimize Driving Camera: Smoothly raises camera height when driving with interpolation and high stabilization.
• 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.
• Speed Limiter & Jumping: Custom maximum speed limiter with physical speed clamping. Default maximum speed has