ScoutTwoSeater

COMPATIBLE WITH COSMETICS UPDATE V0.4.0.

ScoutTwoSeater

This mod is a host-only mod that turns the in-game Scout vehicle into a two-seater. One player drives normally, another player can hop onto the back as a passenger.

The host runs all the logic. Passengers do not need to install this mod and need no setup. When a non-mod client grabs the rear of the Scout, the host detects it and attaches that player as a ragdoll passenger on the back of the vehicle.

Main features

• Adds a passenger seat to the Scout vehicle without modifying its prefab
• Host-only install — passengers do not need to install this mod
• Click the rear of the Scout with the normal grab key to ride
• Click again (after release) to dismount
• Front of the Scout works exactly like vanilla — driver mounts via the red button, body can still be dragged
• The passenger does not fall off when hit by enemies (avoids seat-stealing chaos in multiplayer fights)
• Auto-dismount when the vehicle is destroyed or the passenger is flung too far
• Bilingual UI (English / Traditional Chinese) switchable via config
• Configurable pull strength (Weak / Strong), seat offsets, debounce, and more
• Auto-reloads config every 2 seconds — most options take effect without restart

Installation

• Install BepInEx for REPO.
• Place ScoutTwoSeater.dll into BepInEx/plugins.
• Start the game once to generate the config file.
• Edit the generated config if needed.
• Host the room with this mod installed.

Host-only behavior

Only the host needs this mod for the passenger feature to work. Passenger detection, ragdoll positioning, and physics are all handled by the host.

Players without the mod can still join and ride as passengers because this mod uses the existing Tumble + PhysGrabObject synchronization mechanisms instead of adding new networked objects.

How to use in-game

Think of the Scout as having a front end and a rear end:

• Front end (red palm button / front half): Vanilla behavior. Grab the red palm button to drive. Grab the body itself to drag the vehicle around.
• Rear end (back half): Grab it with the normal grab key to ride as a passenger. The player attaches to the rear of the Scout as a ragdoll.
• Dismount: Release the grab key first, then press it again on the Scout to get off. A 1.5s debounce prevents accidental immediate dismount.

Config items

00_Setup

| Setting | Description | Default |

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

| Language | Interface language. Restart the game after switching. EN / CN | EN |

General

| Setting | Description | Default | Min | Max |

|---|---|---:|---:|---:|

| Enabled | Enable the two-seater Scout. When false, Scout behaves like vanilla | true | - | - |

| PassengerSeat | Where the passenger sits. Back = rear of vehicle. Front = front of vehicle | Back | - | - |

| ForceUnequipOnMount | If true, forces the passenger to unequip their held item when they board | false | - | - |

| MountDebounceSeconds | Delay (seconds) after mounting before the passenger can press grab again to dismount | 1.5 | 0.1 | 10 |

| AutoDismountDistance | If the passenger ragdoll drifts more than this distance (meters) from the seat, auto-dismount | 8 | 2 | 30 |

| VerboseLog | Log mount/dismount details to BepInEx console. For debugging only | false | - | - |

| DriverSideThresholdZ | Threshold for front/back detection (Scout local Z). localZ > value = front (vanilla) / localZ 此值 = 車前部（走原版）/ localZ <= 此值 = 車後部（變乘客） | -0.2 | -3 | 3 |

| 吸力強度 | Weak = 平順、車不被推。Strong = 乘客快速貼緊座位但車會被推 | Weak | - | - |

進階

| 設定項 | 說明 | 預設 | 最小 | 最大 |

|---|---|---:|---:|---:|

| 啟用主機熱鍵 | 開啟後主機可用熱鍵強制把自己變乘客。給單人測試用 | false | - | - |

| 主機自我乘客切換鍵 | 主機按下此鍵 → 把附近最近的 Scout 當乘客車，自己上車/下車 | V | - | - |

| 主機自我乘客觸發距離 | 主機按熱鍵時，要在這距離內找到 Scout 才會生效（米） | 6 | 1 | 30 |

車尾偏移 / 車頭偏移

乘客 ragdoll 被拉到的位置（相對 Scout 本體 local 座標）。

| 設定項 | 說明 | 預設（車尾） | 預設（車頭） |

|---|---|---:|---:|

| X(左右) | local X 偏移（左右） | 0 | 0 |

| Y(上下) | local Y 偏移。正 = 上方 | 1 | 1 |

| Z(前後) | local Z 偏移。負通常 = 後方車尾、正 = 前方車頭 | -1 | 1 |

已知問題

• STRONG 模式車子會被乘客推開（位移過大）。 當 PullSt