CfgMoves Config Reference: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (→‎F: compacted "fast..")
 
(39 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{Stub}}
{{ConfigPage|start}}
== Introduction ==
'''''cfgMoves''''' is the nerve center of all skeletal character animation. The animation of human characters that is - not the simple, procedural animation of objects (''e.g.'' raising/lowering a barrier, opening/closing of an aircraft canopy).


=Introduction=
''cfgMoves'' has two major sections: ''Actions'' and ''States''.


CfgMoves is the nerve center of all skeletal character animation. The animation of human characters that is - not the simple, procedural animation of objects (e.g. raising/lowering a barrier, opening/closing of an aircraft canopy).
=== Actions ===
CfgMoves has two major sections: ''Actions'' and ''States''.
It is where the character animation {{Link|https://en.wikipedia.org/wiki/State_machine|state machine}} is set up. It's a bit confusing that {{Name|bi|short}} called the animation state handler "''Actions''", and the actions are called "''States''", but this is what it is.
===Actions===
It is where the character animation [http://en.wikipedia.org/wiki/State_machine state machine] is set up. It's a bit confusing that BIS called the animation state handler "Actions", and the actions are called "States", but this is what it is. What this thing does, is configure all the possible animation states (e.g. standing upright with a rifle, kneeling with a pistol, parachuting), and define for each of them which animations can be played in and from that given state. For instance, from the kneeling with a pistol state (PistolKneelActions), you cannot directly go into crawling forward on your stomach with a rifle (even if you have a rifle). First you would have to holster the pistol and grab your rifle, then lie down, or viceversa. Similarly, if you're prone (whether unarmed, or armed with a pistol or rifle), you cannot salute - first you'd have to stand up. What animation can or cannot be played, in what situation, is set up here in ''Actions''. Player input (key presses, clicks) are then directed to this state machine, which interprets them and decides what action/animation the avatar will perform next, according to these rules. Same rules apply to AI players.
===States===
In this section, each animation file ([[RTM]]) has a corresponding entry. Animation properties, such as playback speed, interpolation rules, blending times, collision shapes to use during animation, etc.., are configured here. These animations are the ones referenced in the ''Actions'' section above. While ''Actions'' represents a complex graph, ''States'' is more like a list of items, even though some rules are also set up here (see the ''ConnectTo[]'' and ''InterpolateTo[]'' properties).


''CfgGestures'' is similar to ''States'', it holds the bone-masked or layered animations introduced in ArmAII. Welcome to reloading-while-running.
What this thing does, is configure all the possible animation states (''e.g.'' standing upright with a rifle, kneeling with a pistol, parachuting), and define for each of them which animations can be played in and from that given state.


=A=
For instance, from the kneeling with a pistol state (''PistolKneelActions''), you cannot directly go into crawling forward on your stomach with a rifle (even if you have a rifle). First you would have to holster the pistol and grab your rifle, then lie down, or viceversa. Similarly, if you're prone (whether unarmed, or armed with a pistol or rifle), you cannot salute - first you'd have to stand up.


==access==
What animation can or cannot be played, in what situation, is set up here in ''Actions''. Player input (key presses, clicks) are then directed to this state machine, which interprets them and decides what action/animation the avatar will perform next, according to these rules. Same rules apply to ''AI'' players.
[[TokenNameValueTypes|Integer]]<br>
'''Description:''' See [[CfgVehicles_Config_Reference#access]]


access = 3;
=== States ===
In this section, each animation file (''[[RTM]]'') has a corresponding entry. Animation properties, such as playback speed, interpolation rules, blending times, collision shapes to use during animation, etc.., are configured here.


==actions==
These animations are the ones referenced in the ''Actions'' section above. While ''Actions'' represents a complex graph, ''States'' is more like a list of items, even though some rules are also set up here (see the ''ConnectTo[]'' and ''InterpolateTo[]'' properties).
[[TokenNameValueTypes|String]]<br>
'''Description:''' Sets the action class/group to which this state belongs to.


actions = "PistolStandActionsRunR";
'''''cfgGestures''''' is similar to ''States'', it holds the bone-masked or layered animations introduced in {{Name|arma2|short}}. Welcome to reloading-while-running.
actions = "RifleStandActions";
actions = "InjuredManActionsnon_norot";
actions = "SitActions";


==aiming==
=== Namespace of anim classes and files ===
[[TokenNameValueTypes|String]]<br>
{{hl|A...P...M...S...W...D[_A...P...M...S...W...D][_Comment]}}
'''Description:''' This property references ''BlendAnims'' class entries to use when aiming up/down. These are sets of ''named selections'', with weights associated to them, defining how much should the bodyparts move while aiming.
Notice how for instance ''aimingDefault[]'' sets up increasing weights for bones: Spine (0.3), Spine1 (0.4), Spine2 (0.5), Spine3/Head/Neck (0.6}, Shoulders/Upper Arms (0.8) and finally 1 for forearms, hands and weapons. This makes for a smooth arching of the body while aiming.


aiming = "empty";
'''A''': Description of the animation type, ''i.e.'': {{hl|mov}} for movement, {{hl|cts}} for cutscene
aiming = "aimingDefault";
aiming = "aimingNo";
aiming = "aimingCivil";
aiming = "aimingLying";
aiming = "aimingPistol";
aiming = "aimingLauncher";


==aimingDefault[]==
'''P''': Stance: {{hl|erc}} for erected, {{hl|knl}} for kneel, {{hl|pne}} for prone
[[TokenNameValueTypes|Array]]<br>
'''Description:''' BlendAnims array, see [[CfgMoves_Config_Reference#aiming]] above.


aimingDefault[] = {"head", 0.6, "neck1", 0.6, "neck", 0.6, "weapon", 1, "launcher", 1, "LeftShoulder", 0.8, "LeftArm", 0.8, "LeftArmRoll", 1, "LeftForeArm", 1, "LeftForeArmRoll", 1, "LeftHand", 1, "LeftHandRing", 1, "LeftHandPinky1", 1, "LeftHandPinky2", 1, "LeftHandPinky3", 1, "LeftHandRing1", 1, "LeftHandRing2", 1, "LeftHandRing3", 1, "LeftHandMiddle1", 1, "LeftHandMiddle2", 1, "LeftHandMiddle3", 1, "LeftHandIndex1", 1, "LeftHandIndex2", 1, "LeftHandIndex3", 1, "LeftHandThumb1", 1, "LeftHandThumb2", 1, "LeftHandThumb3", 1, "RightShoulder", 0.8, "RightArm", 0.8, "RightArmRoll", 1, "RightForeArm", 1, "RightForeArmRoll", 1, "RightHand", 1, "RightHandRing", 1, "RightHandPinky1", 1, "RightHandPinky2", 1, "RightHandPinky3", 1, "RightHandRing1", 1, "RightHandRing2", 1, "RightHandRing3", 1, "RightHandMiddle1", 1, "RightHandMiddle2", 1, "RightHandMiddle3", 1, "RightHandIndex1", 1, "RightHandIndex2", 1, "RightHandIndex3", 1, "RightHandThumb1", 1, "RightHandThumb2", 1, "RightHandThumb3", 1, "Spine", 0.3, "Spine1", 0.4, "Spine2", 0.5, "Spine3", 0.6};
'''M''': Speed of animation: {{hl|stp}} for stopped, {{hl|wlk}} for walk, {{hl|run}} for running, {{hl|eva}} for evasive
aimingDefault[] = {};


==aimingNo[]==
'''S''': Weapon holding: {{hl|low}} for lowered, {{hl|ras}} for raised
[[TokenNameValueTypes|Array]]<br>
'''Description:''' BlendAnims array, see [[CfgMoves_Config_Reference#aiming]] above.
aimingNo[] = {};


==aimPrecision==
'''W''': Weapon: {{hl|non}} for unarmed, {{hl|pst}} for pistol, {{hl|lnr}} for launcher, {{hl|rfl}} for rifle.
[[TokenNameValueTypes|Float]]<br>
'''Description:''' Probably goes into accuracy calculations when firing a weapon; the higher the value, the less accurate aiming becomes. Wounded >1, firing upright animations are mostly 1, kneeling is 0.5, and prone values are even lower.
aimPrecision = 5;
aimPrecision = 2;
aimPrecision = 1;
aimPrecision = 0.5;
aimPrecision = 0.3;
aimPrecision = 0.15;


=B=
'''D''': Direction of movement: {{hl|non}} for no direction, {{hl|f}} for forward, etc.


==binocOff==
:If there is a second movement definition named {{hl|[_A...P...M...S...W...D]}} after the first one, the animation is a transition from the first animation to the second.
[[TokenNameValueTypes|String]]<br>
'''Description:''' Found in ''Actions'' together with binocOn. They define which state is used for bringing up and putting away binoculars.


binocOff = "";
{{hl|[_Comment]: additional comments}}, if required.
binocOff = "AmovPercMstpSrasWrflDnon";
binocOff = "AmovPknlMstpSrasWrflDnon";
binocOff = "AmovPercMstpSrasWrflDnon";
binocOff = "AmovPpneMstpSrasWrflDnon";


==binocOn==
Example: {{hl|'''A'''mov'''P'''pne'''M'''stp'''S'''non'''W'''non'''D'''non}} means: ''Movement - Prone - Stopped - civil (no weapon) - no direction (due to being static)''.
[[TokenNameValueTypes|String]]<br>
'''Description:'''  


binocOn = "";    //No binocs while lying on the ground injured
== Alphabetical Order ==
binocOn = "AwopPknlMstpSoptWbinDnon_rfl";
{{ConfigPage|abc}}
binocOn = "AwopPercMstpSoptWbinDnon_rfl";
=== A ===
binocOn = "AwopPknlMstpSoptWbinDnon_pst";
==== access ====
binocOn = "AwopPpneMstpSoptWbinDnon_rfl";
;Type: [[TokenNameValueTypes|Integer]]
;Description: See ''[[CfgVehicles_Config_Reference#access | access (CfgVehicles)]]''.


==boundingSphere==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Float / Boolean]]<br>
access = 3;
'''Description:''' Probably obsolescent, used for character collision detection. For more accurate collision models use ''collisionShape'' & Co. Still used in ArmAII for cutscene animations. Sphere collision probably much cheaper than anything else.
</syntaxhighlight>


boundingSphere = true;
==== actions ====
boundingSphere = 1;
;Type: [[TokenNameValueTypes|String]]
boundingSphere = 1.5;
;Description: Sets the action class/group to which this state belongs to.
boundingSphere = 8;
boundingSphere = 35;


=C=
<syntaxhighlight lang="cpp">
actions = "PistolStandActionsRunR";
actions = "RifleStandActions";
actions = "InjuredManActionsnon_norot";
actions = "SitActions";
</syntaxhighlight>


==CanNotMove==
==== aiming ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''Actions''.
;Description: This property references '''BlendAnims''' class entries to use when aiming up/down. These are sets of ''named selections'', with weights associated to them, defining how much should the bodyparts move while aiming.


CanNotMove = "AmovPpneMstpSrasWrflDnon";
Notice how for instance ''[[#aimingDefault.5B.5D | aimingDefault[] ]]'' sets up increasing weights for bones: Spine {{hl|(0.3)}}, Spine1 {{hl|(0.4)}}, Spine2 {{hl|(0.5)}}, Spine3/Head/Neck {{hl|(0.6)}}, shoulders and upper arms {{hl|(0.8)}} and finally forearms, hands and weapons {{hl|(1)}}. This makes for a smooth arching of the body while aiming.


==canPullTrigger==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
aiming = "empty";
'''Description:''' Self explanatory. While in that animation, the player can fire it's weapon, but his trigger finger will remain extended. The little "finger squeezing the trigger" animation won't play.
aiming = "aimingDefault";
aiming = "aimingNo";
aiming = "aimingCivil";
aiming = "aimingLying";
aiming = "aimingPistol";
aiming = "aimingLauncher";
</syntaxhighlight>


canPullTrigger = 1;
==== aimingDefault[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: ''BlendAnims'' array, see ''[[#aiming | aiming]]'' above.


==Civil==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
aimingDefault[] = {"head", 0.6, "neck1", 0.6, "neck", 0.6, "weapon", 1, "launcher", 1, "LeftShoulder", 0.8, "LeftArm", 0.8, "LeftArmRoll", 1,
'''Description:''' Found in ''Actions'', defines what happens to a soldier if he were to lose his weapons and become unarmed.
"LeftForeArm", 1, "LeftForeArmRoll", 1, "LeftHand", 1, "LeftHandRing", 1, "LeftHandPinky1", 1, "LeftHandPinky2", 1, "LeftHandPinky3", 1,
"LeftHandRing1", 1, "LeftHandRing2", 1, "LeftHandRing3", 1, "LeftHandMiddle1", 1, "LeftHandMiddle2", 1, "LeftHandMiddle3", 1, "LeftHandIndex1", 1,
"LeftHandIndex2", 1, "LeftHandIndex3", 1, "LeftHandThumb1", 1, "LeftHandThumb2", 1, "LeftHandThumb3", 1, "RightShoulder", 0.8, "RightArm", 0.8,
"RightArmRoll", 1, "RightForeArm", 1, "RightForeArmRoll", 1, "RightHand", 1, "RightHandRing", 1, "RightHandPinky1", 1, "RightHandPinky2", 1,
"RightHandPinky3", 1, "RightHandRing1", 1, "RightHandRing2", 1, "RightHandRing3", 1, "RightHandMiddle1", 1, "RightHandMiddle2", 1,
"RightHandMiddle3", 1, "RightHandIndex1", 1, "RightHandIndex2", 1, "RightHandIndex3", 1, "RightHandThumb1", 1, "RightHandThumb2", 1,
"RightHandThumb3", 1, "Spine", 0.3, "Spine1", 0.4, "Spine2", 0.5, "Spine3", 0.6};
aimingDefault[] = {};
</syntaxhighlight>


Civil = "AmovPercMstpSnonWnonDnon";
==== aimingNo[] ====
Civil = "AmovPercMstpSnonWnonDnon_gear";
;Type: [[TokenNameValueTypes|Array]]
;Description: ''BlendAnims'' array, see ''[[#aiming | aiming]]'' above.


==CivilLying==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
aimingNo[] = {};
'''Description:''' Found in ''Actions''.
</syntaxhighlight>


CivilLying = "AmovPpneMstpSnonWnonDnon";
==== aimPrecision ====
;Type: [[TokenNameValueTypes|Float]]
;Description: Probably goes into accuracy calculations when firing a weapon; the higher the value, the less accurate aiming becomes.


==collisionGeomCompPattern[]==
Wounded {{hl|&gt;1}}, firing upright animations are mostly {{hl|1}}, kneeling is {{hl|0.5}}, and prone values are even lower.
[[TokenNameValueTypes|Array]]<br>
'''Description:'''
<syntaxhighlight lang="cpp">
aimPrecision = 5; // Carrying a wounded soldier on your back
aimPrecision = 2; // Injured, cannot stand up
aimPrecision = 1; // Standing upright
aimPrecision = 0.5; // Crouched
aimPrecision = 0.3; // Prone
aimPrecision = 0.15; // Walking slowly while looking down the sights
</syntaxhighlight>


collisionGeomCompPattern[] = {1,3,6};
=== B ===
==== binocOff ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'' together with ''binocOn''. They define which state is used for bringing up and putting away binoculars.


==collisionShape==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
binocOff = "";
'''Description:''' Found in ''States''. Path to the collision model to be used during the animation, a special P3D file with only a Geometry LOD in it.
binocOff = "AmovPercMstpSrasWrflDnon";
binocOff = "AmovPknlMstpSrasWrflDnon";
binocOff = "AmovPercMstpSrasWrflDnon";
binocOff = "AmovPpneMstpSrasWrflDnon";
</syntaxhighlight>


collisionShape = "ca\Anims\Characters\data\Geom\Sdr\Sstanistat_safe_geom.p3d";
==== binocOn ====
collisionShape = "ca\Anims\Characters\data\Geom\Sdr\geom_Adth.p3d";
;Type: [[TokenNameValueTypes|String]]


==collisionShapeSafe==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
binocOn = ""; // No binocs while lying on the ground injured
'''Description:'''
binocOn = "AwopPknlMstpSoptWbinDnon_rfl";
binocOn = "AwopPercMstpSoptWbinDnon_rfl";
binocOn = "AwopPknlMstpSoptWbinDnon_pst";
binocOn = "AwopPpneMstpSoptWbinDnon_rfl";
</syntaxhighlight>


collisionShapeSafe = "ca\Anims\Characters\data\Geom\Sdr\sbeh45l_safe_geom.p3d";
==== boundingSphere ====
;Type: [[TokenNameValueTypes|Float / Boolean]]
;Description: Probably obsolescent, used for character collision detection. For more accurate collision models use ''collisionShape'' & Co. Still used in {{Name|arma2|short}} for cutscene animations. Sphere collision probably much cheaper than anything else.


==collisionVertexPattern[]==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Array]]<br>
boundingSphere = true;
'''Description:''' Possibly some internal requirement of the collision detection algorithm. The strings represent individual vertices (named selections in the P3D).
boundingSphere = 1;
boundingSphere = 1.5;
boundingSphere = 8;
boundingSphere = 35;
</syntaxhighlight>


collisionVertexPattern[] = {"1a","2a","3a","4a","5a","6a","7a","8a","1c","2c"};
=== C ===
collisionVertexPattern[] = {"1a", "2a", "3a", "4a", "5a", "6a", "7a", "8a", "9a", "10a", "11a", "12a", "13a", "14a", "15a", "16a", "17a", "18a", "19a", "20a", "21a", "22a", "23a", "24a", "25a", "26a", "27a", "28a", "29a", "30a", "31a", "32a", "33a", "34a", "1c", "2c", "3c", "4c", "5c", "6c", "7c", "8c"};
==== CanNotMove ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions''.


==Combat==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
CanNotMove = "AmovPpneMstpSrasWrflDnon";
'''Description:''' Found in ''Actions''
</syntaxhighlight>


Combat = "AmovPknlMstpSrasWrflDnon";
==== canPullTrigger ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Self explanatory. While in that animation, the player can fire it is weapon, but his trigger finger will remain extended. The little "finger squeezing the trigger" animation won't play.


==connectAs==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
canPullTrigger = 1;
'''Description:''' Found in ''States''; Not used in ArmAII/OA anymore.
</syntaxhighlight>


connectAs = "";
==== Civil ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', defines what happens to a soldier if he were to lose his weapons and become unarmed.


==connectFrom[]==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Array]]<br>
Civil = "AmovPercMstpSnonWnonDnon";
'''Description:''' Found in ''States''; Not used in ArmAII/OA anymore.
Civil = "AmovPercMstpSnonWnonDnon_gear";
</syntaxhighlight>


connectFrom[] = {};
==== CivilLying ====
connectFrom[] = {"TestSurrender",0.9,"AdthPercMstpSlowWrflDnon_1",0.9};
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions''.


==connectTo[]==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Array]]<br>
CivilLying = "AmovPpneMstpSnonWnonDnon";
'''Description:''' Found in ''States'', defines which animations can follow the current one, once it finishes. Although it allows for blending, ideally, the first pose of all animations from ''connectTo'' should be identical to the last pose of the current animation.
</syntaxhighlight>


//AinvPknlMstpSnonWnonDnon_medic0S
==== collisionGeomCompPattern[] ====
ConnectTo[] = {"AinvPknlMstpSnonWnonDnon_medic", 0.01, "AinvPknlMstpSnonWnonDnon_medic0", 0.01, "AinvPknlMstpSnonWnonDnon_medic1", 0.01, "AinvPknlMstpSnonWnonDnon_medic2", 0.01, "AinvPknlMstpSnonWnonDnon_medic3", 0.01, "AinvPknlMstpSnonWnonDnon_medic4", 0.01, "AinvPknlMstpSnonWnonDnon_medic5", 0.01};
;Type: [[TokenNameValueTypes|Array]]
//BasicDriver
ConnectTo[] = {"BasicDriverDying", 1.0};
connectTo[] = {"TestSurrender",0.9,"AdthPercMstpSlowWrflDnon_1",0.9};


==Crouch==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
collisionGeomCompPattern[] = {1,3,6};
'''Description:''' Found in ''Actions'', defines what happens when the AI crouch. There's also ''PlayerCrouch'', which makes different crouching animations possible for players as opposed to AI.
</syntaxhighlight>


Crouch = "AmovPknlMstpSnonWnonDnon";
==== collisionShape ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''States''. Path to the collision model to be used during the animation, a special ''P3D'' file with only a ''Geometry LOD'' in it. Having "axis" selection point in ``Memory LOD`` of this shape will make unit rotate around this point instead of their entity center.


=D=
<syntaxhighlight lang="cpp">
collisionShape = "ca\Anims\Characters\data\Geom\Sdr\Sstanistat_safe_geom.p3d";
collisionShape = "ca\Anims\Characters\data\Geom\Sdr\geom_Adth.p3d";
</syntaxhighlight>


==default==
==== collisionShapeSafe ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''Actions'', defines the default state for an action.


default = "LadderRifleStatic";
<syntaxhighlight lang="cpp">
collisionShapeSafe = "ca\Anims\Characters\data\Geom\Sdr\sbeh45l_safe_geom.p3d";
</syntaxhighlight>


==die==
==== collisionVertexPattern[] ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:''' Found in ''Actions'', defines what animation/state is called when the character dies.
;Description: Possibly some internal requirement of the collision detection algorithm. The strings represent individual vertices (named selections in the ''P3D'').


die = "AdthPercMstpSlowWrflDnon_r05";
<syntaxhighlight lang="cpp">
die = "DeadState";
collisionVertexPattern[] = {"1a", "2a", "3a", "4a", "5a", "6a", "7a", "8a", "1c", "2c"};
collisionVertexPattern[] = {"1a", "2a", "3a", "4a", "5a", "6a", "7a", "8a", "9a", "10a", "11a", "12a", "13a",
"14a", "15a", "16a", "17a", "18a", "19a", "20a", "21a", "22a", "23a", "24a", "25a", "26a", "27a", "28a",
"29a", "30a", "31a", "32a", "33a", "34a", "1c", "2c", "3c", "4c", "5c", "6c", "7c", "8c"};
</syntaxhighlight>


==disableWeapons==
==== Combat ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''States'', and unlike canPullTrigger, it can prohibit the character from firing his weapon.
;Description: Found in ''Actions''.


disableWeapons = 1;
<syntaxhighlight lang="cpp">
Combat = "AmovPknlMstpSrasWrflDnon";
</syntaxhighlight>


==disableWeaponsLong==
==== connectAs ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''States'', and apparently the only time ''disableWeaponsLong'' differs from ''disableWeapons'' is when the weapon is lowered (Ctrl doubletap).
;Description: Found in ''States''; Not used in {{Name|arma2oa|short}} anymore.


//AmovPercMstpSlowWrflDnon
<syntaxhighlight lang="cpp">
disableWeapons = false;
connectAs = "";
disableWeaponsLong = true;
</syntaxhighlight>


disableWeaponsLong = 1;
==== connectFrom[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Found in ''States''; Not used in {{Name|arma2oa|short}} anymore.


==down==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
connectFrom[] = {};
'''Description:''' Found in ''Actions'', tells what animation to play when hitting the "Go prone" key.
connectFrom[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9};
</syntaxhighlight>


//class RifleBaseStandActions
==== connectTo[] ====
down = "AmovPpneMstpSrasWrflDnon";
;Type: [[TokenNameValueTypes|Array]]
//class RifleProneActions
;Description: Found in ''States''. Defines edges in the animation graph, i.e. which animations can follow this one, once it finishes. The first pose of all animations from ''connectTo'' should be identical to the last pose of the current animation, otherwise see ''interpolateTo''. The numeric value specifies the cost of the transition.
down = "AmovPercMstpSrasWrflDnon";
//??


down = "LadderRifleDownLoop";
<syntaxhighlight lang="cpp">
//AinvPknlMstpSnonWnonDnon_medic0S
ConnectTo[] = {"AinvPknlMstpSnonWnonDnon_medic", 0.01,
"AinvPknlMstpSnonWnonDnon_medic0", 0.01,
"AinvPknlMstpSnonWnonDnon_medic1", 0.01,
"AinvPknlMstpSnonWnonDnon_medic2", 0.01,
"AinvPknlMstpSnonWnonDnon_medic3", 0.01,
"AinvPknlMstpSnonWnonDnon_medic4", 0.01,
"AinvPknlMstpSnonWnonDnon_medic5", 0.01};
//BasicDriver
ConnectTo[] = {"BasicDriverDying", 1.0};
connectTo[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9};
</syntaxhighlight>


==duty==
==== Crouch ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Duty used to mean some mandatory states/actions the character had to reach, before being able to perform a certain animation. Not sure about what this does in ArmA anymore, if anything.
;Description: Found in ''Actions'', defines what happens when the ''AI'' crouch. There's also ''PlayerCrouch'', which makes different crouching animations possible for players as opposed to ''AI''.


//OFP config
<syntaxhighlight lang="cpp">
#define RunDuty -0.5
Crouch = "AmovPknlMstpSnonWnonDnon";
#define WalkDuty -0.7
</syntaxhighlight>
#define RestDuty -1
#define CrawlDuty -0.0
#define SprintDuty 0.6


duty = -1;
=== D ===
duty = -0.7;
==== default ====
duty = -0.5;
;Type: [[TokenNameValueTypes|String]]
duty = -0.4;
;Description: Found in ''Actions'', defines the default state for an action.
duty = 0.1;
duty = 0.2;
duty = 0.25;
duty = 0.3;
duty = 0.4;
duty = 0.5;
duty = 0.6;
duty = 2;


=E=
<syntaxhighlight lang="cpp">
default = "LadderRifleStatic";
</syntaxhighlight>


==enableAutoActions==
==== die ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''States''. In ArmAII there's a single occurence of it being ''true'': class TestDance.
;Description: Found in ''Actions'', defines what animation/state is called when the character dies.


enableAutoActions = 1;
<syntaxhighlight lang="cpp">
die = "AdthPercMstpSlowWrflDnon_r05";
die = "DeadState";
</syntaxhighlight>


==enableBinocular==
==== disableWeapons ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:''' Found in ''States'', defines whether the character can use binoculars or not.
;Description: Found in ''States'', and unlike ''canPullTrigger'', it can prohibit the character from firing his weapon.


enableBinocular = 1;
<syntaxhighlight lang="cpp">
disableWeapons = 1;
</syntaxhighlight>


enableBinocular = false; //class CutSceneAnimationBase
==== disableWeaponsLong ====
enableBinocular = false; //class AmovPercMrunSnonWbinDf_rfl
;Type: [[TokenNameValueTypes|Boolean]]
enableBinocular = true; //class AwopPknlMstpSoptWbinDnon_rfl
;Description: Found in ''States'', and apparently the only time ''disableWeaponsLong'' differs from ''disableWeapons'' is when the weapon is lowered (Ctrl doubletap).


==enableMissile==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
//AmovPercMstpSlowWrflDnon
'''Description:''' Found in ''States'', similar to ''disableWeapons''. It enables/disables the firing of shoulder launched rockets (RPGs, MANPADS).
disableWeapons = false;
disableWeaponsLong = true;
// or
disableWeaponsLong = 1;
</syntaxhighlight>


enableMissile = true; //class AidlPercMstpSrasWlnrDnon_player_idleSteady01
==== down ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', tells what animation to play when hitting the "''Go prone''" key.


enableMissile = 1;
<syntaxhighlight lang="cpp">
//class RifleBaseStandActions
down = "AmovPpneMstpSrasWrflDnon";
//class RifleProneActions
down = "AmovPercMstpSrasWrflDnon";
//??


==enableOptics==
down = "LadderRifleDownLoop";
[[TokenNameValueTypes|Boolean]]<br>
</syntaxhighlight>
'''Description:''' Found in ''States'', enables/disables looking down the weapon sights.


enableOptics = 1;
==== duty ====
;Type: [[TokenNameValueTypes|Float]]
;Description: Duty used to mean some mandatory states/actions the character had to reach, before being able to perform a certain animation. Not sure about what this does in {{Name|arma1|short}} anymore, if anything.


==equivalentTo==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
//OFP config
'''Description:''' Found in ''States'', not sure what it does. The animation class is mostly ''equivalentTo'' another one, and oddly, sometimes to itself. Popular with healing, death, idle and cutscene animations.
#define RunDuty -0.5
#define WalkDuty -0.7
#define RestDuty -1
#define CrawlDuty -0.0
#define SprintDuty 0.6


equivalentTo = "";
duty = -1;
duty = -0.7;
duty = -0.5;
duty = -0.4;
duty = 0.1;
duty = 0.2;
duty = 0.25;
duty = 0.3;
duty = 0.4;
duty = 0.5;
duty = 0.6;
duty = 2;
</syntaxhighlight>


class AdthPercMstpSrasWrflDnon_1 : AdthPercMstpSlowWrflDnon_1 {
=== E ===
file = "\ca\Anims\Characters\data\Anim\Sdr\Dth\Erc\stp\ras\Rfl\AdthPercMstpSrasWrflDnon_1";
==== enableAutoActions ====
speed = 0.72;
;Type: [[TokenNameValueTypes|Boolean]]
equivalentTo = "AdthPercMstpSrasWrflDnon_1";
;Description: Found in ''States''. In {{Name|arma2|short}} there's a single occurrence of it being ''true'': {{hl|class TestDance}}.
...
};


equivalentTo = "AmovPsitMstpSlowWrflDnon";
<syntaxhighlight lang="cpp">
enableAutoActions = 1;
</syntaxhighlight>


==EvasiveBack==
==== enableBinocular ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:''' Found in ''Actions'', along with EvasiveForward, -Left and -Right. They point to the possible evasive animations that can be triggered.
;Description: Found in ''States'', defines whether the character can use binoculars or not.


EvasiveBack = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDb";
<syntaxhighlight lang="cpp">
enableBinocular = 1;


==EvasiveForward==
enableBinocular = false; // class CutSceneAnimationBase
[[TokenNameValueTypes|String]]<br>
enableBinocular = false; // class AmovPercMrunSnonWbinDf_rfl
'''Description:''' See [[CfgMoves_Config_Reference#EvasiveBack | EvasiveBack]].
enableBinocular = true; // class AwopPknlMstpSoptWbinDnon_rfl
</syntaxhighlight>


EvasiveForward = "AmovPercMevaSlowWlnrDf";
==== enableMissile ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', similar to ''disableWeapons''. It enables/disables the firing of shoulder launched rockets (''RPGs, MANPADS'').


==EvasiveLeft==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
enableMissile = true; //class AidlPercMstpSrasWlnrDnon_player_idleSteady01
'''Description:''' See [[CfgMoves_Config_Reference#EvasiveBack | EvasiveBack]].


EvasiveLeft = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDl";
enableMissile = 1;
</syntaxhighlight>


==EvasiveRight==
==== enableOptics ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:''' See [[CfgMoves_Config_Reference#EvasiveBack | EvasiveBack]].
;Description: Found in ''States'', enables/disables looking down the weapon sights.


EvasiveRight = "AmovPpneMstpSrasWrflDnon_AmovPpneMevaSlowWrflDr";
<syntaxhighlight lang="cpp">
enableOptics = 1;
</syntaxhighlight>


=F=
==== equivalentTo ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''States'', not sure what it does. The animation class is mostly ''equivalentTo'' another one, and oddly, sometimes to itself. Popular with healing, death, idle and cutscene animations.


==fast..==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
equivalentTo = "";
'''Description:''' Found in ''Actions'', [[#walk.. | walk..]] defines the walking animations, [[#slow.. | slow..]] defines the running/jogging and [[#fast.. | fast..]] the sprinting animations. The suffixes mean the following: '''B''' (backward), '''F''' (forward), '''L''' (left strafe), '''R''' (right strafe) and a combination of these: '''RF''' (45 deg. strafe), '''RB''' (135 deg. strafe), '''LB''' (225 deg. strafe) and '''LF''' (315 deg. strafe).


fastB = "AswmPercMstpSnonWnonDnon";
class AdthPercMstpSrasWrflDnon_1 : AdthPercMstpSlowWrflDnon_1 {
fastB = "AmovPercMrunSrasWrflDb";
file = "\ca\Anims\Characters\data\Anim\Sdr\Dth\Erc\stp\ras\Rfl\AdthPercMstpSrasWrflDnon_1";
speed = 0.72;
equivalentTo = "AdthPercMstpSrasWrflDnon_1";
...
};


fastF = "AswmPercMsprSnonWnonDf";
equivalentTo = "AmovPsitMstpSlowWrflDnon";
</syntaxhighlight>


fastL = "AswmPercMstpSnonWnonDnon";
==== EvasiveBack ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', along with ''EvasiveForward'', {{hl|-Left}} and {{hl|-Right}}. They point to the possible evasive animations that can be triggered.


fastLB = "AswmPercMstpSnonWnonDnon";
<syntaxhighlight lang="cpp">
EvasiveBack = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDb";
</syntaxhighlight>


fastLF = "AswmPercMsprSnonWnonDf";
==== EvasiveForward ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#EvasiveBack | EvasiveBack]]''.


fastR = "AswmPercMstpSnonWnonDnon";
<syntaxhighlight lang="cpp">
EvasiveForward = "AmovPercMevaSlowWlnrDf";
</syntaxhighlight>


fastRB = "AswmPercMstpSnonWnonDnon";
==== EvasiveLeft ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#EvasiveBack | EvasiveBack]]''.


fastRF = "AswmPercMsprSnonWnonDf";
<syntaxhighlight lang="cpp">
EvasiveLeft = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDl";
</syntaxhighlight>


==file==
==== EvasiveRight ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''States'', points to the [[RTM]] animation file.
;Description: See ''[[#EvasiveBack | EvasiveBack]]''.


file = "\ca\Anims\Characters\data\Anim\Wmn\cts\erc\stp\non\non\ActsPercMstpSnonWnonDnon_MarianQ_shot5.rtm";
<syntaxhighlight lang="cpp">
EvasiveRight = "AmovPpneMstpSrasWrflDnon_AmovPpneMevaSlowWrflDr";
</syntaxhighlight>


==FireNotPossible==
=== F ===
[[TokenNameValueTypes|String]]<br>
==== fast.. ====
'''Description:''' Found in ''Actions''.
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', ''[[#walk.. | walk..]]'' defines the walking animations, ''[[#slow.. | slow..]]'' defines the running/jogging and ''[[#fast.. | fast..]]'' the sprinting animations.


FireNotPossible = "AmovPpneMstpSrasWrflDnon";
The suffixes mean the following: '''B''' (backward), '''F''' (forward), '''L''' (left strafe), '''R''' (right strafe) and a combination of these: '''RF''' (45 deg. strafe), '''RB''' (135 deg. strafe), '''LB''' (225 deg. strafe) and '''LF''' (315 deg. strafe).


=G=
<syntaxhighlight lang="cpp">
fastB = "AswmPercMstpSnonWnonDnon";
fastB = "AmovPercMrunSrasWrflDb";
fastF = "AswmPercMsprSnonWnonDf";
fastL = "AswmPercMstpSnonWnonDnon";
fastLB = "AswmPercMstpSnonWnonDnon";
fastLF = "AswmPercMsprSnonWnonDf";
fastR = "AswmPercMstpSnonWnonDnon";
fastRB = "AswmPercMstpSnonWnonDnon";
fastRF = "AswmPercMsprSnonWnonDf";
</syntaxhighlight>


==getInCar==
==== file ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' ''getInCar'' and ''getOutCar'' are found in ''Actions''; they define what animations to call when getting into/out of a car. Similar to ''getInTank''/''getOutTank''.
;Description: Found in ''States'', points to the ''[[RTM]]'' animation file.
None of these are really used in the ArmAII config anymore (one exception: class ''LauncherKneelActions''). Instead, ''getInHigh, -Medium'' and ''-Low'' are used with their respective ''getOuts''. Assigning the different ''getIn'' actions for each vehicle is done in [[CfgVehicles_Config_Reference#...Action | CfgVehicles]].


getInAction = "GetInCar"; //CfgVehicles
<syntaxhighlight lang="cpp">
file = "\ca\Anims\Characters\data\Anim\Wmn\cts\erc\stp\non\non\ActsPercMstpSnonWnonDnon_MarianQ_shot5.rtm";
</syntaxhighlight>


getInCar = "AmovPknlMstpSrasWrflDnon";
==== FireNotPossible ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions''.


==GetInHigh==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
FireNotPossible = "AmovPpneMstpSrasWrflDnon";
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].
</syntaxhighlight>


GetInHigh = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInHigh";
=== G ===
==== getInCar ====
;Type: [[TokenNameValueTypes|String]]
;Description: ''getInCar'' and ''getOutCar'' are found in ''Actions''; they define what animations to call when getting into/out of a car. Similar to ''getInTank''/''getOutTank''.


==GetInLow==
None of these are really used in the {{Name|arma2|short}} config anymore (one exception: class ''LauncherKneelActions''). Instead, ''getInHigh, -Medium'' and ''-Low'' are used with their respective ''getOuts''. Assigning the different ''getIn'' actions for each vehicle is done in ''[[CfgVehicles_Config_Reference#...Action | CfgVehicles]]''.
[[TokenNameValueTypes|String]]<br>
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].


GetInLow = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInLow";
<syntaxhighlight lang="cpp">
getInAction = "GetInCar"; //CfgVehicles


==GetInMedium==
getInCar = "AmovPknlMstpSrasWrflDnon";
[[TokenNameValueTypes|String]]<br>
</syntaxhighlight>
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].


GetInMedium = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInMedium";
==== GetInHigh ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


==getInTank==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
GetInHigh = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInHigh";
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].
</syntaxhighlight>


getInTank = "AmovPknlMstpSrasWrflDnon";
==== GetInLow ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


==getOutCar==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
GetInLow = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInLow";
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].
</syntaxhighlight>


getOutCar = "AmovPknlMstpSrasWrflDnon";
==== GetInMedium ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


==GetOutHigh==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
GetInMedium = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInMedium";
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].
</syntaxhighlight>


GetOutHigh = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutHigh";
==== getInTank ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


==GetOutLow==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
getInTank = "AmovPknlMstpSrasWrflDnon";
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].
</syntaxhighlight>


GetOutLow = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutLow";
==== getOutCar ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


==GetOutMedium==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
getOutCar = "AmovPknlMstpSrasWrflDnon";
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].
</syntaxhighlight>


GetOutMedium = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutMedium";
==== GetOutHigh ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


==getOutTank==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
GetOutHigh = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutHigh";
'''Description:''' See [[CfgMoves_Config_Reference#getInCar | getInCar]].
</syntaxhighlight>


getOutTank = "AmovPknlMstpSrasWrflDnon";
==== GetOutLow ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


=H=
<syntaxhighlight lang="cpp">
GetOutLow = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutLow";
</syntaxhighlight>


==handGunOn==
==== GetOutMedium ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''Actions'', points to the animation to transition to, when the character draws it's pistol. It is not the transition animation itself, where the character brings up the pistol (and puts away his rifle/launcher if he had any), but the end result of that: character standing, aiming with the pistol.  
;Description: See ''[[#getInCar | getInCar]]''.


handGunOn = "AmovPercMstpSrasWpstDnon"; //class RifleBaseLowStandActions
<syntaxhighlight lang="cpp">
GetOutMedium = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutMedium";
</syntaxhighlight>


handGunOn = "AmovPpneMstpSrasWrflDnon";
==== getOutTank ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#getInCar | getInCar]]''.


==hasCollShapeSafe==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
getOutTank = "AmovPknlMstpSrasWrflDnon";
'''Description:'''
</syntaxhighlight>


hasCollShapeSafe = 0;
=== H ===
==== handGunOn ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', points to the animation to transition to, when the character draws it is pistol. It is not the transition animation itself, where the character brings up the pistol (and puts away his rifle/launcher if he had any), but the end result of that: character standing, aiming with the pistol.


==head==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
handGunOn = "AmovPercMstpSrasWpstDnon"; //class RifleBaseLowStandActions
'''Description:''' Found in ''States'', references ''BlendAnims'' class entries. Permits/forbids the character to rotate his head freely. Similar in functionality to [[CfgMoves_Config_Reference#aiming | aiming]].


head = "headDefault";   //class Default
handGunOn = "AmovPpneMstpSrasWrflDnon";
head = "headNo";        //class CutSceneAnimationBase
</syntaxhighlight>
head = "empty";        //class HaloFreeFall_non


==headDefault[]==
==== hasCollShapeSafe ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:''' Found in class ''BlendAnims'', defines a set of bones, with weights associated to each of them.


headDefault[] = {"head", 1, "neck1", 0.5, "neck", 0.5};
<syntaxhighlight lang="cpp">
hasCollShapeSafe = 0;
</syntaxhighlight>


headDefault[] = {};
==== head ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''States'', references ''BlendAnims'' class entries. Permits/forbids the character to rotate his head freely. Similar in functionality to ''[[#aiming | aiming]]''.


==headNo[]==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Array]]<br>
head = "headDefault"; // class Default
'''Description:''' Found in class ''BlendAnims'', always an empty array. Serves for disabling free head movement (independent of the RTM animation).
head = "headNo"; // class CutSceneAnimationBase
head = "empty"; // class HaloFreeFall_non
</syntaxhighlight>


headNo[] = {};
==== headDefault[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Found in class ''BlendAnims'', defines a set of bones, with weights associated to each of them.


=I=
<syntaxhighlight lang="cpp">
headDefault[] = {"head", 1, "neck1", 0.5, "neck", 0.5};


==interpolateFrom[]==
headDefault[] = {};
[[TokenNameValueTypes|Array]]<br>
</syntaxhighlight>
'''Description:''' Found in ''States'', used together with ''interpolateTo'' for setting up two-way interpolation rules. ''interpolateFrom[]'' however, seems to have fallen in disuse.


interpolateFrom[] = {"TestSurrender",0.9,"AdthPercMstpSlowWrflDnon_1",0.9};
==== headNo[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Found in class ''BlendAnims'', always an empty array. Serves for disabling free head movement (independent of the ''[[RTM]]'' animation).


==interpolateTo[]==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Array]]<br>
headNo[] = {};
'''Description:''' Found in ''States''; defines which animations can interrupt the current one, and how fast blending between the two should be. Typically, animations will play to the end, then another animation will be played. Sometimes though, it's important to be able to just cut the current animation short, and immediately change to a different animation. A good example would be death animations: if the character is half way through "eating a kebab" animation and the kebab explodes in his face, he won't continue munching. Instead he will play a death animation and fall to the ground right away. To make the cut between the two animation less visually jarring, a couple of frames of transition/interpolation is provided, the length of which is what the numerical values stand for.
</syntaxhighlight>


interpolateTo[] = {"AinvPknlMstpSlayWrflDnon",0.01,"AinvPknlMstpSlayWrflDnon_1",0.01,"AinvPknlMstpSnonWnonDnon_1",0.01,"AinvPknlMstpSnonWnonDnon_2",0.01,"AinvPknlMstpSnonWnonDnon_3",0.01,"AinvPknlMstpSnonWnonDnon_4",0.01,"AdthPknlMstpSnonWnonDnon_inventory",0.1};
====headBobMode ====
;Type: [[TokenNameValueTypes|Number]]
;Description:


==interpolateWith[]==
Valid values
[[TokenNameValueTypes|Array]]<br>
<syntaxhighlight lang="cpp">
'''Description:''' Found in ''States'', disused.
HeadBobUndef = 0
HeadBobRaw = 1
HeadBobBeginEnd = 2
HeadBobAverageFrame = 3
HeadBobStraightHorizon = 4
HeadBobCutScene = 5
</syntaxhighlight>


interpolateWith[] = {"BasicDriver",0.02};


==interpolationRestart==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
headBobMode = 5; // Cutscene
'''Description:''' Found in ''States'', true mostly for transition animations.
</syntaxhighlight>


interpolationRestart = false;    //Default
interpolationRestart = true;    //DefaultDie
interpolationRestart = 2;


==interpolationSpeed==
=== I ===
[[TokenNameValueTypes|Float]]<br>
==== interpolateFrom[] ====
'''Description:''' Found in ''States''.
;Type: [[TokenNameValueTypes|Array]]
;Description: Found in ''States'', used together with ''interpolateTo'' for setting up two-way interpolation rules. ''interpolateFrom[]'' however, seems to have fallen in disuse.


interpolationSpeed = 200;    //AidlPercMstpSrasWrflDnon_aiming01, AdthPercMstpSrasWrflDnon_rS0
<syntaxhighlight lang="cpp">
interpolationSpeed = 30.5;  //AmovPercMstpSlowWrflDnon_player_idleSteady01
interpolateFrom[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9};
interpolationSpeed = 6;      //Default
</syntaxhighlight>
interpolationSpeed = 0.5;   //AmovPknlMstpSrasWrflDnon_AmovPercMsprSrasWrflDf_2
interpolationSpeed = 0.1;    //AinjPfalMstpSnonWrflDnon_carried_Up


=J=
==== interpolateTo[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Found in ''States''; defines edges in the animation graph which should be interpolated immediately instead of connected at the end of this animation. As with connectTo, the numeric value specifies the cost of the transition.


==JumpOff==
Typically, animations will play to the end, then another animation will be played. Sometimes though, it is important to be able to just cut the current animation short, and immediately change to a different animation.
[[TokenNameValueTypes|String]]<br>
'''Description:''' Found in ''Actions'', disused.


JumpOff = "";
A good example would be death animations: if the character is half way through "eating a kebab" animation and the kebab explodes in his face, he won't continue munching. Instead he will play a death animation and fall to the ground right away.


=K=
To make the cut between the two animation less visually jarring, a couple of frames of transition/interpolation is provided.


=L=
<syntaxhighlight lang="cpp">
interpolateTo[] = {"AinvPknlMstpSlayWrflDnon", 0.01,
"AinvPknlMstpSlayWrflDnon_1", 0.01,
"AinvPknlMstpSnonWnonDnon_1", 0.01,
"AinvPknlMstpSnonWnonDnon_2", 0.01,
"AinvPknlMstpSnonWnonDnon_3", 0.01,
"AinvPknlMstpSnonWnonDnon_4", 0.01,
"AdthPknlMstpSnonWnonDnon_inventory", 0.1};
</syntaxhighlight>


==ladderOff==
==== interpolateWith[] ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:''' Found in ''States'', defines what animation to switch to when letting go of the ladder.
;Description: Found in ''States'', disused.


ladderOff = "AmovPercMstpSnonWnonDnon";
<syntaxhighlight lang="cpp">
interpolateWith[] = {"BasicDriver", 0.02};
</syntaxhighlight>


==ladderOffBottom==
==== interpolationRestart ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:''' Found in ''States'', defines what animation to switch to when letting go of the ladder, having reached the bottom of it.
;Description: Found in ''States'', true mostly for transition animations.


ladderOffBottom = "LadderRifleDownOff";
<syntaxhighlight lang="cpp">
interpolationRestart = false; // Default
interpolationRestart = true; // DefaultDie
interpolationRestart = 2;
</syntaxhighlight>


==ladderOffTop==
==== interpolationSpeed ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:''' Found in ''States'', defines what animation to switch to when letting go of the ladder, having reached the top of it.
;Description: Found in ''States''.


ladderOffTop = "LadderRifleTopOff";
<syntaxhighlight lang="cpp">
interpolationSpeed = 200; // AidlPercMstpSrasWrflDnon_aiming01, AdthPercMstpSrasWrflDnon_rS0
interpolationSpeed = 30.5; // AmovPercMstpSlowWrflDnon_player_idleSteady01
interpolationSpeed = 6; // Default
interpolationSpeed = 0.5; // AmovPknlMstpSrasWrflDnon_AmovPercMsprSrasWrflDf_2
interpolationSpeed = 0.1; // AinjPfalMstpSnonWrflDnon_carried_Up
</syntaxhighlight>


==ladderOnDown==
=== J ===
[[TokenNameValueTypes|String]]<br>
==== JumpOff ====
'''Description:''' Found in ''States'', defines what animation to switch to when getting onto the bottom of the ladder.
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', disused.


ladderOnDown = "LadderRifleOn";
<syntaxhighlight lang="cpp">
JumpOff = "";
</syntaxhighlight>


==ladderOnUp==
=== L ===
[[TokenNameValueTypes|String]]<br>
==== ladderOff ====
'''Description:''' Found in ''States'', defines what animation to switch to when getting onto the top of the ladder.
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''States'', defines what animation to switch to when letting go of the ladder.


ladderOnUp = "LadderRifleOn";
<syntaxhighlight lang="cpp">
ladderOff = "AmovPercMstpSnonWnonDnon";
</syntaxhighlight>


==leaning==
==== ladderOffBottom ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in both ''Actions'' and ''States'', references ''BlendAnims'' class entries. Defines how much each bone/bodypart should be influenced when leaning. Leaning, similar to aiming, is not an animation played back from a file. It's procedural, if you will, and so needs extra setting up in the config to look it's best.
;Description: Found in ''States'', defines what animation to switch to when letting go of the ladder, having reached the bottom of it.


leaning = "leaningDefault";    //Default
<syntaxhighlight lang="cpp">
leaning = "aimingLying";       //AmovPpneMstpSrasWrflDnon_injured
ladderOffBottom = "LadderRifleDownOff";
leaning = "empty";            //class AmovPpneMrunSlowWrflDf - disables leaning while prone
</syntaxhighlight>


==leaningCorrectionAngleBeg==
==== ladderOffTop ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Not used in ArmAII, appearing only once in ArmAI config, where both leaningCorrectionAngleBeg and leaningCorrectionAngleEnd are zero.
;Description: Found in ''States'', defines what animation to switch to when letting go of the ladder, having reached the top of it.


leaningCorrectionAngleBeg = 0;
<syntaxhighlight lang="cpp">
leaningCorrectionAngleEnd = 0;
ladderOffTop = "LadderRifleTopOff";
</syntaxhighlight>


==leaningFactorBeg==
==== ladderOnDown ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:''' Found in ''States'', leaningFactorBeg sets how much influence leaning has at the start of an animation while leaningFactorEnd takes care of the end. If the two values differ, leaning is blended in or out during the animation.
;Description: Found in ''States'', defines what animation to switch to when getting onto the bottom of the ladder.


leaningFactorBeg = 1; //StandBase
<syntaxhighlight lang="cpp">
leaningFactorEnd = 1;
ladderOnDown = "LadderRifleOn";
</syntaxhighlight>


leaningFactorBeg = 0; //SprintBaseDf
==== ladderOnUp ====
leaningFactorEnd = 0;
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''States'', defines what animation to switch to when getting onto the top of the ladder.


leaningFactorBeg = 0.5;  //AmovPknlMstpSrasWlnrDnon - limited (half) leaning with launcher
<syntaxhighlight lang="cpp">
leaningFactorEnd = 0.5;
ladderOnUp = "LadderRifleOn";
</syntaxhighlight>


leaningFactorBeg = 0.75;  //AmovPercMwlkSlowWrflDf - limited leaning while walking with rifle raised
==== leaning ====
leaningFactorEnd = 0.75;
;Type: [[TokenNameValueTypes|String]]
;Description: Found in both ''Actions'' and ''States'', references ''BlendAnims'' class entries. Defines how much each bone/bodypart should be influenced when leaning.


leaningFactorBeg = 1;    //amovpercmstpsraswrfldnon_amovpercmstpsraswlnrdnon
Leaning, similar to aiming, is not an animation played back from a file. It's procedural, if you will, and so needs extra setting up in the config to look it is best.
leaningFactorEnd = 0.5;


leaningFactorBeg = 1;   //AmovPercMstpSrasWrflDnon_AmovPpneMstpSrasWrflDnon
<syntaxhighlight lang="cpp">
leaningFactorEnd = 0;   // -transition betwen a state with full leaning to one where leaning is forbidden-
leaning = "leaningDefault"; // Default
leaning = "aimingLying"; // AmovPpneMstpSrasWrflDnon_injured
leaning = "empty"; // class AmovPpneMrunSlowWrflDf - disables leaning while prone
</syntaxhighlight>


==leaningFactorEnd==
==== leaningCorrectionAngleBeg ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:''' See above.
;Description: Not used in {{Name|arma2|short}}, appearing only once in {{Name|arma1|short}} config, where both ''leaningCorrectionAngleBeg'' and ''leaningCorrectionAngleEnd'' are zero.


leaningFactorEnd = 0.75;
<syntaxhighlight lang="cpp">
leaningCorrectionAngleBeg = 0;
leaningCorrectionAngleEnd = 0;
</syntaxhighlight>


==leaningFactorZeroPoint==
==== leaningFactorBeg ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:''' Appears only once in both ArmAI/II, no variation across ''States'' or ''Actions''.
;Description: Found in ''States'', ''leaningFactorBeg'' sets how much influence leaning has at the start of an animation, while ''leaningFactorEnd'' takes care of the end. If the two values differ, leaning is blended in or out during the animation.


leaningFactorZeroPoint = -1;
<syntaxhighlight lang="cpp">
leaningFactorBeg = 1; // StandBase
leaningFactorEnd = 1;


==leanLRot==
leaningFactorBeg = 0; // SprintBaseDf
[[TokenNameValueTypes|Float]]<br>
leaningFactorEnd = 0;
'''Description:''' Found in ''Actions'', sets the amount of lean possible, the angle of leaning. With a value of 1, the character will lean about 70 degrees off vertical, looking like it just broke it's back, so the more reasonable amount to lean is about half of that. Doctor's orders.


leanLRot = 0;      //NoActions, RifleProneActions
leaningFactorBeg = 0.5; // AmovPknlMstpSrasWlnrDnon - limited (half) leaning with launcher
leanLRot = 0.5;   //RifleBaseLowStandActions
leaningFactorEnd = 0.5;
leanLRot = 0.57;   //CivilStandActions


==leanLShift==
leaningFactorBeg = 0.75; // AmovPercMwlkSlowWrflDf - limited leaning while walking with rifle raised
[[TokenNameValueTypes|Float]]<br>
leaningFactorEnd = 0.75;
'''Description:''' Found in ''Actions''. In addition to tilting the upper body during leaning, it's also possible to move it into the lean. Typical values are very small, anything else will produce excessive deformations of the model.


leanLShift = 0;      //class RifleProneActions
leaningFactorBeg = 1; // amovpercmstpsraswrfldnon_amovpercmstpsraswlnrdnon
leanLShift = 0.01;   //class RifleBaseLowStandActions
leaningFactorEnd = 0.5;
leanLShift = 0.07;   //class CivilStandActions


==leanRRot==
leaningFactorBeg = 1; // AmovPercMstpSrasWrflDnon_AmovPpneMstpSrasWrflDnon
[[TokenNameValueTypes|Float]]<br>
leaningFactorEnd = 0; // -transition betwen a state with full leaning to one where leaning is forbidden-
'''Description:''' See [[#leanLRot | leanLRot]].
</syntaxhighlight>


leanRRot = 0.57;
==== leaningFactorEnd ====
;Type: [[TokenNameValueTypes|Float]]
;Description: See above.


==leanRShift==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Float]]<br>
leaningFactorEnd = 0.75;
'''Description:''' See [[#leanLShift | leanLShift]].
</syntaxhighlight>


leanRShift = 0.01;
==== leaningFactorZeroPoint ====
;Type: [[TokenNameValueTypes|Float]]
;Description: Appears only once in both {{Name|arma1|short}} & {{Name|arma2|short}}, no variation across ''States'' or ''Actions''.


==leftHandIKBeg==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
leaningFactorZeroPoint = -1;
'''Description:''' Found in ''States'', appeared in ArmAI, complemented/superseeded in ArmAII by ''leftHandIKCurve[]''. These properties set whether at the beginning and end of the animation, IKs for both arms are enabled or not. ''left/right-HandIKCurve[]'' allows for a more complex and detailed control of FK/IK blending.
</syntaxhighlight>


Typical uses:
==== leanLRot ====
leftHandIKBeg = true;
;Type: [[TokenNameValueTypes|Float]]
leftHandIKCurve[] = {1};
;Description: Found in ''Actions'', sets the amount of lean possible and the angle of leaning.
leftHandIKEnd = true;


leftHandIKBeg = false;
With a value of {{hl|1}}, the character will lean about {{hl|70}} degrees off vertical, looking like it just broke it is back, so the more reasonable amount to lean is about half of that. Doctor's orders.
leftHandIKCurve[] = {};
leftHandIKEnd = false;


leftHandIKBeg = false;
<syntaxhighlight lang="cpp">
leftHandIKCurve[] = {0, 1, 0.075, 0, 0.725, 0, 0.8, 1};
leanLRot = 0; // NoActions, RifleProneActions
leftHandIKEnd = false;
leanLRot = 0.5; // RifleBaseLowStandActions
leanLRot = 0.57; // CivilStandActions
</syntaxhighlight>


leftHandIKBeg = false;
==== leanLShift ====
leftHandIKCurve[] = {0.05, 1, 0.125, 0, 0.6, 0, 0.675, 1};
;Type: [[TokenNameValueTypes|Float]]
leftHandIKEnd = true;
;Description: Found in ''Actions''. In addition to tilting the upper body during leaning, it is also possible to move it into the lean.


==leftHandIKEnd==
Typical values are very small, anything else will produce excessive deformations of the model.
[[TokenNameValueTypes|Boolean]]<br>
'''Description:''' See above.


leftHandIKEnd = 0;
<syntaxhighlight lang="cpp">
leanLShift = 0; // class RifleProneActions
leanLShift = 0.01; // class RifleBaseLowStandActions
leanLShift = 0.07; // class CivilStandActions
</syntaxhighlight>


==leftHandIKCurve==
==== leanRRot ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:'''
;Description: See [[#leanLRot | leanLRot]].
As the name suggests, this array describes the curve controlling [http://en.wikipedia.org/wiki/Forward_kinematics FK]/[http://en.wikipedia.org/wiki/Inverse_kinematics IK] blending on the left arm.
Every pair of values describe a 2D point, with the first number representing ''time'' (horizontal) and the second being the ''weight'' (vertical).
''Time'' ranges from 0-1, where 0 is animation start, 0.5 is half way, and 1 the end. ''Weight'' also ranges from 0-1, where 0 means animation is taken from RTM file (FK) and IK is disabled, 0.6 meaning a 40% blend of FK and 60% IK, and 1 is 100% IK.
Let me interpret the last example below (the long one). The curve has 4 points [0, 1], [0.05, 0], [0.95, 0] and [1, 1]. When the animation starts playing, the IK takes full effect, but is gradually disabled by point #2. It stays disabled until point #3 towards the end, when it's ''weight'' starts climbing again. At the end, at point #4, the IK is fully on again, overriding all FK.


leftHandIKCurve[] = {};                                //IK OFF.
<syntaxhighlight lang="cpp">
leftHandIKCurve[] = {1};                              //IK fully ON.
leanRRot = 0.57;
leftHandIKCurve[] = {0.1, 1, 0.15, 0};                 //IK fully ON one-tenth into the animation, but disabled soon afterwards.
</syntaxhighlight>
leftHandIKCurve[] = {0, 1, 0.05, 0, 0.95, 0, 1, 1};    //IK ON at start, but soon disabled. Re-enabled towards the end.


==legs==
==== leanRShift ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:''' Found in ''States'', references ''BlendAnims'' class entries. Used for deforming the character on sloping surfaces (hillside, stairs, etc..). Most of the RTM animations have been recorded in a motion capture studio, on a perfectly flat floor. When standing on a slope, the character would normally have one foot sinking into the ground, while the other would be hanging in the air. So BIS devised this system for deforming the bodyparts that have contact with the ground. When standing upright, it's just the legs. When prone, it's most, if not the whole body. Like everything else in ''BlendAnims'', it's a list of bones, with weights (amount of influence) associated.
;Description: See [[#leanLShift | leanLShift]].


legs = "legsDefault";        //Deafault
<syntaxhighlight lang="cpp">
legs = "legsNo";            //DefaultDie
leanRShift = 0.01;
legs = "legsLyingAiming";    //AmovPpneMstpSrasWrflDnon_injured
</syntaxhighlight>
legs = "Wholebody";         //AmovPpneMstpSnonWnonDnon
legs = "empty";              //HaloFreeFall_non


==legsDefault[]==
==== leftHandIKBeg ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:''' ''BlendAnims'' class entry. see above.
;Description: Found in ''States'', appeared in {{Name|arma1|short}}, complemented/superseded in {{Name|arma2|short}} by ''leftHandIKCurve[]''.


legsDefault[] = {"LeftUpLeg", 0.9, "LeftUpLegRoll", 0.9, "LeftLeg", 0.95, "LeftLegRoll", 0.95, "LeftFoot", 1, "LeftToeBase", 1, "RightUpLeg", 0.9, "RightUpLegRoll", 0.9, "RightLeg", 0.95, "RightLegRoll", 0.95, "RightFoot", 1, "RightToeBase", 1};
These properties set whether at the beginning and end of the animation, ''IKs'' for both arms are enabled or not.


==legsNo[]==
''left/right-HandIKCurve[]'' allows for a more complex and detailed control of ''FK/IK'' <sup>(see below for more details)</sup> blending.
[[TokenNameValueTypes|Array]]<br>
'''Description:''' Always empty ''BlendAnims'' class entry, see [[#legs | legs]] above. Disables all deformations on contact with land. Death animations are a typical case.


legsNo[] = {};
Typical uses:
<syntaxhighlight lang="cpp">
leftHandIKBeg = true;
leftHandIKCurve[] = {1};
leftHandIKEnd = true;


==limitFast==
leftHandIKBeg = false;
[[TokenNameValueTypes|Float]]<br>
leftHandIKCurve[] = {};
'''Description:''' Found in ''Actions'', used for limiting the [[#slow.. | slow..]] movements, although the names suggests a limiting of [[#fast.. | fast..]].
leftHandIKEnd = false;


limitFast = 0.5;   //RifleProneActions_injured
leftHandIKBeg = false;
limitFast = 2;      //SwimmingActions
leftHandIKCurve[] = {0, 1, 0.075, 0, 0.725, 0, 0.8, 1};
limitFast = 4;      //class CivilStandActions, SwimmingFastActions
leftHandIKEnd = false;
limitFast = 5;     //NoActions
limitFast = 5.5;   //RifleBaseLowStandActions


==limitGunMovement==
leftHandIKBeg = false;
[[TokenNameValueTypes|Boolean]]<br>
leftHandIKCurve[] = {0.05, 1, 0.125, 0, 0.6, 0, 0.675, 1};
'''Description:''' Found in ''States''.
leftHandIKEnd = true;
</syntaxhighlight>


limitGunMovement = false;    //HealBase
==== leftHandIKEnd ====
limitGunMovement = false;    //SprintBaseDf
;Type: [[TokenNameValueTypes|Boolean]]
limitGunMovement = 0.1;      //AmovPercMstpSnonWnonDnon
;Description: See above.
limitGunMovement = 0.3;      //AovrPercMstpSlowWrflDf
limitGunMovement = 0.6;     //AmovPercMwlkSlowWpstDnon_transition
limitGunMovement = true;     //Default


==looped==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
leftHandIKEnd = 0;
'''Description:''' Found in ''States'', sets whether the current animation should start over once it's finished. Loop, that is.
</syntaxhighlight>


looped = 1;
==== leftHandIKCurve ====
;Type: [[TokenNameValueTypes|Array]]
;Description: As the name suggests, this array describes the curve controlling {{Link|https://en.wikipedia.org/wiki/Forward_kinematics|FK}}/{{Link|https://en.wikipedia.org/wiki/Inverse_kinematics|IK}} blending on the left arm.


==Lying==
Every pair of values describe a 2D point, with the first number representing ''time'' (horizontal) and the second being the ''weight'' (vertical).
[[TokenNameValueTypes|String]]<br>
'''Description:''' Found in ''Actions'', points to the animation to play for the "Prone with weapon" situation. [[#CivilLying | CivilLying]] is the unarmed equivalent.
 
Lying = "AmovPpneMstpSnonWnonDnon";
 
=M=
 
==medic==
[[TokenNameValueTypes|String]]<br>
'''Description:''' Found in ''Actions'', points to the animation to be used by a medic when triggering the "Heal.." action.
 
medic = "AinvPknlMstpSlayWrflDnon_medic";
 
=N=
 
=O=
 
==onLadder==
[[TokenNameValueTypes|Boolean]]<br>
'''Description:''' Found in ''States'', flags the animation as ladder related.
 
onLadder = 1;
 
==onLandBeg==
[[TokenNameValueTypes|Boolean]]<br>
'''Description:''' Found in ''States''. If at the start of the animation the character is lying on the ground (prone), ''onLandBeg'' = true. If at the end of the animation the character is lying on the ground (prone), ''onLandEnd'' = true. Otherwise false. Not sure what these flags are used for.
 
//Default
onLandBeg = false;
onLandEnd = false;
 
//AmovPercMstpSrasWrflDnon_AmovPpneMstpSrasWrflDnon
onLandBeg = false;
onLandEnd = true;
 
//AmovPpneMstpSrasWrflDnon_AmovPercMstpSrasWrflDnon
onLandBeg = true;
onLandEnd = false;
 
//AmovPpneMstpSrasWrflDnon_AmovPpneMstpSrasWpstDnon
onLandBeg = true;
onLandEnd = true;
 
//AdthPpneMstpSnonWnonDnonB
onLandEnd = true;
onLandBeg = false;
 
==onLandEnd==
[[TokenNameValueTypes|Boolean]]<br>
'''Description:''' See above.
 
onLandEnd = 1;
 
=P=
 
==PlayerCrouch==
[[TokenNameValueTypes|String]]<br>
'''Description:'''
 
PlayerCrouch = "AmovPknlMstpSrasWlnrDnon";
 
==PlayerProne==
[[TokenNameValueTypes|String]]<br>
'''Description:'''
 
PlayerProne = "AmovPpneMstpSnonWnonDnon";
 
==PlayerStand==
[[TokenNameValueTypes|String]]<br>
'''Description:'''
 
PlayerStand = "AwopPercMstpSoptWbinDnon_rfl";
 
==predictSpeedCoef==
[[TokenNameValueTypes|Float]]<br>
'''Description:'''
 
predictSpeedCoef = 1;
 
==preload==
[[TokenNameValueTypes|Boolean]]<br>
'''Description:'''
 
preload = 1;
 
==primaryActionMaps[]==
[[TokenNameValueTypes|Array]]<br>
'''Description:'''
 
primaryActionMaps[] = {"DeadActions","LauncherKneelActions","BinocProneRflActions","BinocProneCivilActions","RifleProneActions","PistolProneActions","RifleKneelActions","PistolKneelActions","RifleStandActions","PistolStandActions","RifleLowStandActions","SwimmingActions","CivilStandActions","BinocKneelRflActions","BinocStandRflActions"};
 
==putDown==
[[TokenNameValueTypes|String]]<br>
'''Description:'''
 
putDown = "AmovPpneMstpSrasWrflDnon";


==PutDownEnd==
''Time'' ranges from {{hl|0-1}}, where {{hl|0}} is animation start, {{hl|0.5}} is half way, and {{hl|1}} the end.
[[TokenNameValueTypes|Float]]<br>
'''Description:'''  


PutDownEnd = "";
''Weight'' also ranges from {{hl|0-1}}, where {{hl|0}} means animation is taken from ''RTM'' file (''FK'') and ''IK'' is disabled, {{hl|0.6}} meaning a {{hl|40%}} blend of ''FK'' and {{hl|60%}} ''IK'', and {{hl|1}} is {{hl|100%}} ''IK''.


=Q=
Let me interpret the last example below (the long one). The curve has 4 points {{hl|[0, 1], [0.05, 0], [0.95, 0]}} and {{hl|[1, 1]}}. When the animation starts playing, the ''IK'' takes full effect, but is gradually disabled by point {{hl|#2}}. It stays disabled until point {{hl|#3}} towards the end, when it is ''weight'' starts climbing again. At the end, at point {{hl|#4}}, the ''IK'' is fully on again, overriding all ''FK''.


=R=
<syntaxhighlight lang="cpp">
leftHandIKCurve[] = {}; // IK OFF.
leftHandIKCurve[] = {1}; // IK fully ON.
leftHandIKCurve[] = {0.1, 1, 0.15, 0}; // IK fully ON one-tenth into the animation, but disabled soon afterwards.
leftHandIKCurve[] = {0, 1, 0.05, 0, 0.95, 0, 1, 1}; // IK ON at start, but soon disabled. Re-enabled towards the end.
</syntaxhighlight>


==reloadAT==
==== legs ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''States'', references ''BlendAnims'' class entries. Used for deforming the character on sloping surfaces (hillside, stairs, etc..).


reloadAT = "LauncherReloadKneel";
Most of the ''[[RTM]]'' animations have been recorded in a motion capture studio, on a perfectly flat floor. When standing on a slope, the character would normally have one foot sinking into the ground, while the other would be hanging in the air. So {{Name|bi|short}} devised this system for deforming the bodyparts that have contact with the ground.


==reloadMagazine==
When standing upright, it is just the legs. When prone, it is most, if not the whole body. Like everything else in ''BlendAnims'', it is a list of bones, with weights (amount of influence) associated.
[[TokenNameValueTypes|String]]<br>
'''Description:'''  


reloadMagazine = "WeaponMagazineReloadStand";
<syntaxhighlight lang="cpp">
legs = "legsDefault"; // Deafault
legs = "legsNo"; // DefaultDie
legs = "legsLyingAiming"; // AmovPpneMstpSrasWrflDnon_injured
legs = "Wholebody"; // AmovPpneMstpSnonWnonDnon
legs = "empty"; // HaloFreeFall_non
</syntaxhighlight>


==reloadMGun==
==== legsDefault[] ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:'''  
;Description: ''BlendAnims'' class entry. See above.


reloadMGun = "AmovPpneMstpSrasWrflDnon";
<syntaxhighlight lang="cpp">
legsDefault[] = {"LeftUpLeg", 0.9, "LeftUpLegRoll", 0.9, "LeftLeg", 0.95, "LeftLegRoll", 0.95, "LeftFoot", 1, "LeftToeBase", 1,
"RightUpLeg", 0.9, "RightUpLegRoll", 0.9, "RightLeg", 0.95, "RightLegRoll", 0.95, "RightFoot", 1, "RightToeBase", 1};
</syntaxhighlight>


==reloadMortar==
==== legsNo[] ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:'''  
;Description: Always empty ''BlendAnims'' class entry, see ''[[#legs | legs]]'' above. Disables all deformations on contact with land. Death animations are a typical case.


reloadMortar = "AmovPpneMstpSrasWrflDnon";
<syntaxhighlight lang="cpp">
legsNo[] = {};
</syntaxhighlight>


==relSpeedMax==
==== limitFast ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:'''  
;Description: Found in ''Actions'', used for limiting the ''[[#slow.. | slow..]]'' movements, although the names suggests a limiting of ''[[#fast.. | fast..]]''.


relSpeedMax = 0.6;
<syntaxhighlight lang="cpp">
limitFast = 0.5; // RifleProneActions_injured
limitFast = 2; // SwimmingActions
limitFast = 4; // class CivilStandActions, SwimmingFastActions
limitFast = 5; // NoActions
limitFast = 5.5; // RifleBaseLowStandActions
</syntaxhighlight>


==relSpeedMin==
==== limitGunMovement ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:'''  
;Description: Found in ''States''.


relSpeedMin = 0.5;
<syntaxhighlight lang="cpp">
limitGunMovement = false; // HealBase
limitGunMovement = false; // SprintBaseDf
limitGunMovement = 0.1; // AmovPercMstpSnonWnonDnon
limitGunMovement = 0.3; // AovrPercMstpSlowWrflDf
limitGunMovement = 0.6; // AmovPercMwlkSlowWpstDnon_transition
limitGunMovement = true; // Default
</syntaxhighlight>


==rightHandIKBeg==
==== looped ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:'''  
;Description: Found in ''States'', sets whether the current animation should start over once it is finished. Loop, that is.


rightHandIKBeg = 1;
<syntaxhighlight lang="cpp">
looped = 1;
</syntaxhighlight>


==rightHandIKEnd==
==== Lying ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', points to the animation to play for the "''Prone with weapon''" situation. ''[[#CivilLying | CivilLying]]'' is the unarmed equivalent.


rightHandIKEnd = 1;
<syntaxhighlight lang="cpp">
Lying = "AmovPpneMstpSnonWnonDnon";
</syntaxhighlight>


==rightHandIKCurve==
=== M ===
[[TokenNameValueTypes|Array]]<br>
==== medic ====
'''Description:'''  
;Type: [[TokenNameValueTypes|String]]
See [[CfgMoves_Config_Reference#leftHandIKCurve]].
;Description: Found in ''Actions'', points to the animation to be used by a medic when triggering the "''Heal..''" action.


rightHandIKCurve[] = {};                                //IK OFF.
<syntaxhighlight lang="cpp">
rightHandIKCurve[] = {1};                               //IK fully ON.
medic = "AinvPknlMstpSlayWrflDnon_medic";
rightHandIKCurve[] = {0.1, 1, 0.15, 0};                //IK fully ON one-tenth into the animation, but disabled soon afterwards.
</syntaxhighlight>
rightHandIKCurve[] = {0, 1, 0.05, 0, 0.95, 0, 1, 1};    //IK ON at start, but soon disabled. Re-enabled towards the end.


=S=
=== O ===
==== onLadder ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', flags the animation as ladder related.


==salute==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
onLadder = 1;
'''Description:'''
</syntaxhighlight>


salute = "AmovPercMstpSlowWrflDnon";
==== onLandBeg ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States''. If at the start of the animation the character is lying on the ground (prone), ''onLandBeg'' equals ''true''. If at the end of the animation the character is lying on the ground (prone), ''onLandEnd'' equals ''true''. Otherwise false. Not sure what these flags are used for.


==showHandGun==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
//Default
'''Description:'''
onLandBeg = false;
onLandEnd = false;


showHandGun = 1;
//AmovPercMstpSrasWrflDnon_AmovPpneMstpSrasWrflDnon
onLandBeg = false;
onLandEnd = true;


==showItemInHand==
//AmovPpneMstpSrasWrflDnon_AmovPercMstpSrasWrflDnon
[[TokenNameValueTypes|Boolean]]<br>
onLandBeg = true;
'''Description:'''
onLandEnd = false;


showItemInHand = 1;
//AmovPpneMstpSrasWrflDnon_AmovPpneMstpSrasWpstDnon
onLandBeg = true;
onLandEnd = true;


==showItemInRightHand==
//AdthPpneMstpSnonWnonDnonB
[[TokenNameValueTypes|Boolean]]<br>
onLandEnd = true;
'''Description:'''
onLandBeg = false;
</syntaxhighlight>


showItemInRightHand = 0;
==== onLandEnd ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: See above.


==showWeaponAim==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
onLandEnd = 1;
'''Description:'''
</syntaxhighlight>


showWeaponAim = 1;
=== P ===
==== PlayerCrouch ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions''. Similar to ''[[#Crouch | Crouch]]'', except it applies only to player characters and not ''AI''.


==sitDown==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
PlayerCrouch = "AmovPknlMstpSrasWlnrDnon";
'''Description:'''
</syntaxhighlight>


sitDown = "AmovPsitMstpSnonWpstDnon_ground";
==== PlayerProne ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions''. Similar to ''[[#Lying | Lying]]'', except it applies only to player characters and not ''AI''.


==skeletonName==
Sets the animation to be used when going prone.
[[TokenNameValueTypes|String]]<br>
'''Description:'''


skeletonName = "OFP2_ManSkeleton";
<syntaxhighlight lang="cpp">
PlayerProne = "AmovPpneMstpSnonWnonDnon";
</syntaxhighlight>


==slowB==
==== PlayerStand ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions''. Similar to ''[[#Stand | Stand]]'', except it applies only to player characters and not ''AI''.


slowB = "AmovPercMrunSlowWlnrDb";
Sets the animation to be used when standing upright.


==slowF==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
PlayerStand = "AwopPercMstpSoptWbinDnon_rfl";
'''Description:'''
</syntaxhighlight>


slowF = "AmovPercMevaSlowWlnrDf";
==== predictSpeedCoef ====
;Type: [[TokenNameValueTypes|Float]]
;Description: Disused in {{Name|arma2|short}}, appears once in {{Name|arma1|short}}.


==slowL==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
predictSpeedCoef = 1;
'''Description:'''
</syntaxhighlight>


slowL = "AmovPercMrunSlowWlnrDl";
==== preload ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', sets whether to load the animation file (''[[RTM]]'') into memory at game start, or just read it from disc when there's a demand for it.


==slowLB==
All animations are set not to preload in {{Name|arma2|short}}, while in {{Name|arma1|short}} some often used animations like running for example, are preloaded.
[[TokenNameValueTypes|String]]<br>
'''Description:'''


slowLB = "AmovPercMrunSlowWlnrDbl";
<syntaxhighlight lang="cpp">
preload = 1;
</syntaxhighlight>


==slowLF==
==== primaryActionMaps[] ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:'''
;Description: Outlines the main action groups.


slowLF = "AmovPercMrunSlowWlnrDfl";
<syntaxhighlight lang="cpp">
primaryActionMaps[] = {"DeadActions", "LauncherKneelActions", "BinocProneRflActions", "BinocProneCivilActions",
"RifleProneActions", "PistolProneActions", "RifleKneelActions", "PistolKneelActions", "RifleStandActions",
"PistolStandActions", "RifleLowStandActions", "SwimmingActions", "CivilStandActions",
"BinocKneelRflActions", "BinocStandRflActions"};
</syntaxhighlight>


==slowR==
==== putDown ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions''. Sets the animation to be used when the character puts something on the ground (e.g. dropping some equipment).


slowR = "AmovPercMrunSlowWlnrDr";
<syntaxhighlight lang="cpp">
putDown = "AmovPpneMstpSrasWrflDnon";
</syntaxhighlight>


==slowRB==
==== PutDownEnd ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:'''
;Description: Not used in the {{Name|arma1|short}} series.


slowRB = "AmovPercMrunSlowWlnrDbr";
<syntaxhighlight lang="cpp">
PutDownEnd = "";
</syntaxhighlight>


==slowRF==
=== R ===
[[TokenNameValueTypes|String]]<br>
==== reload... ====
'''Description:'''  
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions''. Default actions for reloading are ''reloadMagazine'', ''reloadAT'', ''reloadMGun'' and ''reloadMortar'', but addon makers can add their own if they wish.


slowRF = "AswmPercMrunSnonWnonDf";
These actions are invoked in ''CfgWeapons'' and ''CfgMagazines'' via '''reloadAction'''. Most reload actions for upright stances in {{Name|arma2|short}} are bone-masked, they are configured as ''Gestures''.


==soundEdge1==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Float]]<br>
//game
'''Description:'''
reloadAT = "LauncherReloadKneel";
reloadMagazine[] = {"WeaponMagazineReloadStand", "Gesture"};
reloadMGun = "AmovPpneMstpSrasWrflDnon";
reloadMortar = "AmovPpneMstpSrasWrflDnon";


soundEdge1 = 0.45;
//custom
reloadM1Garand[] = {"M1GarandMagazineReloadStand", "Gesture"};
//CfgWeapons/CfgMagazines
reloadAction = "ManActReloadM1Garand";
</syntaxhighlight>


==soundEdge2==
==== relSpeedMax ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:'''  
;Description: Found in ''States''.


soundEdge2 = 1;
<syntaxhighlight lang="cpp">
relSpeedMax = 0.6;
</syntaxhighlight>


==soundEnabled==
==== relSpeedMin ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:'''  
;Description: Found in ''States''.


soundEnabled = 1;
<syntaxhighlight lang="cpp">
relSpeedMin = 0.5;
</syntaxhighlight>


==soundOverride==
==== rightHandIKBeg ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:'''  
;Description: See ''[[#leftHandIKBeg | leftHandIKBeg]]''.


soundOverride = "bodyfall";
<syntaxhighlight lang="cpp">
rightHandIKBeg = 1;
</syntaxhighlight>


==speed==
==== rightHandIKEnd ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:'''  
;Description: See ''[[#leftHandIKBeg | leftHandIKBeg]]''.


speed = 0.00833333;
<syntaxhighlight lang="cpp">
rightHandIKEnd = 1;
</syntaxhighlight>


==Stand==
==== rightHandIKCurve ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:'''  
;Description: See ''[[#leftHandIKCurve | leftHandIKCurve]]''.


Stand = "AmovPknlMstpSrasWrflDnon";
<syntaxhighlight lang="cpp">
rightHandIKCurve[] = {}; // IK OFF.
rightHandIKCurve[] = {1}; // IK fully ON.
rightHandIKCurve[] = {0.1, 1, 0.15, 0}; // IK fully ON one-tenth into the animation, but disabled soon afterwards.
rightHandIKCurve[] = {0, 1, 0.05, 0, 0.95, 0, 1, 1}; // IK ON at start, but soon disabled. Re-enabled towards the end.
</syntaxhighlight>


==startSwim==
=== S ===
[[TokenNameValueTypes|String]]<br>
==== salute.. ====
'''Description:'''  
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', ''salute'' points to the animation the character will transition to when saluting, while ''saluteOff'' points to the animation the character should return to when done saluting.


startSwim = "AswmPercMrunSnonWnonDf";
Neither of these properties point to the transition animations, where the character is actually raising/lowering it is arm.


==stop==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
salute = "AmovPercMstpSlowWrflDnon_salute";
'''Description:'''
saluteOff = "AmovPercMstpSlowWrflDnon";
</syntaxhighlight>


stop = "AinvPknlMstpSlayWrflDnon";
==== showHandGun ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', sets pistol visibility on/off.


==stop==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
showHandGun = 1;
'''Description:'''
</syntaxhighlight>


stop = "AwopPercMstpSoptWbinDnon_non";
==== showItemInHand ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', sets item (''binoculars'', specifically) visibility on/off.


==StopRelaxed==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
showItemInHand = 1;
'''Description:'''
</syntaxhighlight>


StopRelaxed = "AidlPercMstpSlowWrflDnon01";
==== showItemInRightHand ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', sets item (''binoculars'', specifically) visibility on/off in the right hand. Looks it is not working on Arma 3.


==stopSwim==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
showItemInRightHand = 0;
'''Description:'''
</syntaxhighlight>


stopSwim = "AmovPercMstpSnonWnonDnon";
==== showWeaponAim ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', sets whether ''crosshairs'' are displayed or not for given animation.


==StrokeFist==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Float]]<br>
showWeaponAim = 1;
'''Description:'''
</syntaxhighlight>


StrokeFist = "";
==== sitDown ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', points to the animation to transition to when the sitting action is triggered. Not the ''to'' and ''from'' transition animations, but the sitting idle.


==strokeGun==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
SitDown = ""; // RifleStandSaluteActions_Idle - can't sit down while saluting
'''Description:'''
sitDown = "AmovPsitMstpSlowWrflDnon";
</syntaxhighlight>


strokeGun = "AmovPercMstpSnonWnonDnon";
==== skeletonName ====
;Type: [[TokenNameValueTypes|String]]
;Description: Sets the skeleton to be used.


=T=
<syntaxhighlight lang="cpp">
skeletonName = "OFP2_ManSkeleton";
skeletonName = "WomanSkeleton";
</syntaxhighlight>


==takeFlag==
==== slow.. ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: See ''[[#fast.. | fast..]]''.


takeFlag = "AinvPknlMstpSlayWrflDnon";
<syntaxhighlight lang="cpp">
slowB = "AmovPercMrunSlowWlnrDb";
slowF = "AmovPercMevaSlowWlnrDf";
slowL = "AmovPercMrunSlowWlnrDl";
slowLB = "AmovPercMrunSlowWlnrDbl";
slowLF = "AmovPercMrunSlowWlnrDfl";
slowR = "AmovPercMrunSlowWlnrDr";
slowRB = "AmovPercMrunSlowWlnrDbr";
slowRF = "AswmPercMrunSnonWnonDf";
</syntaxhighlight>


==terminal==
==== soundEdge.. ====
[[TokenNameValueTypes|Boolean]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:'''  
;Description: Found in ''States''. Deprecated forms ''soundEdge1'', ''soundEdge2'' (used very little in {{Name|arma1|short}}, not at all in {{Name|arma2|short}}).


terminal = 1;
Used for sound timing during an animation. If there's a sound file associated with the animation, it won't play right away as the animation starts. It will play when and as many times as ''soundEdge'' tells it to.


==TestDriver==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
soundEdge[] = {0.5, 1}; // Default
'''Description:'''
soundEdge[] = {0.45}; // DefaultDie
soundEdge[] = {0.25, 0.5, 0.75, 1}; // AmovPercMwlkSlowWrflDf - timing of the 4 footstep sounds


TestDriver = "BasicDriver";
//old
soundEdge1 = 0.5;
soundEdge2 = 1;
</syntaxhighlight>


==TestDriverOut==
==== soundEnabled ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:'''  
;Description: Found in ''States'', enables/disables sounds being played with the animation.


TestDriverOut = "BasicDriverOut";
<syntaxhighlight lang="cpp">
soundEnabled = 1;
</syntaxhighlight>


==TestGunner==
==== soundOverride ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''States'', points to the actual sound to play with the animation.


TestGunner = "BasicSittingGunner";
<syntaxhighlight lang="cpp">
soundOverride = "bodyfall";
</syntaxhighlight>


==throwGrenade==
==== speed ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:'''  
;Description: Found in ''States'', sets the animation playback speed.


throwGrenade = "AmovPercMrunSlowWpstDf_AmovPercMstpSrasWpstDnon_gthThrow";
Note that speed depends on animation length, on the number of frames it contains.


==transitionsDisabled[]==
For example, setting speed at {{hl|0.5}} for a 50 frames long animation will result in it playing at about 25 frames per second. Setting the same speed for a 300 frame animation, will result in that animation playing much faster. ''Speed'', seems to me more akin to duration.
[[TokenNameValueTypes|Array]]<br>
'''Description:'''  


transitionsDisabled[] = {};
<syntaxhighlight lang="cpp">
speed = 0.00833333;
</syntaxhighlight>


==transitionsInterpolated[]==
==== stand ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', see ''[[#playerStand | playerStand]]''.


transitionsInterpolated[] = {};
<syntaxhighlight lang="cpp">
Stand = "AmovPknlMstpSrasWrflDnon";
</syntaxhighlight>


==transitionsSimple[]==
==== startSwim ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', points to the animation to be used when starting to swim.


transitionsSimple[] = {};
<syntaxhighlight lang="cpp">
startSwim = "AswmPercMrunSnonWnonDf";
</syntaxhighlight>


==treated==
==== stop ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', points to the animation to be used when stopping.


treated = "AinvPknlMstpSlayWrflDnon_healed";
<syntaxhighlight lang="cpp">
stop = "AinvPknlMstpSlayWrflDnon";
</syntaxhighlight>


==turnL==
==== stopRelaxed ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', points to the animation to be used when stopping with weapon lowered ("''SAFE''" behaviour).


turnL = "AmovPercMstpSlowWrflDnon_turnL";
<syntaxhighlight lang="cpp">
StopRelaxed = "AidlPercMstpSlowWrflDnon01";
</syntaxhighlight>


==turnLRelaxed==
==== stopSwim ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', points to the animation to be used when ending swimming.


turnLRelaxed = "AmovPercMstpSlowWrflDnon_turnL";
<syntaxhighlight lang="cpp">
stopSwim = "AmovPercMstpSnonWnonDnon";
</syntaxhighlight>


==turnR==
==== strokeFist ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Float]]
'''Description:'''  
;Description: Found in ''Actions'', not really used. Has been around since {{Name|ofp|short}} if I remember correctly, probably an attempt to introduce fist fighting, but then abandoned.


turnR = "AmovPpneMstpSrasWrflDnon_turnR";
<syntaxhighlight lang="cpp">
StrokeFist = "";
</syntaxhighlight>


==turnRRelaxed==
==== strokeGun ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Similar to ''strokeFist'' above, attempt at melee fighting but not used.


turnRRelaxed = "AmovPpneMstpSrasWrflDnon_turnR";
<syntaxhighlight lang="cpp">
strokeGun = "AmovPercMstpSnonWnonDnon";
</syntaxhighlight>


==turnSpeed==
=== T ===
[[TokenNameValueTypes|Float]]<br>
==== takeFlag ====
'''Description:'''  
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', points to the animation to be used when taking the flag during a ''CTF'' match.


turnSpeed = 0.1;
<syntaxhighlight lang="cpp">
takeFlag = "AinvPknlMstpSlayWrflDnon";
</syntaxhighlight>


=U=
==== terminal ====
;Type: [[TokenNameValueTypes|Boolean]]
;Description: Found in ''States'', flags the animation as being "''terminal''". ''True'' for death animations, ''false'' for everything else.


==untiltWeapon==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
terminal = 1;
'''Description:'''
</syntaxhighlight>


untiltWeapon = "untiltWeaponDefault";
==== testDriver ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', along with ''testDriverOut'' and ''TestGunner''. "''Test''" suggests it might have been just that, an experiment during development.


==untiltWeaponDefault[]==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Array]]<br>
//class ManActions
'''Description:'''
TestDriver = "BasicDriver";
TestDriverOut = "BasicDriverOut";
TestGunner = "BasicSittingGunner";
</syntaxhighlight>


untiltWeaponDefault[] = {};
==== testDriverOut ====
;Type: [[TokenNameValueTypes|String]]
;Description: See above.


==up==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
TestDriverOut = "BasicDriverOut";
'''Description:'''
</syntaxhighlight>


up = "AmovPercMstpSnonWnonDnon";
==== testGunner ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#testDriver | testDriver]]''.


==upDegree==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
TestGunner = "BasicSittingGunner";
'''Description:'''
</syntaxhighlight>


upDegree = "ManPosBinoc";
==== throwGrenade ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', points to the animation to be used when throwing a grenade.


==useFastMove==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|Boolean]]<br>
throwGrenade = "AmovPercMrunSlowWpstDf_AmovPercMstpSrasWpstDnon_gthThrow";
'''Description:'''
</syntaxhighlight>


useFastMove = 1;
==== transitionsDisabled[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Empty array in both {{Name|arma1|short}} & {{Name|arma2|short}}. No apparent use for it.


=V=
<syntaxhighlight lang="cpp">
transitionsDisabled[] = {};
</syntaxhighlight>


==variantAfter[]==
==== transitionsInterpolated[] ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:'''
;Description: Empty array in both {{Name|arma1|short}} & {{Name|arma2|short}}. No apparent use for it.


variantAfter[] = {20,40,100};
<syntaxhighlight lang="cpp">
transitionsInterpolated[] = {};
</syntaxhighlight>


==variantsAI[]==
==== transitionsSimple[] ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|Array]]
'''Description:'''
;Description: Empty array in both {{Name|arma1|short}} & {{Name|arma2|short}}. No apparent use for it.


variantsAI[] = {"AidlPpneMstpSrasWrflDnon0S",0.7,"AidlPpneMstpSrasWrflDnon01",0.1,"AidlPpneMstpSrasWrflDnon02",0.1,"AidlPpneMstpSrasWrflDnon03",0.1};
<syntaxhighlight lang="cpp">
transitionsSimple[] = {};
</syntaxhighlight>


==variantsPlayer[]==
==== treated ====
[[TokenNameValueTypes|Array]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', points to the animation to be used when being healed by a medic. Medic will be using animation defined in ''[[#medic | medic]]''.


variantsPlayer[] = {"AdthPercMrunSlowWlnrDf_1",0.5,"AdthPercMrunSlowWlnrDf_2",0.5};
<syntaxhighlight lang="cpp">
treated = "AinvPknlMstpSlayWrflDnon_healed";
</syntaxhighlight>


==visibleSize==
==== turn... ====
[[TokenNameValueTypes|Float]]<br>
;Type: [[TokenNameValueTypes|String]]
'''Description:'''  
;Description: Found in ''Actions'', ''turnL'' and ''turnR'' define the turning animations, while ''turnLRelaxed'' and ''turnRRelaxed'' do the same thing for the "''relaxed''" (weapon lowered, behaviour "''SAFE''") modes.


visibleSize = 0.25;
<syntaxhighlight lang="cpp">
turnL = "AmovPercMstpSlowWrflDnon_turnL";
turnLRelaxed = "AmovPercMstpSlowWrflDnon_turnL";
turnR = "AmovPpneMstpSrasWrflDnon_turnR";
turnRRelaxed = "AmovPpneMstpSrasWrflDnon_turnR";
</syntaxhighlight>


=W=
==== turnSpeed ====
;Type: [[TokenNameValueTypes|Float]]
;Description: Found in ''Actions'', sets turning speed.


==walkB==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
turnSpeed = 0.1;
'''Description:'''
</syntaxhighlight>


walkB = "AmovPercMwlkSlowWrflDb";
=== U ===
==== untiltWeapon ====
;Type: [[TokenNameValueTypes|String]]
;Description: Not found in {{Name|arma2|short}}, and not really used in {{Name|arma1|short}} either.


==walkF==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
untiltWeapon = "untiltWeaponDefault";
'''Description:'''
</syntaxhighlight>


walkF = "AmovPercMevaSlowWlnrDf";
==== untiltWeaponDefault[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Same as above.


==walkL==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
untiltWeaponDefault[] = {};
'''Description:'''
</syntaxhighlight>


walkL = "AmovPercMwlkSlowWrflDl";
==== up ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions''. Together with ''[[#down | down]]'' sets up what looks like a standing/kneeling/prone toggle. Which I don't think is used in the game's current control scheme.


==walkLB==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
up = "AmovPknlMstpSlowWrflDnon"; // RifleBaseLowStandActions
'''Description:'''
up = "AmovPknlMstpSrasWrflDnon"; // RifleBaseStandActions
up = "AmovPknlMwlkSlowWrflDf"; // RifleLowStandActionsWlkF
up = "AmovPercMstpSrasWrflDnon"; // RifleKneelActions
</syntaxhighlight>


walkLB = "AmovPercMwlkSlowWrflDbl";
==== upDegree ====
;Type: [[TokenNameValueTypes|String]]
;Description: Found in ''Actions'', seems to define the "''upright''" stance for each action group.


==walkLF==
These "''ManPos..''" things only appear in root {{hl|/Dta/bin/config.bin}}, where they get some equivalent numbers, and that's it. Important to get right though when creating custom action sets.
[[TokenNameValueTypes|String]]<br>
'''Description:'''  


walkLF = "AswmPercMwlkSnonWnonDf";
<syntaxhighlight lang="cpp">
upDegree = 0; // NoActions
upDegree = -1; // NoActions, ParachuteFreeFall
upDegree = "ManPosDead"; // DeadActions
upDegree = "ManPosStand"; // RifleBaseLowStandActions
upDegree = "ManPosCombat"; // RifleBaseStandActions
upDegree = "ManPosCrouch"; // RifleKneelEvasiveActions, RifleKneelActions
upDegree = "ManPosLying"; // RifleProneActions
upDegree = "ManPosHandGunStand";
upDegree = "ManPosHandGunCrouch";
upDegree = "ManPosHandGunLying";
upDegree = "ManPosNoWeapon"; // CivilStandActions
upDegree = "ManPosLyingNoWeapon";
upDegree = "ManPosWeapon"; // LauncherKneelActions
upDegree = "ManPosBinocStand"; // BinocStandLnrActions
upDegree = "ManPosSwimming";
upDegree = "ManPosBinocStand";
upDegree = "ManPosBinoc";
updegree = "ManPosCrouch";
//enum in root config
enum {
MANPOSNOWEAPON = 12,
CPCOMMANDER = 2,
CMD_STAY_BACK = 4,
CMD_MOVE = 12,
CMD_FIRE = 27,
CMD_WATCH = 28,
CMD_REPLY_FAIL = 64,
CMD_REPORT = 68,
...
MANPOSHANDGUNSTAND = 9,
...
MANPOSCROUCH = 6,
...
MANPOSHANDGUNLYING = 5,
MANPOSHANDGUNCROUCH = 7,
MANPOSBINOCSTAND = 14,
...
MANPOSDEAD = 0,
MANPOSCOMBAT = 8,
...
MANPOSBINOCLYING = 2,
MANPOSSTAND = 10,
MANPOSSWIMMING = 11,
COMPARTMENT3 = 4,
CMD_ACTION = 2,
CMD_FORM_ECHLEFT = 16,
...
MANPOSWEAPON = 1,
...
MANPOSLYING = 4,
...
MANPOSLYINGNOWEAPON = 3,
MANPOSBINOC = 13,
...
};
</syntaxhighlight>


==walkR==
==== useFastMove ====
[[TokenNameValueTypes|String]]<br>
;Type: [[TokenNameValueTypes|Boolean]]
'''Description:'''  
;Description: Found in ''Actions''. ''True'' for action sets containing "''Evasive''" in the classname, so an obscure flag of some sorts in {{Name|arma1|short}}. Not used in any significant way in {{Name|arma2|short}}.


walkR = "AmovPpneMrunSnonWnonDr";
<syntaxhighlight lang="cpp">
useFastMove = 1;
</syntaxhighlight>


==walkR==
=== V ===
[[TokenNameValueTypes|String]]<br>
==== variantAfter[] ====
'''Description:'''  
;Type: [[TokenNameValueTypes|Array]]
;Description: Found in ''States'' when there are several variations on the same animation (usually idles) that can be played randomly.


walkR = "AswmPercMstpSnonWnonDnon";
Minimum, average and maximum - these are the inputs for the random number generator, similar to how trigger timeout/countdown works in the ''mission editor''.


==walkRB==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
variantAfter[] = {5, 10, 20}; // Default
'''Description:'''
VariantAfter[] = {5, 5, 5}; // AinvPknlMstpSnonWnonDnon_medic0S
variantAfter[] = {2, 3, 5}; // AidlPercMstpSlowWrflDnon_player_0S
variantAfter[] = {0, 0, 0}; // AidlPercMstpSrasWrflDnon_aiming0S
</syntaxhighlight>


walkRB = "AmovPercMwlkSlowWrflDbr";
==== variantsAI[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Found in ''States'' when there are several variations on the same animation (usually idles) that can be played randomly.


==walkRF==
It lists the animations to be randomly cycled. The numbers represent the probability of that animation being played, the higher the number, the more likely the animation will get to play.
[[TokenNameValueTypes|String]]<br>
'''Description:'''


walkRF = "AmovPercMwlkSlowWrflDfr";
The sum of these numbers is always {{hl|1}}.


==weaponOff==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
//Default
'''Description:'''
variantsAI[] = {""};
//AidlPercMstpSnonWnonDnon
variantsAI[] = {"AidlPercMstpSnonWnonDnon01", 0.01,
"AidlPercMstpSnonWnonDnon02", 0.01,
"AidlPercMstpSnonWnonDnon03", 0.01,
"AidlPercMstpSnonWnonDnon04", 0.01,
"AidlPercMstpSnonWnonDnon05", 0.01,
"AidlPercMstpSnonWnonDnon06", 0.01,
"AidlPercMstpSnonWnonDnon07", 0.01,
"AidlPercMstpSnonWnonDnon08", 0.01,
"AidlPercMstpSnonWnonDnon_idleSteady04", 0.23,
"AidlPercMstpSnonWnonDnon_idleSteady03", 0.23,
"AidlPercMstpSnonWnonDnon_idleSteady02", 0.23,
"AidlPercMstpSnonWnonDnon_idleSteady01", 0.23};
//ActsPsitMstpSnonWnonDnon_varSittingOnTheWall
variantsAI[] = {"Mi17_Cargo02", 0.4, "Mi17_Cargo02_V1", 0.1, "Mi17_Cargo02_V2", 0.1, "Mi17_Cargo02_V3", 0.1,
"Mi17_Cargo02_V4", 0.1, "Mi17_Cargo02_V5", 0.1, "Mi17_Cargo02_V6", 0.1};
//aidlpercmstpsraswlnrdnon_S
variantsAI[] = {"aidlpercmstpsraswlnrdnon_1", 0.333, "aidlpercmstpsraswlnrdnon_2", 0.333, "aidlpercmstpsraswlnrdnon_3", 0.334};
</syntaxhighlight>


weaponOff = "AmovPercMstpSnonWnonDnon";
==== variantsPlayer[] ====
;Type: [[TokenNameValueTypes|Array]]
;Description: Same as '''variantsAI[]''' above, except for player characters.


==weaponOn==
<syntaxhighlight lang="cpp">
[[TokenNameValueTypes|String]]<br>
variantsPlayer[] = {"AdthPercMrunSlowWlnrDf_1", 0.5, "AdthPercMrunSlowWlnrDf_2", 0.5};
'''Description:'''
</syntaxhighlight>


weaponOn = "AmovPknlMstpSrasWlnrDnon";
==== visibleSize ====
;Type: [[TokenNameValueTypes|Float]]
;Description: Found in ''States'', probably used for calculating how visible a character is for the ''AI'', based on his stance/animation.


=X=
<syntaxhighlight lang="cpp">
visibleSize = 1.00012; // SprintBaseDf when sprinting more visible than..
visibleSize = 0.700121; // AmovPercMstpSrasWrflDnon ..when stopped > visible than..
visibleSize = 0.300122; // AmovPknlMstpSlowWrflDnon ..when kneeling > visible than..
visibleSize = 0.100123; // AmovPpneMstpSrasWrflDnon ..when prone.
</syntaxhighlight>


=Y=
=== W ===
==== walk.. ====
;Type: [[TokenNameValueTypes|String]]
;Description: See ''[[#fast.. | fast..]]''.


=Z=
<syntaxhighlight lang="cpp">
walkB = "AmovPercMwlkSlowWrflDb";
walkF = "AmovPercMevaSlowWlnrDf";
walkL = "AmovPercMwlkSlowWrflDl";
walkLB = "AmovPercMwlkSlowWrflDbl";
walkLF = "AswmPercMwlkSnonWnonDf";
walkR = "AmovPpneMrunSnonWnonDr";
walkR = "AswmPercMstpSnonWnonDnon";
walkRB = "AmovPercMwlkSlowWrflDbr";
walkRF = "AmovPercMwlkSlowWrflDfr";
</syntaxhighlight>


=Namespace of anim classes and files =
==== weaponOff ====
;Type: [[TokenNameValueTypes|String]]
;Description: The opposite of ''weaponOn'' below.


A...P...M...S...W...D[_A...P...M...S...W...D][_Comment]
<syntaxhighlight lang="cpp">
weaponOff = "AmovPercMstpSrasWrflDnon";
</syntaxhighlight>


'''A''': Description of the animation type, ie: mov for movement, cts for cutscene<br>
==== weaponOn ====
'''P''': Stance: erc for erected, knl for kneel, pne for prone<br>
;Type: [[TokenNameValueTypes|String]]
'''M''': Speed of animation: stp for stopped, wlk for walk, run for runnin, eva for evasive<br>
;Description: Found in ''States'', and references the animation that needs to be reached when switching to ''RPGs/MANPADS''.
'''S''': Weapon holding: low for lowered, ras for raised<br>
'''W''': Weapon: non for unarmed, pst for pistol, lnr for launcher, rfl for rifle.<br>
'''D''': Direction of movement: non for no direction, f for forward, etc.<br>


If there is a second movement definition named [_A...P...M...S...W...D] after the first one, the animation is a transition from the first animation to the second.
<syntaxhighlight lang="cpp">
weaponOn = "AmovPknlMstpSrasWlnrDnon"; // RifleBaseLowStandActions
weaponOff = "AmovPercMstpSrasWrflDnon";


[_Comment]: additional comments, if required
weaponOn = "AmovPknlMstpSrasWlnrDnon"; // RifleKneelActions
Example:
weaponOff = "AmovPknlMstpSrasWrflDnon";


'''A'''mov'''P'''pne'''M'''stp'''S'''non'''W'''non'''D'''non
weaponOn = "AmovPknlMstpSrasWlnrDnon"; // RifleProneActions
weaponOff = "AmovPpneMstpSrasWrflDnon";
</syntaxhighlight>


means: Movement - Prone - Stopped - civil (no weapon) - no direction (due to being static)
{{ConfigPage|end}}


[[category:Operation Flashpoint: Editing]]
{{GameCategory|ofp|Editing}}
[[Category:ArmA: Addon Configuration]]
{{GameCategory|arma1|Addon Configuration}}
[[Category:Moves|{{uc:{{PAGENAME}}}}]]
{{GameCategory|ofp|Reference Lists}}

Latest revision as of 15:27, 27 February 2024

Introduction

cfgMoves is the nerve center of all skeletal character animation. The animation of human characters that is - not the simple, procedural animation of objects (e.g. raising/lowering a barrier, opening/closing of an aircraft canopy).

cfgMoves has two major sections: Actions and States.

Actions

It is where the character animation state machine is set up. It's a bit confusing that BI called the animation state handler "Actions", and the actions are called "States", but this is what it is.

What this thing does, is configure all the possible animation states (e.g. standing upright with a rifle, kneeling with a pistol, parachuting), and define for each of them which animations can be played in and from that given state.

For instance, from the kneeling with a pistol state (PistolKneelActions), you cannot directly go into crawling forward on your stomach with a rifle (even if you have a rifle). First you would have to holster the pistol and grab your rifle, then lie down, or viceversa. Similarly, if you're prone (whether unarmed, or armed with a pistol or rifle), you cannot salute - first you'd have to stand up.

What animation can or cannot be played, in what situation, is set up here in Actions. Player input (key presses, clicks) are then directed to this state machine, which interprets them and decides what action/animation the avatar will perform next, according to these rules. Same rules apply to AI players.

States

In this section, each animation file (RTM) has a corresponding entry. Animation properties, such as playback speed, interpolation rules, blending times, collision shapes to use during animation, etc.., are configured here.

These animations are the ones referenced in the Actions section above. While Actions represents a complex graph, States is more like a list of items, even though some rules are also set up here (see the ConnectTo[] and InterpolateTo[] properties).

cfgGestures is similar to States, it holds the bone-masked or layered animations introduced in Arma 2. Welcome to reloading-while-running.

Namespace of anim classes and files

A...P...M...S...W...D[_A...P...M...S...W...D][_Comment]

A: Description of the animation type, i.e.: mov for movement, cts for cutscene

P: Stance: erc for erected, knl for kneel, pne for prone

M: Speed of animation: stp for stopped, wlk for walk, run for running, eva for evasive

S: Weapon holding: low for lowered, ras for raised

W: Weapon: non for unarmed, pst for pistol, lnr for launcher, rfl for rifle.

D: Direction of movement: non for no direction, f for forward, etc.

If there is a second movement definition named [_A...P...M...S...W...D] after the first one, the animation is a transition from the first animation to the second.

[_Comment]: additional comments, if required.

Example: AmovPpneMstpSnonWnonDnon means: Movement - Prone - Stopped - civil (no weapon) - no direction (due to being static).

Alphabetical Order

A

access

Type
Integer
Description
See access (CfgVehicles).
access = 3;

actions

Type
String
Description
Sets the action class/group to which this state belongs to.
actions = "PistolStandActionsRunR";
actions = "RifleStandActions";
actions = "InjuredManActionsnon_norot";
actions = "SitActions";

aiming

Type
String
Description
This property references BlendAnims class entries to use when aiming up/down. These are sets of named selections, with weights associated to them, defining how much should the bodyparts move while aiming.

Notice how for instance aimingDefault[] sets up increasing weights for bones: Spine (0.3), Spine1 (0.4), Spine2 (0.5), Spine3/Head/Neck (0.6), shoulders and upper arms (0.8) and finally forearms, hands and weapons (1). This makes for a smooth arching of the body while aiming.

aiming = "empty";
aiming = "aimingDefault";
aiming = "aimingNo";
aiming = "aimingCivil";
aiming = "aimingLying";
aiming = "aimingPistol";
aiming = "aimingLauncher";

aimingDefault[]

Type
Array
Description
BlendAnims array, see aiming above.
aimingDefault[] = {"head", 0.6, "neck1", 0.6, "neck", 0.6, "weapon", 1, "launcher", 1, "LeftShoulder", 0.8, "LeftArm", 0.8, "LeftArmRoll", 1,
	"LeftForeArm", 1, "LeftForeArmRoll", 1, "LeftHand", 1, "LeftHandRing", 1, "LeftHandPinky1", 1, "LeftHandPinky2", 1, "LeftHandPinky3", 1,
	"LeftHandRing1", 1, "LeftHandRing2", 1, "LeftHandRing3", 1, "LeftHandMiddle1", 1, "LeftHandMiddle2", 1, "LeftHandMiddle3", 1, "LeftHandIndex1", 1,
	"LeftHandIndex2", 1, "LeftHandIndex3", 1, "LeftHandThumb1", 1, "LeftHandThumb2", 1, "LeftHandThumb3", 1, "RightShoulder", 0.8, "RightArm", 0.8,
	"RightArmRoll", 1, "RightForeArm", 1, "RightForeArmRoll", 1, "RightHand", 1, "RightHandRing", 1, "RightHandPinky1", 1, "RightHandPinky2", 1,
	"RightHandPinky3", 1, "RightHandRing1", 1, "RightHandRing2", 1, "RightHandRing3", 1, "RightHandMiddle1", 1, "RightHandMiddle2", 1,
	"RightHandMiddle3", 1, "RightHandIndex1", 1, "RightHandIndex2", 1, "RightHandIndex3", 1, "RightHandThumb1", 1, "RightHandThumb2", 1,
	"RightHandThumb3", 1, "Spine", 0.3, "Spine1", 0.4, "Spine2", 0.5, "Spine3", 0.6};
aimingDefault[] = {};

aimingNo[]

Type
Array
Description
BlendAnims array, see aiming above.
aimingNo[] = {};

aimPrecision

Type
Float
Description
Probably goes into accuracy calculations when firing a weapon; the higher the value, the less accurate aiming becomes.

Wounded >1, firing upright animations are mostly 1, kneeling is 0.5, and prone values are even lower.

aimPrecision = 5;		// Carrying a wounded soldier on your back
aimPrecision = 2;		// Injured, cannot stand up
aimPrecision = 1;		// Standing upright
aimPrecision = 0.5;		// Crouched
aimPrecision = 0.3;		// Prone
aimPrecision = 0.15;	// Walking slowly while looking down the sights

B

binocOff

Type
String
Description
Found in Actions together with binocOn. They define which state is used for bringing up and putting away binoculars.
binocOff = "";
binocOff = "AmovPercMstpSrasWrflDnon";
binocOff = "AmovPknlMstpSrasWrflDnon";
binocOff = "AmovPercMstpSrasWrflDnon";
binocOff = "AmovPpneMstpSrasWrflDnon";

binocOn

Type
String
binocOn = "";	// No binocs while lying on the ground injured
binocOn = "AwopPknlMstpSoptWbinDnon_rfl";
binocOn = "AwopPercMstpSoptWbinDnon_rfl";
binocOn = "AwopPknlMstpSoptWbinDnon_pst";
binocOn = "AwopPpneMstpSoptWbinDnon_rfl";

boundingSphere

Type
Float / Boolean
Description
Probably obsolescent, used for character collision detection. For more accurate collision models use collisionShape & Co. Still used in Arma 2 for cutscene animations. Sphere collision probably much cheaper than anything else.
boundingSphere = true;
boundingSphere = 1;
boundingSphere = 1.5;
boundingSphere = 8;
boundingSphere = 35;

C

CanNotMove

Type
String
Description
Found in Actions.
CanNotMove = "AmovPpneMstpSrasWrflDnon";

canPullTrigger

Type
Boolean
Description
Self explanatory. While in that animation, the player can fire it is weapon, but his trigger finger will remain extended. The little "finger squeezing the trigger" animation won't play.
canPullTrigger = 1;

Civil

Type
String
Description
Found in Actions, defines what happens to a soldier if he were to lose his weapons and become unarmed.
Civil = "AmovPercMstpSnonWnonDnon";
Civil = "AmovPercMstpSnonWnonDnon_gear";

CivilLying

Type
String
Description
Found in Actions.
CivilLying = "AmovPpneMstpSnonWnonDnon";

collisionGeomCompPattern[]

Type
Array
collisionGeomCompPattern[] = {1,3,6};

collisionShape

Type
String
Description
Found in States. Path to the collision model to be used during the animation, a special P3D file with only a Geometry LOD in it. Having "axis" selection point in ``Memory LOD`` of this shape will make unit rotate around this point instead of their entity center.
collisionShape = "ca\Anims\Characters\data\Geom\Sdr\Sstanistat_safe_geom.p3d";
collisionShape = "ca\Anims\Characters\data\Geom\Sdr\geom_Adth.p3d";

collisionShapeSafe

Type
String
collisionShapeSafe = "ca\Anims\Characters\data\Geom\Sdr\sbeh45l_safe_geom.p3d";

collisionVertexPattern[]

Type
Array
Description
Possibly some internal requirement of the collision detection algorithm. The strings represent individual vertices (named selections in the P3D).
collisionVertexPattern[] = {"1a", "2a", "3a", "4a", "5a", "6a", "7a", "8a", "1c", "2c"};
collisionVertexPattern[] = {"1a", "2a", "3a", "4a", "5a", "6a", "7a", "8a", "9a", "10a", "11a", "12a", "13a",
	"14a", "15a", "16a", "17a", "18a", "19a", "20a", "21a", "22a", "23a", "24a", "25a", "26a", "27a", "28a",
	"29a", "30a", "31a", "32a", "33a", "34a", "1c", "2c", "3c", "4c", "5c", "6c", "7c", "8c"};

Combat

Type
String
Description
Found in Actions.
Combat = "AmovPknlMstpSrasWrflDnon";

connectAs

Type
String
Description
Found in States; Not used in Arma 2:OA anymore.
connectAs = "";

connectFrom[]

Type
Array
Description
Found in States; Not used in Arma 2:OA anymore.
connectFrom[] = {};
connectFrom[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9};

connectTo[]

Type
Array
Description
Found in States. Defines edges in the animation graph, i.e. which animations can follow this one, once it finishes. The first pose of all animations from connectTo should be identical to the last pose of the current animation, otherwise see interpolateTo. The numeric value specifies the cost of the transition.
//AinvPknlMstpSnonWnonDnon_medic0S 
ConnectTo[] = {"AinvPknlMstpSnonWnonDnon_medic", 0.01,
	"AinvPknlMstpSnonWnonDnon_medic0", 0.01,
	"AinvPknlMstpSnonWnonDnon_medic1", 0.01,
	"AinvPknlMstpSnonWnonDnon_medic2", 0.01,
	"AinvPknlMstpSnonWnonDnon_medic3", 0.01,
	"AinvPknlMstpSnonWnonDnon_medic4", 0.01,
	"AinvPknlMstpSnonWnonDnon_medic5", 0.01};
//BasicDriver
ConnectTo[] = {"BasicDriverDying", 1.0};
connectTo[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9};

Crouch

Type
String
Description
Found in Actions, defines what happens when the AI crouch. There's also PlayerCrouch, which makes different crouching animations possible for players as opposed to AI.
Crouch = "AmovPknlMstpSnonWnonDnon";

D

default

Type
String
Description
Found in Actions, defines the default state for an action.
default = "LadderRifleStatic";

die

Type
String
Description
Found in Actions, defines what animation/state is called when the character dies.
die = "AdthPercMstpSlowWrflDnon_r05";
die = "DeadState";

disableWeapons

Type
Boolean
Description
Found in States, and unlike canPullTrigger, it can prohibit the character from firing his weapon.
disableWeapons = 1;

disableWeaponsLong

Type
Boolean
Description
Found in States, and apparently the only time disableWeaponsLong differs from disableWeapons is when the weapon is lowered (Ctrl doubletap).
//AmovPercMstpSlowWrflDnon
disableWeapons = false;
disableWeaponsLong = true;
// or
disableWeaponsLong = 1;

down

Type
String
Description
Found in Actions, tells what animation to play when hitting the "Go prone" key.
//class RifleBaseStandActions
down = "AmovPpneMstpSrasWrflDnon";
//class RifleProneActions
down = "AmovPercMstpSrasWrflDnon";
//??

down = "LadderRifleDownLoop";

duty

Type
Float
Description
Duty used to mean some mandatory states/actions the character had to reach, before being able to perform a certain animation. Not sure about what this does in ArmA anymore, if anything.
//OFP config
#define RunDuty -0.5
#define WalkDuty -0.7
#define RestDuty -1
#define CrawlDuty -0.0
#define SprintDuty 0.6

duty = -1;
duty = -0.7;
duty = -0.5;
duty = -0.4;
duty = 0.1;
duty = 0.2;
duty = 0.25;
duty = 0.3;
duty = 0.4;
duty = 0.5;
duty = 0.6;
duty = 2;

E

enableAutoActions

Type
Boolean
Description
Found in States. In Arma 2 there's a single occurrence of it being true: class TestDance.
enableAutoActions = 1;

enableBinocular

Type
Boolean
Description
Found in States, defines whether the character can use binoculars or not.
enableBinocular = 1;

enableBinocular = false;	// class CutSceneAnimationBase 
enableBinocular = false;	// class AmovPercMrunSnonWbinDf_rfl
enableBinocular = true;		// class AwopPknlMstpSoptWbinDnon_rfl

enableMissile

Type
Boolean
Description
Found in States, similar to disableWeapons. It enables/disables the firing of shoulder launched rockets (RPGs, MANPADS).
enableMissile = true; //class AidlPercMstpSrasWlnrDnon_player_idleSteady01

enableMissile = 1;

enableOptics

Type
Boolean
Description
Found in States, enables/disables looking down the weapon sights.
enableOptics = 1;

equivalentTo

Type
String
Description
Found in States, not sure what it does. The animation class is mostly equivalentTo another one, and oddly, sometimes to itself. Popular with healing, death, idle and cutscene animations.
equivalentTo = "";

class AdthPercMstpSrasWrflDnon_1 : AdthPercMstpSlowWrflDnon_1 {
	file = "\ca\Anims\Characters\data\Anim\Sdr\Dth\Erc\stp\ras\Rfl\AdthPercMstpSrasWrflDnon_1";
	speed = 0.72;
	equivalentTo = "AdthPercMstpSrasWrflDnon_1";
	...
};

equivalentTo = "AmovPsitMstpSlowWrflDnon";

EvasiveBack

Type
String
Description
Found in Actions, along with EvasiveForward, -Left and -Right. They point to the possible evasive animations that can be triggered.
EvasiveBack = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDb";

EvasiveForward

Type
String
Description
See EvasiveBack.
EvasiveForward = "AmovPercMevaSlowWlnrDf";

EvasiveLeft

Type
String
Description
See EvasiveBack.
EvasiveLeft = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDl";

EvasiveRight

Type
String
Description
See EvasiveBack.
EvasiveRight = "AmovPpneMstpSrasWrflDnon_AmovPpneMevaSlowWrflDr";

F

fast..

Type
String
Description
Found in Actions, walk.. defines the walking animations, slow.. defines the running/jogging and fast.. the sprinting animations.

The suffixes mean the following: B (backward), F (forward), L (left strafe), R (right strafe) and a combination of these: RF (45 deg. strafe), RB (135 deg. strafe), LB (225 deg. strafe) and LF (315 deg. strafe).

fastB = "AswmPercMstpSnonWnonDnon";
fastB = "AmovPercMrunSrasWrflDb";
fastF = "AswmPercMsprSnonWnonDf";
fastL = "AswmPercMstpSnonWnonDnon";
fastLB = "AswmPercMstpSnonWnonDnon";
fastLF = "AswmPercMsprSnonWnonDf";
fastR = "AswmPercMstpSnonWnonDnon";
fastRB = "AswmPercMstpSnonWnonDnon";
fastRF = "AswmPercMsprSnonWnonDf";

file

Type
String
Description
Found in States, points to the RTM animation file.
file = "\ca\Anims\Characters\data\Anim\Wmn\cts\erc\stp\non\non\ActsPercMstpSnonWnonDnon_MarianQ_shot5.rtm";

FireNotPossible

Type
String
Description
Found in Actions.
FireNotPossible = "AmovPpneMstpSrasWrflDnon";

G

getInCar

Type
String
Description
getInCar and getOutCar are found in Actions; they define what animations to call when getting into/out of a car. Similar to getInTank/getOutTank.

None of these are really used in the Arma 2 config anymore (one exception: class LauncherKneelActions). Instead, getInHigh, -Medium and -Low are used with their respective getOuts. Assigning the different getIn actions for each vehicle is done in CfgVehicles.

getInAction = "GetInCar"; //CfgVehicles

getInCar = "AmovPknlMstpSrasWrflDnon";

GetInHigh

Type
String
Description
See getInCar.
GetInHigh = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInHigh";

GetInLow

Type
String
Description
See getInCar.
GetInLow = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInLow";

GetInMedium

Type
String
Description
See getInCar.
GetInMedium = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInMedium";

getInTank

Type
String
Description
See getInCar.
getInTank = "AmovPknlMstpSrasWrflDnon";

getOutCar

Type
String
Description
See getInCar.
getOutCar = "AmovPknlMstpSrasWrflDnon";

GetOutHigh

Type
String
Description
See getInCar.
GetOutHigh = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutHigh";

GetOutLow

Type
String
Description
See getInCar.
GetOutLow = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutLow";

GetOutMedium

Type
String
Description
See getInCar.
GetOutMedium = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutMedium";

getOutTank

Type
String
Description
See getInCar.
getOutTank = "AmovPknlMstpSrasWrflDnon";

H

handGunOn

Type
String
Description
Found in Actions, points to the animation to transition to, when the character draws it is pistol. It is not the transition animation itself, where the character brings up the pistol (and puts away his rifle/launcher if he had any), but the end result of that: character standing, aiming with the pistol.
handGunOn = "AmovPercMstpSrasWpstDnon"; //class RifleBaseLowStandActions

handGunOn = "AmovPpneMstpSrasWrflDnon";

hasCollShapeSafe

Type
Boolean
hasCollShapeSafe = 0;

head

Type
String
Description
Found in States, references BlendAnims class entries. Permits/forbids the character to rotate his head freely. Similar in functionality to aiming.
head = "headDefault";	// class Default
head = "headNo";		// class CutSceneAnimationBase
head = "empty";			// class HaloFreeFall_non

headDefault[]

Type
Array
Description
Found in class BlendAnims, defines a set of bones, with weights associated to each of them.
headDefault[] = {"head", 1, "neck1", 0.5, "neck", 0.5};

headDefault[] = {};

headNo[]

Type
Array
Description
Found in class BlendAnims, always an empty array. Serves for disabling free head movement (independent of the RTM animation).
headNo[] = {};

headBobMode

Type
Number
Description

Valid values

HeadBobUndef = 0
HeadBobRaw = 1
HeadBobBeginEnd = 2
HeadBobAverageFrame = 3
HeadBobStraightHorizon = 4
HeadBobCutScene = 5


headBobMode = 5; // Cutscene


I

interpolateFrom[]

Type
Array
Description
Found in States, used together with interpolateTo for setting up two-way interpolation rules. interpolateFrom[] however, seems to have fallen in disuse.
interpolateFrom[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9};

interpolateTo[]

Type
Array
Description
Found in States; defines edges in the animation graph which should be interpolated immediately instead of connected at the end of this animation. As with connectTo, the numeric value specifies the cost of the transition.

Typically, animations will play to the end, then another animation will be played. Sometimes though, it is important to be able to just cut the current animation short, and immediately change to a different animation.

A good example would be death animations: if the character is half way through "eating a kebab" animation and the kebab explodes in his face, he won't continue munching. Instead he will play a death animation and fall to the ground right away.

To make the cut between the two animation less visually jarring, a couple of frames of transition/interpolation is provided.

interpolateTo[] = {"AinvPknlMstpSlayWrflDnon", 0.01,
	"AinvPknlMstpSlayWrflDnon_1", 0.01,
	"AinvPknlMstpSnonWnonDnon_1", 0.01,
	"AinvPknlMstpSnonWnonDnon_2", 0.01,
	"AinvPknlMstpSnonWnonDnon_3", 0.01,
	"AinvPknlMstpSnonWnonDnon_4", 0.01,
	"AdthPknlMstpSnonWnonDnon_inventory", 0.1};

interpolateWith[]

Type
Array
Description
Found in States, disused.
interpolateWith[] = {"BasicDriver", 0.02};

interpolationRestart

Type
Boolean
Description
Found in States, true mostly for transition animations.
interpolationRestart = false;	// Default
interpolationRestart = true;	// DefaultDie
interpolationRestart = 2;

interpolationSpeed

Type
Float
Description
Found in States.
interpolationSpeed = 200;	// AidlPercMstpSrasWrflDnon_aiming01, AdthPercMstpSrasWrflDnon_rS0 
interpolationSpeed = 30.5;	// AmovPercMstpSlowWrflDnon_player_idleSteady01
interpolationSpeed = 6;		// Default
interpolationSpeed = 0.5;	// AmovPknlMstpSrasWrflDnon_AmovPercMsprSrasWrflDf_2
interpolationSpeed = 0.1;	// AinjPfalMstpSnonWrflDnon_carried_Up

J

JumpOff

Type
String
Description
Found in Actions, disused.
JumpOff = "";

L

ladderOff

Type
String
Description
Found in States, defines what animation to switch to when letting go of the ladder.
ladderOff = "AmovPercMstpSnonWnonDnon";

ladderOffBottom

Type
String
Description
Found in States, defines what animation to switch to when letting go of the ladder, having reached the bottom of it.
ladderOffBottom = "LadderRifleDownOff";

ladderOffTop

Type
String
Description
Found in States, defines what animation to switch to when letting go of the ladder, having reached the top of it.
ladderOffTop = "LadderRifleTopOff";

ladderOnDown

Type
String
Description
Found in States, defines what animation to switch to when getting onto the bottom of the ladder.
ladderOnDown = "LadderRifleOn";

ladderOnUp

Type
String
Description
Found in States, defines what animation to switch to when getting onto the top of the ladder.
ladderOnUp = "LadderRifleOn";

leaning

Type
String
Description
Found in both Actions and States, references BlendAnims class entries. Defines how much each bone/bodypart should be influenced when leaning.

Leaning, similar to aiming, is not an animation played back from a file. It's procedural, if you will, and so needs extra setting up in the config to look it is best.

leaning = "leaningDefault";		// Default
leaning = "aimingLying";		// AmovPpneMstpSrasWrflDnon_injured
leaning = "empty";				// class AmovPpneMrunSlowWrflDf - disables leaning while prone

leaningCorrectionAngleBeg

Type
Float
Description
Not used in Arma 2, appearing only once in ArmA config, where both leaningCorrectionAngleBeg and leaningCorrectionAngleEnd are zero.
leaningCorrectionAngleBeg = 0;
leaningCorrectionAngleEnd = 0;

leaningFactorBeg

Type
Float
Description
Found in States, leaningFactorBeg sets how much influence leaning has at the start of an animation, while leaningFactorEnd takes care of the end. If the two values differ, leaning is blended in or out during the animation.
leaningFactorBeg = 1;		// StandBase
leaningFactorEnd = 1;

leaningFactorBeg = 0;		// SprintBaseDf
leaningFactorEnd = 0;

leaningFactorBeg = 0.5;		// AmovPknlMstpSrasWlnrDnon - limited (half) leaning with launcher
leaningFactorEnd = 0.5;

leaningFactorBeg = 0.75;	// AmovPercMwlkSlowWrflDf - limited leaning while walking with rifle raised
leaningFactorEnd = 0.75;

leaningFactorBeg = 1;		// amovpercmstpsraswrfldnon_amovpercmstpsraswlnrdnon
leaningFactorEnd = 0.5;

leaningFactorBeg = 1;		// AmovPercMstpSrasWrflDnon_AmovPpneMstpSrasWrflDnon
leaningFactorEnd = 0;		// -transition betwen a state with full leaning to one where leaning is forbidden-

leaningFactorEnd

Type
Float
Description
See above.
leaningFactorEnd = 0.75;

leaningFactorZeroPoint

Type
Float
Description
Appears only once in both ArmA & Arma 2, no variation across States or Actions.
leaningFactorZeroPoint = -1;

leanLRot

Type
Float
Description
Found in Actions, sets the amount of lean possible and the angle of leaning.

With a value of 1, the character will lean about 70 degrees off vertical, looking like it just broke it is back, so the more reasonable amount to lean is about half of that. Doctor's orders.

leanLRot = 0;		// NoActions, RifleProneActions
leanLRot = 0.5;		// RifleBaseLowStandActions
leanLRot = 0.57;	// CivilStandActions

leanLShift

Type
Float
Description
Found in Actions. In addition to tilting the upper body during leaning, it is also possible to move it into the lean.

Typical values are very small, anything else will produce excessive deformations of the model.

leanLShift = 0;		// class RifleProneActions
leanLShift = 0.01;	// class RifleBaseLowStandActions
leanLShift = 0.07;	// class CivilStandActions

leanRRot

Type
Float
Description
See leanLRot.
leanRRot = 0.57;

leanRShift

Type
Float
Description
See leanLShift.
leanRShift = 0.01;

leftHandIKBeg

Type
Boolean
Description
Found in States, appeared in ArmA, complemented/superseded in Arma 2 by leftHandIKCurve[].

These properties set whether at the beginning and end of the animation, IKs for both arms are enabled or not.

left/right-HandIKCurve[] allows for a more complex and detailed control of FK/IK (see below for more details) blending.

Typical uses:

leftHandIKBeg = true;
leftHandIKCurve[] = {1};
leftHandIKEnd = true;

leftHandIKBeg = false;
leftHandIKCurve[] = {};
leftHandIKEnd = false;

leftHandIKBeg = false;
leftHandIKCurve[] = {0, 1, 0.075, 0, 0.725, 0, 0.8, 1};
leftHandIKEnd = false;

leftHandIKBeg = false;
leftHandIKCurve[] = {0.05, 1, 0.125, 0, 0.6, 0, 0.675, 1};
leftHandIKEnd = true;

leftHandIKEnd

Type
Boolean
Description
See above.
leftHandIKEnd = 0;

leftHandIKCurve

Type
Array
Description
As the name suggests, this array describes the curve controlling FK/IK blending on the left arm.

Every pair of values describe a 2D point, with the first number representing time (horizontal) and the second being the weight (vertical).

Time ranges from 0-1, where 0 is animation start, 0.5 is half way, and 1 the end.

Weight also ranges from 0-1, where 0 means animation is taken from RTM file (FK) and IK is disabled, 0.6 meaning a 40% blend of FK and 60% IK, and 1 is 100% IK.

Let me interpret the last example below (the long one). The curve has 4 points [0, 1], [0.05, 0], [0.95, 0] and [1, 1]. When the animation starts playing, the IK takes full effect, but is gradually disabled by point #2. It stays disabled until point #3 towards the end, when it is weight starts climbing again. At the end, at point #4, the IK is fully on again, overriding all FK.

leftHandIKCurve[] = {};									// IK OFF.
leftHandIKCurve[] = {1};								// IK fully ON.
leftHandIKCurve[] = {0.1, 1, 0.15, 0};					// IK fully ON one-tenth into the animation, but disabled soon afterwards.
leftHandIKCurve[] = {0, 1, 0.05, 0, 0.95, 0, 1, 1};		// IK ON at start, but soon disabled. Re-enabled towards the end.

legs

Type
String
Description
Found in States, references BlendAnims class entries. Used for deforming the character on sloping surfaces (hillside, stairs, etc..).

Most of the RTM animations have been recorded in a motion capture studio, on a perfectly flat floor. When standing on a slope, the character would normally have one foot sinking into the ground, while the other would be hanging in the air. So BI devised this system for deforming the bodyparts that have contact with the ground.

When standing upright, it is just the legs. When prone, it is most, if not the whole body. Like everything else in BlendAnims, it is a list of bones, with weights (amount of influence) associated.

legs = "legsDefault";		// Deafault
legs = "legsNo";			// DefaultDie
legs = "legsLyingAiming";	// AmovPpneMstpSrasWrflDnon_injured
legs = "Wholebody";			// AmovPpneMstpSnonWnonDnon
legs = "empty";				// HaloFreeFall_non

legsDefault[]

Type
Array
Description
BlendAnims class entry. See above.
legsDefault[] = {"LeftUpLeg", 0.9, "LeftUpLegRoll", 0.9, "LeftLeg", 0.95, "LeftLegRoll", 0.95, "LeftFoot", 1, "LeftToeBase", 1,
	"RightUpLeg", 0.9, "RightUpLegRoll", 0.9, "RightLeg", 0.95, "RightLegRoll", 0.95, "RightFoot", 1, "RightToeBase", 1};

legsNo[]

Type
Array
Description
Always empty BlendAnims class entry, see legs above. Disables all deformations on contact with land. Death animations are a typical case.
legsNo[] = {};

limitFast

Type
Float
Description
Found in Actions, used for limiting the slow.. movements, although the names suggests a limiting of fast...
limitFast = 0.5;	// RifleProneActions_injured
limitFast = 2;		// SwimmingActions
limitFast = 4;		// class CivilStandActions, SwimmingFastActions
limitFast = 5;		// NoActions
limitFast = 5.5;	// RifleBaseLowStandActions

limitGunMovement

Type
Boolean
Description
Found in States.
limitGunMovement = false;	// HealBase
limitGunMovement = false;	// SprintBaseDf
limitGunMovement = 0.1;		// AmovPercMstpSnonWnonDnon
limitGunMovement = 0.3;		// AovrPercMstpSlowWrflDf
limitGunMovement = 0.6;		// AmovPercMwlkSlowWpstDnon_transition
limitGunMovement = true;	// Default

looped

Type
Boolean
Description
Found in States, sets whether the current animation should start over once it is finished. Loop, that is.
looped = 1;

Lying

Type
String
Description
Found in Actions, points to the animation to play for the "Prone with weapon" situation. CivilLying is the unarmed equivalent.
Lying = "AmovPpneMstpSnonWnonDnon";

M

medic

Type
String
Description
Found in Actions, points to the animation to be used by a medic when triggering the "Heal.." action.
medic = "AinvPknlMstpSlayWrflDnon_medic";

O

onLadder

Type
Boolean
Description
Found in States, flags the animation as ladder related.
onLadder = 1;

onLandBeg

Type
Boolean
Description
Found in States. If at the start of the animation the character is lying on the ground (prone), onLandBeg equals true. If at the end of the animation the character is lying on the ground (prone), onLandEnd equals true. Otherwise false. Not sure what these flags are used for.
//Default
onLandBeg = false;
onLandEnd = false;

//AmovPercMstpSrasWrflDnon_AmovPpneMstpSrasWrflDnon 
onLandBeg = false;
onLandEnd = true;

//AmovPpneMstpSrasWrflDnon_AmovPercMstpSrasWrflDnon 
onLandBeg = true;
onLandEnd = false;

//AmovPpneMstpSrasWrflDnon_AmovPpneMstpSrasWpstDnon 
onLandBeg = true;
onLandEnd = true;

//AdthPpneMstpSnonWnonDnonB
onLandEnd = true;
onLandBeg = false;

onLandEnd

Type
Boolean
Description
See above.
onLandEnd = 1;

P

PlayerCrouch

Type
String
Description
Found in Actions. Similar to Crouch, except it applies only to player characters and not AI.
PlayerCrouch = "AmovPknlMstpSrasWlnrDnon";

PlayerProne

Type
String
Description
Found in Actions. Similar to Lying, except it applies only to player characters and not AI.

Sets the animation to be used when going prone.

PlayerProne = "AmovPpneMstpSnonWnonDnon";

PlayerStand

Type
String
Description
Found in Actions. Similar to Stand, except it applies only to player characters and not AI.

Sets the animation to be used when standing upright.

PlayerStand = "AwopPercMstpSoptWbinDnon_rfl";

predictSpeedCoef

Type
Float
Description
Disused in Arma 2, appears once in ArmA.
predictSpeedCoef = 1;

preload

Type
Boolean
Description
Found in States, sets whether to load the animation file (RTM) into memory at game start, or just read it from disc when there's a demand for it.

All animations are set not to preload in Arma 2, while in ArmA some often used animations like running for example, are preloaded.

preload = 1;

primaryActionMaps[]

Type
Array
Description
Outlines the main action groups.
primaryActionMaps[] = {"DeadActions", "LauncherKneelActions", "BinocProneRflActions", "BinocProneCivilActions",
	"RifleProneActions", "PistolProneActions", "RifleKneelActions", "PistolKneelActions", "RifleStandActions",
	"PistolStandActions", "RifleLowStandActions", "SwimmingActions", "CivilStandActions",
	"BinocKneelRflActions", "BinocStandRflActions"};

putDown

Type
String
Description
Found in Actions. Sets the animation to be used when the character puts something on the ground (e.g. dropping some equipment).
putDown = "AmovPpneMstpSrasWrflDnon";

PutDownEnd

Type
Float
Description
Not used in the ArmA series.
PutDownEnd = "";

R

reload...

Type
String
Description
Found in Actions. Default actions for reloading are reloadMagazine, reloadAT, reloadMGun and reloadMortar, but addon makers can add their own if they wish.

These actions are invoked in CfgWeapons and CfgMagazines via reloadAction. Most reload actions for upright stances in Arma 2 are bone-masked, they are configured as Gestures.

//game
reloadAT = "LauncherReloadKneel";
reloadMagazine[] = {"WeaponMagazineReloadStand", "Gesture"};
reloadMGun = "AmovPpneMstpSrasWrflDnon";
reloadMortar = "AmovPpneMstpSrasWrflDnon";

//custom
reloadM1Garand[] = {"M1GarandMagazineReloadStand", "Gesture"};
//CfgWeapons/CfgMagazines
reloadAction = "ManActReloadM1Garand";

relSpeedMax

Type
Float
Description
Found in States.
relSpeedMax = 0.6;

relSpeedMin

Type
Float
Description
Found in States.
relSpeedMin = 0.5;

rightHandIKBeg

Type
Boolean
Description
See leftHandIKBeg.
rightHandIKBeg = 1;

rightHandIKEnd

Type
Boolean
Description
See leftHandIKBeg.
rightHandIKEnd = 1;

rightHandIKCurve

Type
Array
Description
See leftHandIKCurve.
rightHandIKCurve[] = {};								// IK OFF.
rightHandIKCurve[] = {1};								// IK fully ON.
rightHandIKCurve[] = {0.1, 1, 0.15, 0};					// IK fully ON one-tenth into the animation, but disabled soon afterwards.
rightHandIKCurve[] = {0, 1, 0.05, 0, 0.95, 0, 1, 1};	// IK ON at start, but soon disabled. Re-enabled towards the end.

S

salute..

Type
String
Description
Found in Actions, salute points to the animation the character will transition to when saluting, while saluteOff points to the animation the character should return to when done saluting.

Neither of these properties point to the transition animations, where the character is actually raising/lowering it is arm.

salute = "AmovPercMstpSlowWrflDnon_salute";
saluteOff = "AmovPercMstpSlowWrflDnon";

showHandGun

Type
Boolean
Description
Found in States, sets pistol visibility on/off.
showHandGun = 1;

showItemInHand

Type
Boolean
Description
Found in States, sets item (binoculars, specifically) visibility on/off.
showItemInHand = 1;

showItemInRightHand

Type
Boolean
Description
Found in States, sets item (binoculars, specifically) visibility on/off in the right hand. Looks it is not working on Arma 3.
showItemInRightHand = 0;

showWeaponAim

Type
Boolean
Description
Found in States, sets whether crosshairs are displayed or not for given animation.
showWeaponAim = 1;

sitDown

Type
String
Description
Found in Actions, points to the animation to transition to when the sitting action is triggered. Not the to and from transition animations, but the sitting idle.
SitDown = "";	// RifleStandSaluteActions_Idle - can't sit down while saluting
sitDown = "AmovPsitMstpSlowWrflDnon";

skeletonName

Type
String
Description
Sets the skeleton to be used.
skeletonName = "OFP2_ManSkeleton";
skeletonName = "WomanSkeleton";

slow..

Type
String
Description
See fast...
slowB = "AmovPercMrunSlowWlnrDb";
slowF = "AmovPercMevaSlowWlnrDf";
slowL = "AmovPercMrunSlowWlnrDl";
slowLB = "AmovPercMrunSlowWlnrDbl";
slowLF = "AmovPercMrunSlowWlnrDfl";
slowR = "AmovPercMrunSlowWlnrDr";
slowRB = "AmovPercMrunSlowWlnrDbr";
slowRF = "AswmPercMrunSnonWnonDf";

soundEdge..

Type
Array
Description
Found in States. Deprecated forms soundEdge1, soundEdge2 (used very little in ArmA, not at all in Arma 2).

Used for sound timing during an animation. If there's a sound file associated with the animation, it won't play right away as the animation starts. It will play when and as many times as soundEdge tells it to.

soundEdge[] = {0.5, 1};					// Default
soundEdge[] = {0.45};					// DefaultDie
soundEdge[] = {0.25, 0.5, 0.75, 1};		// AmovPercMwlkSlowWrflDf - timing of the 4 footstep sounds

//old
soundEdge1 = 0.5;
soundEdge2 = 1;

soundEnabled

Type
Boolean
Description
Found in States, enables/disables sounds being played with the animation.
soundEnabled = 1;

soundOverride

Type
String
Description
Found in States, points to the actual sound to play with the animation.
soundOverride = "bodyfall";

speed

Type
Float
Description
Found in States, sets the animation playback speed.

Note that speed depends on animation length, on the number of frames it contains.

For example, setting speed at 0.5 for a 50 frames long animation will result in it playing at about 25 frames per second. Setting the same speed for a 300 frame animation, will result in that animation playing much faster. Speed, seems to me more akin to duration.

speed = 0.00833333;

stand

Type
String
Description
Found in Actions, see playerStand.
Stand = "AmovPknlMstpSrasWrflDnon";

startSwim

Type
String
Description
Found in Actions, points to the animation to be used when starting to swim.
startSwim = "AswmPercMrunSnonWnonDf";

stop

Type
String
Description
Found in Actions, points to the animation to be used when stopping.
stop = "AinvPknlMstpSlayWrflDnon";

stopRelaxed

Type
String
Description
Found in Actions, points to the animation to be used when stopping with weapon lowered ("SAFE" behaviour).
StopRelaxed = "AidlPercMstpSlowWrflDnon01";

stopSwim

Type
String
Description
Found in Actions, points to the animation to be used when ending swimming.
stopSwim = "AmovPercMstpSnonWnonDnon";

strokeFist

Type
Float
Description
Found in Actions, not really used. Has been around since OFP if I remember correctly, probably an attempt to introduce fist fighting, but then abandoned.
StrokeFist = "";

strokeGun

Type
String
Description
Similar to strokeFist above, attempt at melee fighting but not used.
strokeGun = "AmovPercMstpSnonWnonDnon";

T

takeFlag

Type
String
Description
Found in Actions, points to the animation to be used when taking the flag during a CTF match.
takeFlag = "AinvPknlMstpSlayWrflDnon";

terminal

Type
Boolean
Description
Found in States, flags the animation as being "terminal". True for death animations, false for everything else.
terminal = 1;

testDriver

Type
String
Description
Found in Actions, along with testDriverOut and TestGunner. "Test" suggests it might have been just that, an experiment during development.
//class ManActions
TestDriver = "BasicDriver";
TestDriverOut = "BasicDriverOut";
TestGunner = "BasicSittingGunner";

testDriverOut

Type
String
Description
See above.
TestDriverOut = "BasicDriverOut";

testGunner

Type
String
Description
See testDriver.
TestGunner = "BasicSittingGunner";

throwGrenade

Type
String
Description
Found in Actions, points to the animation to be used when throwing a grenade.
throwGrenade = "AmovPercMrunSlowWpstDf_AmovPercMstpSrasWpstDnon_gthThrow";

transitionsDisabled[]

Type
Array
Description
Empty array in both ArmA & Arma 2. No apparent use for it.
transitionsDisabled[] = {};

transitionsInterpolated[]

Type
Array
Description
Empty array in both ArmA & Arma 2. No apparent use for it.
transitionsInterpolated[] = {};

transitionsSimple[]

Type
Array
Description
Empty array in both ArmA & Arma 2. No apparent use for it.
transitionsSimple[] = {};

treated

Type
String
Description
Found in Actions, points to the animation to be used when being healed by a medic. Medic will be using animation defined in medic.
treated = "AinvPknlMstpSlayWrflDnon_healed";

turn...

Type
String
Description
Found in Actions, turnL and turnR define the turning animations, while turnLRelaxed and turnRRelaxed do the same thing for the "relaxed" (weapon lowered, behaviour "SAFE") modes.
turnL = "AmovPercMstpSlowWrflDnon_turnL";
turnLRelaxed = "AmovPercMstpSlowWrflDnon_turnL";
turnR = "AmovPpneMstpSrasWrflDnon_turnR";
turnRRelaxed = "AmovPpneMstpSrasWrflDnon_turnR";

turnSpeed

Type
Float
Description
Found in Actions, sets turning speed.
turnSpeed = 0.1;

U

untiltWeapon

Type
String
Description
Not found in Arma 2, and not really used in ArmA either.
untiltWeapon = "untiltWeaponDefault";

untiltWeaponDefault[]

Type
Array
Description
Same as above.
untiltWeaponDefault[] = {};

up

Type
String
Description
Found in Actions. Together with down sets up what looks like a standing/kneeling/prone toggle. Which I don't think is used in the game's current control scheme.
up = "AmovPknlMstpSlowWrflDnon";	// RifleBaseLowStandActions
up = "AmovPknlMstpSrasWrflDnon";	// RifleBaseStandActions
up = "AmovPknlMwlkSlowWrflDf";		// RifleLowStandActionsWlkF
up = "AmovPercMstpSrasWrflDnon";	// RifleKneelActions

upDegree

Type
String
Description
Found in Actions, seems to define the "upright" stance for each action group.

These "ManPos.." things only appear in root /Dta/bin/config.bin, where they get some equivalent numbers, and that's it. Important to get right though when creating custom action sets.

upDegree = 0;						// NoActions
upDegree = -1;						// NoActions, ParachuteFreeFall
upDegree = "ManPosDead";			// DeadActions
upDegree = "ManPosStand";			// RifleBaseLowStandActions
upDegree = "ManPosCombat";			// RifleBaseStandActions
upDegree = "ManPosCrouch";			// RifleKneelEvasiveActions, RifleKneelActions
upDegree = "ManPosLying";			// RifleProneActions
upDegree = "ManPosHandGunStand";
upDegree = "ManPosHandGunCrouch";
upDegree = "ManPosHandGunLying";
upDegree = "ManPosNoWeapon";		// CivilStandActions
upDegree = "ManPosLyingNoWeapon";
upDegree = "ManPosWeapon";			// LauncherKneelActions
upDegree = "ManPosBinocStand";		// BinocStandLnrActions
upDegree = "ManPosSwimming";
upDegree = "ManPosBinocStand";
upDegree = "ManPosBinoc";
updegree = "ManPosCrouch";
//enum in root config
enum {
	MANPOSNOWEAPON = 12,
	CPCOMMANDER = 2,
	CMD_STAY_BACK = 4,
	CMD_MOVE = 12,
	CMD_FIRE = 27,
	CMD_WATCH = 28,
	CMD_REPLY_FAIL = 64,
	CMD_REPORT = 68,
	...
	MANPOSHANDGUNSTAND = 9,
	...
	MANPOSCROUCH = 6,
	...
	MANPOSHANDGUNLYING = 5,
	MANPOSHANDGUNCROUCH = 7,
	MANPOSBINOCSTAND = 14,
	...
	MANPOSDEAD = 0,
	MANPOSCOMBAT = 8,
	...
	MANPOSBINOCLYING = 2,
	MANPOSSTAND = 10,
	MANPOSSWIMMING = 11,
	COMPARTMENT3 = 4,
	CMD_ACTION = 2,
	CMD_FORM_ECHLEFT = 16,
	...
	MANPOSWEAPON = 1,
	...
	MANPOSLYING = 4,
	...
	MANPOSLYINGNOWEAPON = 3,
	MANPOSBINOC = 13,
	...
};

useFastMove

Type
Boolean
Description
Found in Actions. True for action sets containing "Evasive" in the classname, so an obscure flag of some sorts in ArmA. Not used in any significant way in Arma 2.
useFastMove = 1;

V

variantAfter[]

Type
Array
Description
Found in States when there are several variations on the same animation (usually idles) that can be played randomly.

Minimum, average and maximum - these are the inputs for the random number generator, similar to how trigger timeout/countdown works in the mission editor.

variantAfter[] = {5, 10, 20};	// Default
VariantAfter[] = {5, 5, 5};		// AinvPknlMstpSnonWnonDnon_medic0S 
variantAfter[] = {2, 3, 5};		// AidlPercMstpSlowWrflDnon_player_0S
variantAfter[] = {0, 0, 0};		// AidlPercMstpSrasWrflDnon_aiming0S

variantsAI[]

Type
Array
Description
Found in States when there are several variations on the same animation (usually idles) that can be played randomly.

It lists the animations to be randomly cycled. The numbers represent the probability of that animation being played, the higher the number, the more likely the animation will get to play.

The sum of these numbers is always 1.

//Default
variantsAI[] = {""};
//AidlPercMstpSnonWnonDnon
variantsAI[] = {"AidlPercMstpSnonWnonDnon01", 0.01,
	"AidlPercMstpSnonWnonDnon02", 0.01,
	"AidlPercMstpSnonWnonDnon03", 0.01,
	"AidlPercMstpSnonWnonDnon04", 0.01,
	"AidlPercMstpSnonWnonDnon05", 0.01,
	"AidlPercMstpSnonWnonDnon06", 0.01,
	"AidlPercMstpSnonWnonDnon07", 0.01,
	"AidlPercMstpSnonWnonDnon08", 0.01,
	"AidlPercMstpSnonWnonDnon_idleSteady04", 0.23,
	"AidlPercMstpSnonWnonDnon_idleSteady03", 0.23,
	"AidlPercMstpSnonWnonDnon_idleSteady02", 0.23,
	"AidlPercMstpSnonWnonDnon_idleSteady01", 0.23};
//ActsPsitMstpSnonWnonDnon_varSittingOnTheWall
variantsAI[] = {"Mi17_Cargo02", 0.4, "Mi17_Cargo02_V1", 0.1, "Mi17_Cargo02_V2", 0.1, "Mi17_Cargo02_V3", 0.1,
	"Mi17_Cargo02_V4", 0.1, "Mi17_Cargo02_V5", 0.1, "Mi17_Cargo02_V6", 0.1};
//aidlpercmstpsraswlnrdnon_S
variantsAI[] = {"aidlpercmstpsraswlnrdnon_1", 0.333, "aidlpercmstpsraswlnrdnon_2", 0.333, "aidlpercmstpsraswlnrdnon_3", 0.334};

variantsPlayer[]

Type
Array
Description
Same as variantsAI[] above, except for player characters.
variantsPlayer[] = {"AdthPercMrunSlowWlnrDf_1", 0.5, "AdthPercMrunSlowWlnrDf_2", 0.5};

visibleSize

Type
Float
Description
Found in States, probably used for calculating how visible a character is for the AI, based on his stance/animation.
visibleSize = 1.00012;		// SprintBaseDf					when sprinting more visible than..
visibleSize = 0.700121;		// AmovPercMstpSrasWrflDnon		..when stopped > visible than..
visibleSize = 0.300122;		// AmovPknlMstpSlowWrflDnon		..when kneeling > visible than..
visibleSize = 0.100123;		// AmovPpneMstpSrasWrflDnon		..when prone.

W

walk..

Type
String
Description
See fast...
walkB = "AmovPercMwlkSlowWrflDb";
walkF = "AmovPercMevaSlowWlnrDf";
walkL = "AmovPercMwlkSlowWrflDl";
walkLB = "AmovPercMwlkSlowWrflDbl";
walkLF = "AswmPercMwlkSnonWnonDf";
walkR = "AmovPpneMrunSnonWnonDr";
walkR = "AswmPercMstpSnonWnonDnon";
walkRB = "AmovPercMwlkSlowWrflDbr";
walkRF = "AmovPercMwlkSlowWrflDfr";

weaponOff

Type
String
Description
The opposite of weaponOn below.
weaponOff = "AmovPercMstpSrasWrflDnon";

weaponOn

Type
String
Description
Found in States, and references the animation that needs to be reached when switching to RPGs/MANPADS.
weaponOn = "AmovPknlMstpSrasWlnrDnon";		// RifleBaseLowStandActions
weaponOff = "AmovPercMstpSrasWrflDnon";

weaponOn = "AmovPknlMstpSrasWlnrDnon";		// RifleKneelActions
weaponOff = "AmovPknlMstpSrasWrflDnon";

weaponOn = "AmovPknlMstpSrasWlnrDnon";		// RifleProneActions
weaponOff = "AmovPpneMstpSrasWrflDnon";