CfgVehicles Config Reference

 armorBody = 0.4; // default
// for vehicles general
 armorStructural= 1; //ranges between 1 and 4.0, default 1
 armorFuel = 1.4;// default
 armorGlass = 0.5;// default
 armorLights = 0.4; // default 0.4 in all models.
 armorWheels = 0.05;//default
// for tanks
 armorHull = 1;
 armorTurret = 0.8;
 armorGun =    0.6;
 armorEngine = 0.8;
 armorTracks = 0.6;
// for men
 armorHead = 0.7;
 armorBody = 0.8;
 armorHands = 0.5;
 armorLegs = 0.5;
// helicopters
 armorHull = 0.5;
 armorEngine = 0.6;
 armorAvionics = 1.4;
 armorVRotor = 0.5;
 armorHRotor = 0.7;
 armorMissiles = 1.6;
 armorGlass = 0.5;

attendant

Bool: Default false

Used for 'vehicles' to repair other 'vehicles'. Thus a hospital has an attendant that can repair soldiers. Adds the action "Heal at XXX"

 attendant = true;

Related TokenNames: #hiddenSelections

audible

float: Default Value 1

 audible = .05; //man
 audible = 3;//motorcyle
 audible = 6;//tank/ship

how loud you are

see #camouflage

autocenter

bool: Default true

    autocenter = false; // man

axis

part of an Indicator.. class, or an IndicatorWatch class

see Indicator Class, IndicatorWatch Class

B

body

   body = "mainTurret";

part of any Turret class (tanks eg)

see #gun

brakeDistance

Float: default 5 meters per sec

   brakeDistance= 1; // man
  brakeDistance= 14; // tank
  brakeDistance= 500; //plane
  brakeDistance= 50;//boat

brightness

   brightness = 1.0;

part of #direction:LandVehicle.Reflectors class

C

...CanSee

Integer

Used on vehicles that have zoom.

 commanderCanSee = 31;//default
 gunnerCanSee = 4+8+16;//default
 driverCanSee = 2+8+16;//default

...CargoAngleY

new Integer degrees

 initCargoAngleY = 10;
 minCargoAngleY = -60;
 maxCargoAngleY = 120;

camouflage

Float: Default Value = 2.

how difficult to spot. bigger = easier

camouflage = 0.6; // snipers
camouflage = 1; // man
camouflage = 4; // trucks
camouflage = 8; // tanks

what is the relationship between this and #accuracy?

can...

canBeShot

new Boolean: Declares whether bullets have any effect

canBeShot = true;

canFloat

Boolean: Default value: false

Used to allow vehicles (such as BMP) not to sink !

 canFloat = true;

canLock

new Boolean:

canLock = 0;

cargoIsCoDriver

Variable Boolean Array : Default {false};

This token declares which (if any) cargo positions are 'in the front' (Ie front windscreen)

  cargoIsCoDriver[] = {true,true,false};// 1st two passenger positions for a 5T truck

The number of elements in this array correspond to the #transportSoldier value declared for this class model.

cast...Shadow

Boolean: Default false

castCargoShadow = false;
castCommanderShadow = false; 
castDriverShadow = false;
castGunnerShadow = true;

Normally used to shadow 'soldiers' standing up in vehicle objects, such as the MG Jeep and Machine Guns.

cloud...

new Various(Strings,Floats,Arrays)

cloud.. TokenNames are used inside the Smoke class of animation classes

  cloudletDuration = 0.900000;
  cloudletAnimPeriod = 1.000000;
  cloudletSize = 0.100000;
  cloudletAlpha = 0.800000;
  cloudletGrowUp = 0.400000;
  cloudletFadeIn = 0.000000;
  cloudletFadeOut = 5.000000;
  cloudletAccY = -0.100000;
  cloudletMinYSpeed = 0.300000;
  cloudletMaxYSpeed = 1.500000;
  cloudletShape = "\ca\data\cl_basic";
  cloudletColor[] = {1,1,1,0};

cobraLight

new String : Used as a core model for all other 'air' craft.

cobraLight = "AnyAddon\AnyP3d(.p3d)";

coefInside...

see #direction:LandVehicle.Reflectors class

 coefInside = 0.5;
 coefInsideHeur = 0.8;

color

Float Array: of floats. Used by reflectors

  color[] = {0.800000,0.800000,1.000000,1.000000};

commanding

new Integer: part of Turret class

    commanding = -1;

cost

Integer: Default Value 50,0000

This value reflects the attractiveness of the target to the enemy AI. When all other considerations are equal. A soldier eg is not interested in Air, despite it's highly attractive cost values. On the other hand, he is interested in a medic, since a medic (in normal configs) has a (while small) a higher cost, than others in the group, including the officer.

cost = 10000000;// an air vehicle is typically this value
cost = 8; // a medic;
cost = 1; // a grunt
cost = 4; // an officer
cost = 0; // most buildings;

Related TokenNames: type , #cost , #threat

count (string)

new String: (math formula). Used in magazine class to declare amount (of bullets)

count = "30*1";

crew

String: Default Civilian

Reflects whether vehicle is manned, and what with.

  crew = <ClassName>
  crew = "SoldierWPilot";

'SoldierWPilot' is a class declared in same file.

D

dammage...

Variable String Array:

 dammageHalf[] = {"\AnyAddon\AnyPAA.paa","\AnyAddon\AnyOtherPAA.paa", ...};
 dammageFull[] = {"\AnyAddon\AnyPAA.paa","\AnyAddon\AnyOtherPAA.paa", ...};

When 'vehicle' is considered at least half way to destruction, the series of pictures is applied to the model.

damper...

damperSize = 0.1;// default
damperForce = 3;//default

destrType

String: Default Value= DestructDefault

Used for animation, sound, and final 'look' of vehicle.

This was an integer value prior to Elite

 destrType = "DestructNo"; // nothing happens
 destrType = "DestructBuilding"; // smoke. explosion
 destrType = "DestructEngine"; // smoke only
 destrType = "DestructTree"; // smoke, crushing, falls over
 destrType = "DestructTent"; // smoke, crushing, flattens
 destrType = "DestructMan";  
 destrType = "DestructDefault"; // =building

Tent and Tree are no longer identifiable when destroyed if not class 'things'

disappearAtContact

old

direction

string:

   direction = "konec L svetla";

part of LandVehicle.Reflectors class

  LandVehicle.Reflectors {
   color[] = {0.900000,0.800000,0.800000,1.000000};
   ambient[] = {0.100000,0.100000,0.100000,1.000000};
   position = L svetlo;
   direction = konec L svetla;
   hitpoint = L svetlo;
   selection = L svetlo;
   size = 0.500000;
   brightness = 0.250000;
  };

displayName

String: Default value = "Unknown" or "Vehicle"

Selects object uniquely in the Mission Editor, and separately, is used to identify object in game according to #accuracy. For instance when pointing your men to an object while in a mission, it is this displayName that is used.

It is good practice to use a stringtable.csv that should accompany your addon so that

All names and labels are in one place instead of hunting for them.
For language differences

displayName = "$STR_DN_AH1Z";

Note, that will careful crafting of classes, different colored 'rocks' can all be called the same displayName (rock) in the mission itself. See #scope and #accuracy for details.

See #nameSound for definition of what is actually 'said'

displayNameShort

new String:

 displayNameShort = "$STR_DN_UH60";

deltaT

Integer: This TokenName is used inside the Smoke class of animation classes

   deltaT = -500;

density

new Float: This TokenName is used inside the Smoke class of animation classes

  density = 0.5;

driverIsCommander

Bool : Default false.

driverIsCommander = true;

For boat, MG Jeep and helicopters

see #has...

driverForceOptics

new Bool

  driverForceOptics = true;

E

...Elev

Integers:Degrees

initElev = -80;
minElev = -60;
maxElev = 10;

part of any Turret class (tanks eg)

see#gun

ejectDamageLimit

new Float: You can get hurt, but you can't die with vals less than 1.0

 ejectDamageLimit = 0.750000;

ejectDead...

Boolean : Default false

 ejectDeadGunner = false;
 ejectDeadCargo = false;
 ejectDeadDriver = false;
 ejectDeadCommander = false;

Causes that unit to 'unmount' the vehicle. Such as an MG nest, or motorcycle.

ejectSpeed

new Array

ejectSpeed[] = {0,0,0};

enableSweep

new Boolean:

 enableSweep = false;

envelope

new Float Array

envelope[] = {0.000000,0.000000,0.300000,1.000000,2.500000,3.300000,3.500000,3.200000,2.500000,2.000000,1.500000,1.000000};

elevatorSensitivity

new Float

elevatorSensitivity = 0.2;

extCameraPosition[]

float Array: Default {0,2,-20};

extCameraPosition[] = {0,5,-30};//plane
extCameraPosition[] = {0,1,-10};//cars
extCameraPosition[] = {0,1.500000,-9};//tankls
extCameraPosition[] = {0,0.300000,-3.500000};//man

F

minFireTime

Integer: Default 20 seconds

  minFireTime = 20;

fired

new String: Event Handler

fired = "_this exec ""\AnyAddon\AnySQS.sqs"""; // note the ""

flapsFrictionCoef

new Integer

 flapsFrictionCoef = 2;

forceHide...

Boolean : Default false;

forceHideDriver = true;//shilka
forceHideGunner = true; //tank
forceHideCommander=true;

formation...

Integer:

formationX = 10;// default meters
formationZ = 20; // default meters
formationTime = 10; // default seconds

One or both X Z values are used to keep objects separated (in meters) depending on wedge, echelon, V,single line, fomations.

fov

Float

 fov = 0.500000;

...Fov

Float

used by the car.ViewPilot Class

see #...AngleX/Y

fuelCapacity

Integer: Default Value 0 (litres)

 fuelCapacity = 50; // motorcyle
 fuelCapacity = 100; // car
 fuelCapacity = 700; // tank
 fuelCapacity = 1000; // air

G

gearRetracting

 gearRetracting = 1;

gun

Part of any Turret class (Tanks eg)

 class TurretBase {
  gunAxis = OsaHlavne;
  turretAxis = OsaVeze;
  soundServo[] = {Vehicles\gun_elevate,0.031623,1.000000};
  gunBeg = usti hlavne;
  gunEnd = konec hlavne;
  minElev = -4;
  maxElev = 20;
  minTurn = -360;
  maxTurn = 360;
  body = OtocVez;
  gun = OtocHlaven;
 };

gunAimDown

new Float

 gunAimDown = 0.07;

gunAxis

gunBeg

gunEnd

part of any Turret class (tanks eg)

see#gun

gunnerHasFlares

new Boolean

  gunnerHasFlares = false;

...GunnerMayFire

Boolean: Default false

     outGunnerMayFire = true;// m113
     inGunnerMayFire = false;

gunnerName

new String

   gunnerName = "$STR_POSITION_CREWCHIEF";

gunnerOutOptics...

new String

     gunnerOutOpticsModel = "";

Array

     gunnerOutOpticsColor[] = {0,0,0,1};

     gunnerOutForceOptics = false;

     gunnerOutOpticsShowCursor = false;

H

...Height

new Integer:

minHeight = 5; //Min height in metres above sealevel. 
maxHeight = 50;//max height above sea level.
avgHeight = 10;

has...

Bool:

 hasDriver = true; // default
 hasGunner = false;// default
 hasCommander =true; // default

Depending on vehicle model.

Controls the 'get in' commands.

see #driverIsCommander

hiddenSelections

String Array: Default none.

This array is used for soldiers (eg) to heal (eg) when they come close to a medic. It is a preferential way of dealing with Actions. Ie hide them, rather than disable them.

hiddenSelections[] = {"pruh"}; // bmp/tank
hiddenSelections[] = {ammo}; // trucks
hiddenSelections[] = {medic}; // soldiers

Note that "ammo", "pruh" and "medic" are GROUP Actions. They can define more than one action.

pruh for instance allows getting in several positions of the vehicle.

'medic' not only allows healing.

Because this is an array, multiple and different group actions, are possible.

Related TokenNames: #attendant

hide...

Bool

hideProxyInCombat = false; //default (true for tanks)
hideUnitInfo = false;// default see #unitInfoType
hideWeaponsCargo = false;// default
hideWeaponsCommander =  true;// default
hideWeaponsDriver = true;// default
hideWeaponsGunner =  true;// default

hitpoint

   hitpoint = "L svetlo";

part of #direction:LandVehicle.Reflectors class

hour

part of the IndicatorWatch class

 class IndicatorWatch {
  hour = hodinova;
  minute = minutova;
  axis = osa_time;
  reversed = 0;
 };

I

icon

String: Default Value = "unknown_object.paa"

This value us used by the map editor to show the building or vehicle when editing. It is not normally visible during game play. (but can be)

The icon can be any jpg, paa, or pac file. paa is default. Note that Elite cannot handle jpegs.

 icon = "\AnyAddon\AnyPAA(.paa)";

Related TokenName(s): #mapSize

in

new Float: This TokenName is used inside the Smoke class of animation classes

  in= 0.0;

see #out

init

String: Event Handler

  init = "[(_this select 0)] exec ""\AnyAddon\AnySqs.sqs"""; // note the ""

initT

new Integer: This TokenName is used inside the Smoke class of animation classes

   initT = 1000;

initYSpeed

new Float: This TokenName is used inside the Smoke class of animation classes

   initYSpeed = 1.7;

insideSoundCoef

Float: default 0.5

 insideSoundCoef = 0.05;// air vehicels are 2%

interval

new Float: This TokenName is used inside the Smoke class of animation classes

     interval = 0.010000;

irScanGround

Bool: Default true.

Probaly used to stop ai looking down

 irScanGround = false; // tanks

irScanRange...

Integer: Default 0

 irScanRange = 4000; // outdated (since Resistance)
 irScanRangeMin = 500;  // tanks general
 irScanRangeMax = 4000;
 irScanRangeMin = 2000; // air
 irScanRangeMax = 10000;
 irScanRangeMin = 4000; // a vulcan
 irScanRangeMax = 10000;

irScanToEyeFactor

Integer: Default 1

 irScanToEyeFactor = 2;//air
 irScanToEyeFactor = 5;//shilka

irTarget

Bool: Default true.

Used for (some) buildings so that they don't show up on tank radar

 irTarget = false; // man

isBicycle

Bool: Default false.

this value inside the motorcycle class is used to turn it on when inherting to a real bucycle

isMan

Bool: Default true.

 isMan = 1;

Defined within the man class

K

killed

new String: Event Handler

  killed = "[(_this select 0),1,1,0,0] exec ""\AnyAddon\AnySQS.sqs""";// note the ""

L

ladders

Embedded Array: The ladders array is used to declare one or more ladder pairs inside the model.

ladders[] = { {"start","end" } }; // a building wiht one ladder
ladders[] = { {"start1","end1" } , {"start2","end2" } };// two ladder building
                   //etc

Note that unfortunately, the 'start' and 'end' labels are arbitrary for each model. You cannot have a generic ladder building as such.

laser...

Boolean: Default false

Determines if a vehicle has laser capability.

 laserScanner = true;
 laserTarget = true;// used as a generic class of All {} to default things true

landingAoa

new String (math formula) Landing Angle of Approach

 landingAoa = "3.5*3.1415/180";

landingSpeed

new Integer

 landingSpeed = 75;

library

new String: This TokenName is associated with the library class of a vehicle (if any). It is used to give a 'memo' style full screen info on the given object. Example of use:

 class Library
 {
  libTextDesc = "$STR_LIB_AH1Z";
 };

M

magazine

Array: used in TransportMagazines class this specifies the type of ammo in the magazine and the amount.

{
magazine = "30Rnd_556x45_Stanag";
count = "30*1";
}

Each of these couplets are contained within a 'weapon' classname within the magazine class itself. Example

class TransportMagazines  {
  class _xx_M16 {
   magazine = M16;
   count = 30*1;
  };
  class _xx_M60 {
   ......
  };
  class _xx_PK {
   ......
  };
  ...
};

magazines

Variable string Array: default {}

see #weapons for proper description

mainRotorSpeed

new Integer:

mainRotorSpeed = -1;

backRotorSpeed

new Float backRotorSpeed = 1.0;

hmmm, that's curious, it accepts floats or ints.

mapSize

Float: Default Value = 10 (meters).

Used for the map editor to show the icon associated with this model class.

There is no x y component to this, the meaurement units are meters.

To creat a circular, rectangular or other 'non sqaure' image, you need to make a pac file for the icon with, a transparent layer.

 mapSize = 0.7; // small object such as a tree
 mapSize = 4; // a small'ish building

The Mission Editor map is not very good in this regard (as noted above). However, the main problem is the base classes of the engine. The mapSize= for most objects, particularly buildings, is a one shoe fits all. A forest, eg, is the same mapSize= as a tree !!!

Later Oem addons, *generally* are better and more specific in this regard, making position and fitting a little easier.

marker

new String : used as a core for all other air craft when looking on map.

marker = "\AnyAddon\AnyP3d.(p3d")";

material

Integer:

Used in Hit... classes, eg HitTurret HitBody

  material = 50;

Related TokenNames: #armor (float), #material, #name, #passThrough

maxT

new Integer: This TokenName is used inside the Smoke class of animation classes

   maxT = 0;

min/max

part of an Indicator.. class

see #selection

memoryPointExhaust...

new String:

memoryPointExhaust = "exhaust_start";
memoryPointExhaustDir = "exhaust_end";

memoryPointGun

new String:

   memoryPointGun = "machinegun";

memoryPointGunnerOptics

new String

   memoryPointGunnerOptics = "gunnerview";

memoryPointGunnerOutOptics

new String

     memoryPointGunnerOutOptics = "commander_weapon_view";

memoryPoint...Missile

new String:

   memoryPointLMissile = "Missile_1";
   memoryPointRMissile = "Missile_2";

memoryPoint...Rocket

new String:

   memoryPointLRocket = "Rocket_1";
   memoryPointRRocket = "Rocket_2";

memoryPointsGetIn...

new String:

   memoryPointsGetInCargo = "pos_cargo";
   memoryPointsGetInCoDriver = "pos_codriver";
   memoryPointsGetInCommander = "pos_commander";
   memoryPointsGetInDriver = "pos_driver";
   memoryPointsGetInGunner = "pos gunner";

memoryPointsGetIn...Dir

new String:

   memoryPointsGetInCargoDir = "pos_cargo_dir";
   memoryPointsGetInCoDriverDir = "pos_codriver_dir";
   memoryPointsGetInCommanderDir = "pos_commander_dir";
   memoryPointsGetInDriverDir = "pos_driver_dir";
   memoryPointsGetInGunnerDir = "pos gunner dir";

memoryPointSupply

new String:

 memoryPointSupply = "supply";

memoryPointTrack...

new String:

 memoryPointTrackFLL = "tyreTrack_1_1l";
 memoryPointTrackFLR = "tyreTrack_1_1r";
 memoryPointTrackBLL = "tyreTrack_1_2l";
 memoryPointTrackBLR = "tyreTrack_1_2r";
 memoryPointTrackFRL = "tyreTrack_2_1l";
 memoryPointTrackFRR = "tyreTrack_2_1r";
 memoryPointTrackBRL = "tyreTrack_2_2l";
 memoryPointTrackBRR = "tyreTrack_2_2r";

minute

part of the IndicatorWatch class

see #hour

model

String: Default Value= "empty.p3d"

Location in the addon where the p3d model resides.

model = "\AddonName\anyp3d(.p3d)";

Whera a class is not a visible 'object', such as a BaseClass. You can specify

model="";

this cuts down on load and access.

Related TokenName: #simulation, #reversed

N

...NightLights...

 spotableNightLightsOff = 0.05; //default
 spotableNightLightsOn = 4;//default
  visibleNightLightsOff = 0.1; //default
 visibleNightLightsOn = 0.2;//default

name

  name = "motor";

Used in Hit... classes, eg HitTurret HitBody

Related TokenNames: #armor (float), #material, #name, #passThrough

nameSound

String: Default value: "Target"

Namesound is used by the AI audio to indicate verbally where to go, what 'vehicle' to attack. Thus the audio speech "move to 'rock' 3 o'clock' is derived from the nameSound.

nameSound = "rock";

Many different nameSounds can be selected. Here are just a few.

 nameSound = crew;
 nameSound = target; 
 nameSound = tank;
 nameSound = house;

The actual descriptive text accompanying the 'sound' can be different see #displayName

Typically, a collection of buildings (eg) will be configured as follows

class GenBuilding : NonStrategic
{
  scope=private; // internal use only
  VehicleClass="Some Editor Group Name";
  namesound="house";
};
class YellowBuilding: GenBuilding
{
  scope=public;
  name="YellowBuilding";
  model="Some yellow building.p3d";
};

nightVision

Bool: Default false

nightVision=true;

present in lawsoldier, sniper, saboteur, tank, and air crew

noseDownCoef

new Float

noseDownCoef = 0.025;

O

...OpticsColor

Float Array : Default {0,0,0,1};

 driverOpticsColor[] = {0,0,0,1};
 gunnerOpticsColor[] =    {0.910000,0.230000,0.230000,1};
 commanderOpticsColor[] = {0.910000,0.230000,0.230000,1};

...OpticsModel

String: Default ""

 commanderOpticsModel= "\AnyPbo\AnyP3d(.p3d)";
 driverOpticsModel = "\AnyPbo\AnyP3d(.p3d)";
 gunnerOpticsModel= "\AnyPbo\AnyP3d(.p3d)";

gunnerOpticsShowCursor

Bool

gunnerOpticsShowCursor = true;

out

Float: This TokenName is used inside the Smoke class of animation classes

  out= 0.0;

see #in

P

passThrough

Bool: Default true

 passThrough = 1;

Used in Hit... classes, eg HitTurret HitBody

Related TokenNames: #armor (float), #material, #name, #passThrough

picture

String: Default: iaston.paa

I think this is for briefing Information icon click

 picture = "\AnyAddon\AnyPAA(.paa)";

position

String: This TokenName is used inside the Light class of animation classes

  position = "ohniste";

  position = "L svetlo";

part of #direction:LandVehicle.Reflectors class

precision

 precision = 1; //man
 precision = 200;// air
 precision = 50;//boat

preferRoads

Bool: Default false

preferRoads = true; // all vehicles

primary

Boolean: For models that can have, (but don't necessarily do have) multiple internal objects of the same type (turrets eg). One of them, is declated the main, or primary turret. There may indeed be only one 'turret'.

  primary = true;

primary...

     primaryGunner = false;
     primaryObserver = true;

proxyIndex

Integer

   proxyIndex = 2;

proxyType

String

     proxyType = "CPCommander";

R

...Radius

Represents a circular area (radius in meters from centre of object for action to take place

getInRadius=2.5;  //default
getInRadius=3.5;   // tank
getInRadius=10;  //ship
supplyRadius = 2.5; // for fuel dumps ammo trucks etc

rotL

rotR

defined within a tank.Wheels class to describe the series of small wheels on each side

  rotR[] = {kolL1,kolL2,kolL3,kolL4,kolL5,kolL6,kolL7,kolL8};
  rotL[] = {kolP1,kolP2,kolP3,kolP4,kolP5,kolP6,kolP7,kolP8};
  upDownL[] = {koloP1,podkoloP1,koloP2,podkoloP2,koloP3,podkoloP3,koloP4,podkoloP4,koloP5,podkoloP5,koloP6,podkoloP6,koloP7,podkoloP7,koloP8,podkoloP8};
  upDownR[] = {koloL1,podkoloL1,koloL2,podkoloL2,koloL3,podkoloL3,koloL4,podkoloL4,koloL5,podkoloL5,koloL6,podkoloL6,koloL7,podkoloL7,koloL8,podkoloL8};

reversed

Boolean: Default true

Normally, models ARE reversed with respect to how they present on the screen after editing with tools like oxygen (eg) This overrides the default. See #model

reversed = false; // class thing

rotor...