The Driver Syndicate/Vehicles/Configuration File

Vehicle configuration scripts contain the names and handling properties of vehicles for the Driver Syndicate

Vehicle scripts are loaded from scripts/vehicles/

Fields

name

Name of the vehicle, generally in 'XX Name, where XX is the year.

name	"'74 Rollo";

cleanmodel

Location of the .egf model that the vehicle uses.

cleanmodel	"models/vehicles/rollo.egf";

damagedmodel

Location of the .egf model the vehicle becomes when damaged. If none is present, the vehicle won't show damage.

wheelmodel

Location of the .egf model for the wheel models
If none is present, uses "models/vehicles/wheel.egf";

wheelBodyGroup

Names of the bodygroups to be used.
Bodygroups come from the wheelmodel.
wheelBodyGroup "wheel"; for no hubcaps.
wheelBodyGroup "wheelUnhubbed" "wheelHubbed" "hubcap"; for hubcaps that can fall off.

sounds

An array for the sounds a vehicle will use. Available fields are:

engine	Engine sound when the vehicle's accelerating
engine_low	Engine sound when the vehicle's not accelerating
engine_idle	Engine sound for stopped vehicles
reverse_signal	For warning sounds made by reversing trucks
brake_release	Sound for trucks releasing brakes
siren	Siren sound for emergency vehicles
horn	Horn sound

Camera

camera_height How high the third person camera is from the center of the vehicle.
camera_distance How far back the third person camera is from the center of the vehicle.
camera_height_in How high the bumper camera is from the center of the vehicle.
camera_distance_in How far forwards the bumper camera is from the center of the vehicle.
camera_side_in How far forwards the bumper camera is from the center of the vehicle when looking sideways.

visuals

An array to create the locations and properties of lights, occupants and engine/exhaust.

visuals
{
	headlights 	    1 0.66 0.08 2.10 0.1;
	brakelights 	0 0.78 0.18 -2.25 0.09;

	frontdimlights	0.9 0.07 1.90 0.1;
	backdimlights	0.8 0.05 -2.30 0.09;

	backlights 	    0.76 0.03 -2.31 0.09;

	engine          0.0 0.1 2.1;
	exhaust         0.4 -0.22 -2.2 2 1;

	driver          -0.35 0.15 -0.02;
	passenger1      0.35 0.15 -0.02;
	siren_lights    5 0.4 0.66 -0.32 0.11;
};

headlights	Vehicle headlights, first number tells split, 0 for single, 1 for horizontal, 2 for vertical. Second, third and fourth numbers tell the X, Y and Z coordinates of the light, fifth number tells the split distance.
brakelights	Vehicle brakelights, uses 5 numbers like headlights.
frontdimlights	Front turn signals, three numbers tell the X, Y and Z coordinates.
backdimlights	Back turn signals, three numbers tell the X, Y and Z coordinates.
backlights	Reverse lights, three numbers tell the X, Y and Z coordinates.
engine	Where the engine smoke originates from a damaged vehicle.
exhaust	Where the exhaust smoke originates from, first, second and third numbers tell the X, Y and Z coordinates, fourth number is for the smoke's direction, 0 for left, 1 for up, 2 for back, fifth number is for mirrored exhausts.
driver	Position for the driver, first, second and third numbers tell the X, Y and Z coordinates.
passenger1	Position for the first passenger, first, second and third numbers tell the X, Y and Z coordinates. Up to 4 passengers can appear in one vehicle.
siren_lights	Emergency lights for the vehicle, first number is type, 1 for single blue, 2 for single red, 3 for mirrored blue, 4 for mirrored red, 5 for red and blue Second, third and fourth numbers tell the X, Y and Z coordinates of the lights, fifth number denotes the width. You can add up to 4 siren_lights entries.

hingePoints

Hinge points of a vehicle used for towing.

front	Three numbers for the X, Y and Z coordinates at the front bumper of the vehicle for others to tow it, mostly used for trailers.
back	Three numbers for the X, Y and Z coordinates at the back bumper for a vehicle to tow other vehicles.

useBodyColor

Use 0 if a vehicle doesn't use a colormap to define its colored zones.

colors

An array for the colors a vehicle can appear in.
The four digits for colors are Red, Green, Blue and Reflection Strength
Colors can be either a float from 0 to 1, or an integer from 0 to 255.

For single colors:

"Green" 0.47 0.6 0.24 1.0;

For dual colors:

"White and Red" 
{ 
    1 0.96 0.96 0.96 1.0; 
    2 0.35 0.18 0.15 0.5; 
};

bodysize

The vehicle's size. Used for 2D shadows, detecting water collision, and AI detection.^maybe
These numbers are based on the center of the vehicle, so they'll be half of its real dimensions.
There are three digits which represent its Width, Height and Length

center

The vehicle's offset from the center.

gravitycenter

The vehicle's center of gravity.

mass

The vehicle's mass. Not in KG or pounds.

inertiaScale

The vehicle's resistance to rotation, whether it be from steering or collisions.

antiroll

The vehicle's resistance to rolling, similar to a sway bar.

noseDownScale

Makes the vehicle pitch forwards when it jumps.

downForce

Makes the vehicle gain downwards momentum when driving.

engineType

Engine type, 0 = petrol, 1 = diesel, this will affect the acceleration curves.

gears

Gear ratios for the vehicle, lower = faster. First gear is reverse.

shiftAccelFactor

Percentage of acceleration a vehicle has during gear shifts, from 0 to 1.

differential

Final gear ratio, affects all gears.

transmissionrate

Affect's engine's power. ^somehow

torquemultipler

The engine's power.

maxspeed

The speed where a vehicle's power diminishes.

burnoutMaxSpeed

The velocity where a vehicle's burnout is no longer effective.

suspensionLift

Lowers and raises the vehicle's resting position on its suspension.

steerspeed

How fast a vehicle reaches full steering lock.
1 is default.

handbrakeScale

How much the handbrake makes the wheels slide.
1 is default.

wheels

An array for containing wheels, their coordinates, size, and other properties. Each wheel is its own array with the following:

SuspensionTop	The top of the suspension's coordinates, 3 numbers for X, Y and Z.
SuspensionBottom	The bottom of the suspension's coordinates, 3 numbers for X, Y and Z.
SuspensionSpringConstant	Suspension spring strength.
SuspensionDampingConstant	Suspension damping.
Radius	Wheel's radius.
Width	Wheel's width, affects its contact point.
CamberAngle	Camber angle of the wheel, positive values point the outside down.
BrakeTorque	Brake strength of the wheel.
Steer	Float for how much the wheel turn.
Drive	Whether or not the wheel's a drive wheel
Handbrake	Whether or not the wheel's affected by the handbrake Handbrake strength is also affected by BrakeTorque