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, could be any name but I guess it's now preffered to name as 'XX Name, where XX is the year.

isCar

Indicates that the vehicle is a car and it does have engine. Default value is 1. Must be set to 0 if you making trailer.

isCop

Indicates that this is a cop car.

allowParked

Allows this vehicle to be spawned at parking slots. Default value is 1.

allowMusic

Allows this vehicle to play in-car music. Default value is 1.

cleanModel

Location of the .egf model that the vehicle uses.

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.

reverseWarning

Enables reverse signal sound playing backwards gear is on. Default value is 0.

sirenSwitchable

When set to 0, makes cop AI to not switch sound of siren. Default is 1.

popupHeadlights

When enabled, it will try to check model for popupHeadlights and enable animation for it. Default is 0.

sounds

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

engine	Engine sound when the vehicle's accelerating (under load)
engine_low	Engine sound when the vehicle's not accelerating
engine_idle	Engine sound at idle RPM
reverse_signal	For warning sounds made by reversing trucks. Uses default sound if not set
brake_release	Sound for trucks releasing brakes. Not used if empty
siren	Siren sound for emergency vehicles. Not used if empty
horn	Horn sound

Each field takes a name of sound script entry.

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_angleX Pitch angle of the third person camera.

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. When not present it will not place driver model.
passenger1 ... passenger4	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 trailers (and other cars)

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

When set to 0 it will tell the game to not have any color. Deprecated and has no effect

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; 
};

See color maps on how to make single or dual-color vehicles.

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. Default is 1.5

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.
In kilometers per hour.

burnoutMaxSpeed

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

In kilometers per hour.

suspensionLift

Lowers and raises the vehicle's resting position on its suspension. Basically shifts Y value of SuspensionBottom for all wheels.

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	Steering multiplier (percentage) value. Can be negative. 1.0 makes wheel turn by 40 degrees when Fast Steer is on.
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
WheelBodyGroup	Alternate name of body group that is taken from wheelModel. Perfect for trucks with different front and back wheels.
BumpStopOfs	Cosmetic bump stop offset (for curb hit sound). Default is 0.6

See also

Creating Vehicle Models