# Transporter

Transporter lets players load horses, snowmobiles, and bikes into Scrap Transport Helicopters, making it easy to move vehicles around the map by air.

Features

* Mount horses, snowmobiles, and bikes inside Scrap Transport Helicopters
* Supports up to a configurable number of vehicles per helicopter
* In-game CUI interface for mounting and dismounting
* Automatically detects vehicles at the rear of the helicopter
* Prevents mounting and dismounting while the helicopter engine is running
* Automatically restores vehicle physics when unloaded
* Safely ejects transported vehicles if the helicopter is destroyed
* Automatically finds safe ground positions when vehicles are unloaded
* Optional automatic remount of the player after dismounting
* Configurable mount and dismount positioning
* Configurable CUI text, size, position, and icon
* Optional hidden mount trigger
* Boost mode for increased helicopter thrust
* Handbrake mode for securing the helicopter while landed
* Persistent transport data with cleanup after restarts
* Supports horses, snowmobiles, and bikes
* Bikes with sidecars are not supported

Permissions

Transporter.Mount

Allows players to mount and dismount vehicles using the transport helicopter.

Transporter.Brake

Allows players to use the handbrake mode.

Transporter.Boost

Allows players to use boost mode.

Usage

Ride a supported vehicle up to the rear of a Scrap Transport Helicopter.

When within range, the Transporter CUI will appear with Mount and Dismount options.

Mounting

1. Ride a horse, snowmobile, or bike to the rear of the helicopter.
2. Enter the trigger area.
3. Select Mount from the CUI.
4. The vehicle will be positioned and attached to the helicopter.

Dismounting

1. Approach the rear of the helicopter while riding the transported vehicle.
2. The CUI will appear.
3. Select Dismount.
4. The vehicle will be safely placed on the ground behind the helicopter.

Vehicles cannot normally be mounted or dismounted while the helicopter engine is running.

Helicopter Controls

Handbrake

While the helicopter is landed:

Hold E to toggle the handbrake.

The handbrake locks the helicopter's position until disabled.

Requires:

Transporter.Brake

Boost

While flying:

Hold Shift to toggle boost mode.

Boost increases the helicopter's thrust and fuel consumption according to the configuration.

Requires:

Transporter.Boost

Configuration

The plugin provides configuration options for:

* Boost speed/fuel multiplier
* Maximum vehicles allowed in each helicopter
* Automatically remounting players
* Blocking mounting while the engine is running
* Blocking dismounting while the engine is running
* Mount trigger size
* Hiding the mount trigger
* Mount positioning offsets
* Dismount distance
* CUI cursor behaviour
* CUI text and font sizes
* CUI position
* CUI icon Skin ID

Example:

{
  "Boost Speed/Fuel Multiplyer": 2,
  "Max Horses Allow In Back Of Transport Helicopter": 2,
  "Mount Player To Horse On Horse Dismount Heli": false,
  "Block Dismount While Helicopter Engine On": true,
  "Block Mount While Helicopter Engine On": true,
  "Mount Trigger Size": 1.6,
  "Hide Mount Trigger Sphere": true,
  "Mount Forward Offset": 0.3,
  "Mount Up Offset": 0.9,
  "Mount Right Offset": 0.5,
  "Dismount Forward Offset": 5.0
}

Additional CUI settings are available in the generated configuration file.

Notes

* A maximum vehicle count can be configured per helicopter.
* Vehicles are temporarily modified while being transported so they remain stable inside the helicopter.
* Their original physics settings are restored when they are unloaded.
* Transported vehicles are automatically ejected if their helicopter is destroyed.
* The plugin cleans up transport data after dirty shutdowns.
* Bikes equipped with sidecars cannot be transported.

Transporter