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 This value = front of the car (take the original version) / localZ <= this value = rear of the car (change to passenger) | -0.2 | -3 | 3 |

| Suction strength | Weak = smooth, the car will not be pushed. Strong = Passengers quickly press against the seat but the car will be pushed | Weak | - | - |

Advanced

| Settings | Description | Default | Minimum | Maximum |

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

| Enable host hotkeys | After enabling, the host can use hotkeys to force itself to become a passenger. For single-person testing | false | - | - |

| Host self-passenger switch key | Host presses this button → Treat the nearest Scout as …