CfgMoves Config Reference: Difference between revisions
m (correction) |
|||
(61 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{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). | |||
''cfgMoves'' has two major sections: ''Actions'' and ''States''. | |||
=== Actions === | |||
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 | |||
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 {{Name|arma2|short}}. Welcome to reloading-while-running. | |||
== | === Namespace of anim classes and files === | ||
[[ | {{hl|A...P...M...S...W...D[_A...P...M...S...W...D][_Comment]}} | ||
'''A''': Description of the animation type, ''i.e.'': {{hl|mov}} for movement, {{hl|cts}} for cutscene | |||
'''P''': Stance: {{hl|erc}} for erected, {{hl|knl}} for kneel, {{hl|pne}} for prone | |||
''' | |||
'''M''': Speed of animation: {{hl|stp}} for stopped, {{hl|wlk}} for walk, {{hl|run}} for running, {{hl|eva}} for evasive | |||
'''S''': Weapon holding: {{hl|low}} for lowered, {{hl|ras}} for raised | |||
''' | |||
'''W''': Weapon: {{hl|non}} for unarmed, {{hl|pst}} for pistol, {{hl|lnr}} for launcher, {{hl|rfl}} for rifle. | |||
'''D''': Direction of movement: {{hl|non}} for no direction, {{hl|f}} for forward, etc. | |||
''' | |||
: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. | |||
{{hl|[_Comment]: additional comments}}, if required. | |||
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)''. | |||
''' | |||
== Alphabetical Order == | |||
{{ConfigPage|abc}} | |||
=== A === | |||
==== access ==== | |||
;Type: [[TokenNameValueTypes|Integer]] | |||
;Description: See ''[[CfgVehicles_Config_Reference#access | access (CfgVehicles)]]''. | |||
== | <syntaxhighlight lang="cpp"> | ||
access = 3; | |||
</syntaxhighlight> | |||
==== actions ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Sets the action class/group to which this state belongs to. | |||
== | <syntaxhighlight lang="cpp"> | ||
actions = "PistolStandActionsRunR"; | |||
actions = "RifleStandActions"; | |||
actions = "InjuredManActionsnon_norot"; | |||
actions = "SitActions"; | |||
</syntaxhighlight> | |||
==== aiming ==== | |||
;Type: [[TokenNameValueTypes|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.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. | |||
== | <syntaxhighlight lang="cpp"> | ||
aiming = "empty"; | |||
aiming = "aimingDefault"; | |||
aiming = "aimingNo"; | |||
aiming = "aimingCivil"; | |||
aiming = "aimingLying"; | |||
aiming = "aimingPistol"; | |||
aiming = "aimingLauncher"; | |||
</syntaxhighlight> | |||
==== aimingDefault[] ==== | |||
;Type: [[TokenNameValueTypes|Array]] | |||
;Description: ''BlendAnims'' array, see ''[[#aiming | aiming]]'' above. | |||
== | <syntaxhighlight lang="cpp"> | ||
[ | 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[] = {}; | |||
</syntaxhighlight> | |||
==== aimingNo[] ==== | |||
;Type: [[TokenNameValueTypes|Array]] | |||
;Description: ''BlendAnims'' array, see ''[[#aiming | aiming]]'' above. | |||
= | <syntaxhighlight lang="cpp"> | ||
[ | aimingNo[] = {}; | ||
</syntaxhighlight> | |||
==== aimPrecision ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: Probably goes into accuracy calculations when firing a weapon; the higher the value, the less accurate aiming becomes. | |||
== | Wounded {{hl|>1}}, firing upright animations are mostly {{hl|1}}, kneeling is {{hl|0.5}}, and prone values are even lower. | ||
<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> | |||
=== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
binocOff = ""; | |||
binocOff = "AmovPercMstpSrasWrflDnon"; | |||
binocOff = "AmovPknlMstpSrasWrflDnon"; | |||
binocOff = "AmovPercMstpSrasWrflDnon"; | |||
binocOff = "AmovPpneMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
==== binocOn ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
== | <syntaxhighlight lang="cpp"> | ||
binocOn = ""; // No binocs while lying on the ground injured | |||
binocOn = "AwopPknlMstpSoptWbinDnon_rfl"; | |||
binocOn = "AwopPercMstpSoptWbinDnon_rfl"; | |||
binocOn = "AwopPknlMstpSoptWbinDnon_pst"; | |||
binocOn = "AwopPpneMstpSoptWbinDnon_rfl"; | |||
</syntaxhighlight> | |||
==== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
boundingSphere = true; | |||
boundingSphere = 1; | |||
boundingSphere = 1.5; | |||
boundingSphere = 8; | |||
boundingSphere = 35; | |||
</syntaxhighlight> | |||
=== C === | |||
==== CanNotMove ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions''. | |||
== | <syntaxhighlight lang="cpp"> | ||
CanNotMove = "AmovPpneMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
==== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
canPullTrigger = 1; | |||
</syntaxhighlight> | |||
==== Civil ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions'', defines what happens to a soldier if he were to lose his weapons and become unarmed. | |||
== | <syntaxhighlight lang="cpp"> | ||
Civil = "AmovPercMstpSnonWnonDnon"; | |||
Civil = "AmovPercMstpSnonWnonDnon_gear"; | |||
</syntaxhighlight> | |||
==== CivilLying ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions''. | |||
== | <syntaxhighlight lang="cpp"> | ||
CivilLying = "AmovPpneMstpSnonWnonDnon"; | |||
</syntaxhighlight> | |||
==== collisionGeomCompPattern[] ==== | |||
;Type: [[TokenNameValueTypes|Array]] | |||
= | <syntaxhighlight lang="cpp"> | ||
collisionGeomCompPattern[] = {1,3,6}; | |||
</syntaxhighlight> | |||
==== 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. | |||
== | <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> | |||
==== collisionShapeSafe ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
= | <syntaxhighlight lang="cpp"> | ||
collisionShapeSafe = "ca\Anims\Characters\data\Geom\Sdr\sbeh45l_safe_geom.p3d"; | |||
</syntaxhighlight> | |||
== | ==== collisionVertexPattern[] ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Array]] | ||
;Description: Possibly some internal requirement of the collision detection algorithm. The strings represent individual vertices (named selections in the ''P3D''). | |||
<syntaxhighlight lang="cpp"> | |||
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> | |||
== | ==== Combat ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions''. | |||
<syntaxhighlight lang="cpp"> | |||
Combat = "AmovPknlMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== connectAs ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''States''; Not used in {{Name|arma2oa|short}} anymore. | |||
<syntaxhighlight lang="cpp"> | |||
connectAs = ""; | |||
</syntaxhighlight> | |||
== | ==== connectFrom[] ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Array]] | ||
;Description: Found in ''States''; Not used in {{Name|arma2oa|short}} anymore. | |||
<syntaxhighlight lang="cpp"> | |||
connectFrom[] = {}; | |||
connectFrom[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9}; | |||
</syntaxhighlight> | |||
== | ==== connectTo[] ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|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. | ||
<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> | |||
== | ==== Crouch ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|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''. | ||
<syntaxhighlight lang="cpp"> | |||
Crouch = "AmovPknlMstpSnonWnonDnon"; | |||
</syntaxhighlight> | |||
= | === D === | ||
==== default ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions'', defines the default state for an action. | |||
== | <syntaxhighlight lang="cpp"> | ||
default = "LadderRifleStatic"; | |||
</syntaxhighlight> | |||
==== die ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions'', defines what animation/state is called when the character dies. | |||
== | <syntaxhighlight lang="cpp"> | ||
die = "AdthPercMstpSlowWrflDnon_r05"; | |||
die = "DeadState"; | |||
</syntaxhighlight> | |||
==== disableWeapons ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', and unlike ''canPullTrigger'', it can prohibit the character from firing his weapon. | |||
== | <syntaxhighlight lang="cpp"> | ||
disableWeapons = 1; | |||
</syntaxhighlight> | |||
==== disableWeaponsLong ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', and apparently the only time ''disableWeaponsLong'' differs from ''disableWeapons'' is when the weapon is lowered (Ctrl doubletap). | |||
== | <syntaxhighlight lang="cpp"> | ||
//AmovPercMstpSlowWrflDnon | |||
disableWeapons = false; | |||
disableWeaponsLong = true; | |||
// or | |||
disableWeaponsLong = 1; | |||
</syntaxhighlight> | |||
==== down ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions'', tells what animation to play when hitting the "''Go prone''" key. | |||
== | <syntaxhighlight lang="cpp"> | ||
//class RifleBaseStandActions | |||
down = "AmovPpneMstpSrasWrflDnon"; | |||
//class RifleProneActions | |||
down = "AmovPercMstpSrasWrflDnon"; | |||
//?? | |||
down = "LadderRifleDownLoop"; | |||
</syntaxhighlight> | |||
== | ==== duty ==== | ||
[[TokenNameValueTypes| | ;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. | |||
<syntaxhighlight lang="cpp"> | |||
//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; | |||
</syntaxhighlight> | |||
=== E === | |||
==== enableAutoActions ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States''. In {{Name|arma2|short}} there's a single occurrence of it being ''true'': {{hl|class TestDance}}. | |||
== | <syntaxhighlight lang="cpp"> | ||
enableAutoActions = 1; | |||
</syntaxhighlight> | |||
==== enableBinocular ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', defines whether the character can use binoculars or not. | |||
= | <syntaxhighlight lang="cpp"> | ||
enableBinocular = 1; | |||
enableBinocular = false; // class CutSceneAnimationBase | |||
enableBinocular = false; // class AmovPercMrunSnonWbinDf_rfl | |||
enableBinocular = true; // class AwopPknlMstpSoptWbinDnon_rfl | |||
</syntaxhighlight> | |||
= | ==== enableMissile ==== | ||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', similar to ''disableWeapons''. It enables/disables the firing of shoulder launched rockets (''RPGs, MANPADS''). | |||
= | <syntaxhighlight lang="cpp"> | ||
enableMissile = true; //class AidlPercMstpSrasWlnrDnon_player_idleSteady01 | |||
enableMissile = 1; | |||
</syntaxhighlight> | |||
== | ==== enableOptics ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Boolean]] | ||
;Description: Found in ''States'', enables/disables looking down the weapon sights. | |||
<syntaxhighlight lang="cpp"> | |||
enableOptics = 1; | |||
</syntaxhighlight> | |||
== | ==== equivalentTo ==== | ||
[[TokenNameValueTypes|String]] | ;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. | ||
<syntaxhighlight lang="cpp"> | |||
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"; | |||
</syntaxhighlight> | |||
== | ==== EvasiveBack ==== | ||
[[TokenNameValueTypes|String]] | ;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. | ||
<syntaxhighlight lang="cpp"> | |||
EvasiveBack = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDb"; | |||
</syntaxhighlight> | |||
== | ==== EvasiveForward ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#EvasiveBack | EvasiveBack]]''. | |||
<syntaxhighlight lang="cpp"> | |||
EvasiveForward = "AmovPercMevaSlowWlnrDf"; | |||
</syntaxhighlight> | |||
== | ==== EvasiveLeft ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#EvasiveBack | EvasiveBack]]''. | |||
<syntaxhighlight lang="cpp"> | |||
EvasiveLeft = "AmovPercMrunSlowWrflDf_AmovPercMevaSrasWrflDl"; | |||
</syntaxhighlight> | |||
== | ==== EvasiveRight ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#EvasiveBack | EvasiveBack]]''. | |||
<syntaxhighlight lang="cpp"> | |||
EvasiveRight = "AmovPpneMstpSrasWrflDnon_AmovPpneMevaSlowWrflDr"; | |||
</syntaxhighlight> | |||
== | === F === | ||
[[TokenNameValueTypes|String]] | ==== fast.. ==== | ||
''' | ;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. | |||
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). | |||
== | <syntaxhighlight lang="cpp"> | ||
fastB = "AswmPercMstpSnonWnonDnon"; | |||
fastB = "AmovPercMrunSrasWrflDb"; | |||
fastF = "AswmPercMsprSnonWnonDf"; | |||
fastL = "AswmPercMstpSnonWnonDnon"; | |||
fastLB = "AswmPercMstpSnonWnonDnon"; | |||
fastLF = "AswmPercMsprSnonWnonDf"; | |||
fastR = "AswmPercMstpSnonWnonDnon"; | |||
fastRB = "AswmPercMstpSnonWnonDnon"; | |||
fastRF = "AswmPercMsprSnonWnonDf"; | |||
</syntaxhighlight> | |||
==== file ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''States'', points to the ''[[RTM]]'' animation file. | |||
= | <syntaxhighlight lang="cpp"> | ||
file = "\ca\Anims\Characters\data\Anim\Wmn\cts\erc\stp\non\non\ActsPercMstpSnonWnonDnon_MarianQ_shot5.rtm"; | |||
</syntaxhighlight> | |||
== | ==== FireNotPossible ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions''. | |||
<syntaxhighlight lang="cpp"> | |||
FireNotPossible = "AmovPpneMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | === G === | ||
[[TokenNameValueTypes|String]] | ==== 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''. | |||
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]]''. | |||
= | <syntaxhighlight lang="cpp"> | ||
getInAction = "GetInCar"; //CfgVehicles | |||
getInCar = "AmovPknlMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== GetInHigh ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#getInCar | getInCar]]''. | |||
<syntaxhighlight lang="cpp"> | |||
GetInHigh = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInHigh"; | |||
</syntaxhighlight> | |||
== | ==== GetInLow ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#getInCar | getInCar]]''. | |||
<syntaxhighlight lang="cpp"> | |||
GetInLow = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInLow"; | |||
</syntaxhighlight> | |||
== | ==== GetInMedium ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#getInCar | getInCar]]''. | |||
<syntaxhighlight lang="cpp"> | |||
GetInMedium = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInMedium"; | |||
</syntaxhighlight> | |||
== | ==== getInTank ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#getInCar | getInCar]]''. | |||
<syntaxhighlight lang="cpp"> | |||
getInTank = "AmovPknlMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== getOutCar ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#getInCar | getInCar]]''. | |||
<syntaxhighlight lang="cpp"> | |||
getOutCar = "AmovPknlMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== GetOutHigh ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#getInCar | getInCar]]''. | |||
<syntaxhighlight lang="cpp"> | |||
GetOutHigh = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutHigh"; | |||
</syntaxhighlight> | |||
== | ==== GetOutLow ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#getInCar | getInCar]]''. | |||
<syntaxhighlight lang="cpp"> | |||
GetOutLow = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutLow"; | |||
</syntaxhighlight> | |||
= | ==== GetOutMedium ==== | ||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: See ''[[#getInCar | getInCar]]''. | |||
== | <syntaxhighlight lang="cpp"> | ||
GetOutMedium = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutMedium"; | |||
</syntaxhighlight> | |||
==== getOutTank ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: See ''[[#getInCar | getInCar]]''. | |||
== | <syntaxhighlight lang="cpp"> | ||
getOutTank = "AmovPknlMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
=== 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. | |||
= | <syntaxhighlight lang="cpp"> | ||
handGunOn = "AmovPercMstpSrasWpstDnon"; //class RifleBaseLowStandActions | |||
handGunOn = "AmovPpneMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== hasCollShapeSafe ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Boolean]] | ||
<syntaxhighlight lang="cpp"> | |||
hasCollShapeSafe = 0; | |||
</syntaxhighlight> | |||
== | ==== head ==== | ||
[[TokenNameValueTypes| | ;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]]''. | ||
<syntaxhighlight lang="cpp"> | |||
head = "headDefault"; // class Default | |||
head = "headNo"; // class CutSceneAnimationBase | |||
head = "empty"; // class HaloFreeFall_non | |||
</syntaxhighlight> | |||
= | ==== headDefault[] ==== | ||
;Type: [[TokenNameValueTypes|Array]] | |||
;Description: Found in class ''BlendAnims'', defines a set of bones, with weights associated to each of them. | |||
= | <syntaxhighlight lang="cpp"> | ||
headDefault[] = {"head", 1, "neck1", 0.5, "neck", 0.5}; | |||
headDefault[] = {}; | |||
</syntaxhighlight> | |||
== | ==== headNo[] ==== | ||
[[TokenNameValueTypes|Array]] | ;Type: [[TokenNameValueTypes|Array]] | ||
''' | ;Description: Found in class ''BlendAnims'', always an empty array. Serves for disabling free head movement (independent of the ''[[RTM]]'' animation). | ||
<syntaxhighlight lang="cpp"> | |||
headNo[] = {}; | |||
</syntaxhighlight> | |||
== | ====headBobMode ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Number]] | ||
;Description: | |||
Valid values | |||
<syntaxhighlight lang="cpp"> | |||
HeadBobUndef = 0 | |||
HeadBobRaw = 1 | |||
HeadBobBeginEnd = 2 | |||
HeadBobAverageFrame = 3 | |||
HeadBobStraightHorizon = 4 | |||
HeadBobCutScene = 5 | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="cpp"> | |||
headBobMode = 5; // Cutscene | |||
</syntaxhighlight> | |||
=== I === | |||
==== interpolateFrom[] ==== | |||
;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. | |||
= | <syntaxhighlight lang="cpp"> | ||
interpolateFrom[] = {"TestSurrender", 0.9, "AdthPercMstpSlowWrflDnon_1", 0.9}; | |||
</syntaxhighlight> | |||
== | ==== interpolateTo[] ==== | ||
[[TokenNameValueTypes| | ;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. | |||
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. | |||
= | <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> | |||
==== interpolateWith[] ==== | |||
;Type: [[TokenNameValueTypes|Array]] | |||
;Description: Found in ''States'', disused. | |||
= | <syntaxhighlight lang="cpp"> | ||
[ | interpolateWith[] = {"BasicDriver", 0.02}; | ||
</syntaxhighlight> | |||
==== interpolationRestart ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', true mostly for transition animations. | |||
== | <syntaxhighlight lang="cpp"> | ||
interpolationRestart = false; // Default | |||
interpolationRestart = true; // DefaultDie | |||
interpolationRestart = 2; | |||
</syntaxhighlight> | |||
==== interpolationSpeed ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: Found in ''States''. | |||
== | <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> | |||
=== J === | |||
==== JumpOff ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions'', disused. | |||
== | <syntaxhighlight lang="cpp"> | ||
JumpOff = ""; | |||
</syntaxhighlight> | |||
=== L === | |||
==== ladderOff ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''States'', defines what animation to switch to when letting go of the ladder. | |||
== | <syntaxhighlight lang="cpp"> | ||
ladderOff = "AmovPercMstpSnonWnonDnon"; | |||
</syntaxhighlight> | |||
==== ladderOffBottom ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''States'', defines what animation to switch to when letting go of the ladder, having reached the bottom of it. | |||
== | <syntaxhighlight lang="cpp"> | ||
ladderOffBottom = "LadderRifleDownOff"; | |||
</syntaxhighlight> | |||
==== ladderOffTop ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''States'', defines what animation to switch to when letting go of the ladder, having reached the top of it. | |||
== | <syntaxhighlight lang="cpp"> | ||
ladderOffTop = "LadderRifleTopOff"; | |||
</syntaxhighlight> | |||
==== ladderOnDown ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''States'', defines what animation to switch to when getting onto the bottom of the ladder. | |||
== | <syntaxhighlight lang="cpp"> | ||
ladderOnDown = "LadderRifleOn"; | |||
</syntaxhighlight> | |||
==== ladderOnUp ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''States'', defines what animation to switch to when getting onto the top of the ladder. | |||
== | <syntaxhighlight lang="cpp"> | ||
ladderOnUp = "LadderRifleOn"; | |||
</syntaxhighlight> | |||
==== leaning ==== | |||
;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 is best. | |||
<syntaxhighlight lang="cpp"> | |||
leaning = "leaningDefault"; // Default | |||
leaning = "aimingLying"; // AmovPpneMstpSrasWrflDnon_injured | |||
leaning = "empty"; // class AmovPpneMrunSlowWrflDf - disables leaning while prone | |||
</syntaxhighlight> | |||
== | ==== leaningCorrectionAngleBeg ==== | ||
[[TokenNameValueTypes|Float]] | ;Type: [[TokenNameValueTypes|Float]] | ||
''' | ;Description: Not used in {{Name|arma2|short}}, appearing only once in {{Name|arma1|short}} config, where both ''leaningCorrectionAngleBeg'' and ''leaningCorrectionAngleEnd'' are zero. | ||
<syntaxhighlight lang="cpp"> | |||
leaningCorrectionAngleBeg = 0; | |||
leaningCorrectionAngleEnd = 0; | |||
</syntaxhighlight> | |||
== | ==== leaningFactorBeg ==== | ||
[[TokenNameValueTypes|Float]] | ;Type: [[TokenNameValueTypes|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. | ||
<syntaxhighlight lang="cpp"> | |||
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- | |||
</syntaxhighlight> | |||
==== leaningFactorEnd ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: See above. | |||
= | <syntaxhighlight lang="cpp"> | ||
leaningFactorEnd = 0.75; | |||
</syntaxhighlight> | |||
==== leaningFactorZeroPoint ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: Appears only once in both {{Name|arma1|short}} & {{Name|arma2|short}}, no variation across ''States'' or ''Actions''. | |||
== | <syntaxhighlight lang="cpp"> | ||
leaningFactorZeroPoint = -1; | |||
</syntaxhighlight> | |||
==== leanLRot ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: Found in ''Actions'', sets the amount of lean possible and the angle of leaning. | |||
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. | |||
<syntaxhighlight lang="cpp"> | |||
leanLRot = 0; // NoActions, RifleProneActions | |||
leanLRot = 0.5; // RifleBaseLowStandActions | |||
leanLRot = 0.57; // CivilStandActions | |||
</syntaxhighlight> | |||
== | ==== leanLShift ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|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. | |||
== | <syntaxhighlight lang="cpp"> | ||
leanLShift = 0; // class RifleProneActions | |||
leanLShift = 0.01; // class RifleBaseLowStandActions | |||
leanLShift = 0.07; // class CivilStandActions | |||
</syntaxhighlight> | |||
==== leanRRot ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: See [[#leanLRot | leanLRot]]. | |||
== | <syntaxhighlight lang="cpp"> | ||
leanRRot = 0.57; | |||
</syntaxhighlight> | |||
==== leanRShift ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: See [[#leanLShift | leanLShift]]. | |||
== | <syntaxhighlight lang="cpp"> | ||
leanRShift = 0.01; | |||
</syntaxhighlight> | |||
==== leftHandIKBeg ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', appeared in {{Name|arma1|short}}, complemented/superseded in {{Name|arma2|short}} 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'' <sup>(see below for more details)</sup> blending. | |||
= | Typical uses: | ||
<syntaxhighlight lang="cpp"> | |||
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; | |||
</syntaxhighlight> | |||
= | ==== leftHandIKEnd ==== | ||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: See above. | |||
== | <syntaxhighlight lang="cpp"> | ||
leftHandIKEnd = 0; | |||
</syntaxhighlight> | |||
==== 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. | |||
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 {{hl|0-1}}, where {{hl|0}} is animation start, {{hl|0.5}} is half way, and {{hl|1}} the end. | |||
'' | |||
''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''. | |||
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''. | |||
= | <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> | |||
== | ==== legs ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|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 {{Name|bi|short}} 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. | |||
'' | |||
<syntaxhighlight lang="cpp"> | |||
legs = "legsDefault"; // Deafault | |||
legs = "legsNo"; // DefaultDie | |||
legs = "legsLyingAiming"; // AmovPpneMstpSrasWrflDnon_injured | |||
legs = "Wholebody"; // AmovPpneMstpSnonWnonDnon | |||
legs = "empty"; // HaloFreeFall_non | |||
</syntaxhighlight> | |||
== | ==== legsDefault[] ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Array]] | ||
;Description: ''BlendAnims'' class entry. See above. | |||
<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> | |||
== | ==== legsNo[] ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Array]] | ||
''' | ;Description: Always empty ''BlendAnims'' class entry, see ''[[#legs | legs]]'' above. Disables all deformations on contact with land. Death animations are a typical case. | ||
<syntaxhighlight lang="cpp"> | |||
legsNo[] = {}; | |||
</syntaxhighlight> | |||
== | ==== limitFast ==== | ||
[[TokenNameValueTypes|Float]] | ;Type: [[TokenNameValueTypes|Float]] | ||
''' | ;Description: Found in ''Actions'', used for limiting the ''[[#slow.. | slow..]]'' movements, although the names suggests a limiting of ''[[#fast.. | fast..]]''. | ||
<syntaxhighlight lang="cpp"> | |||
limitFast = 0.5; // RifleProneActions_injured | |||
limitFast = 2; // SwimmingActions | |||
limitFast = 4; // class CivilStandActions, SwimmingFastActions | |||
limitFast = 5; // NoActions | |||
limitFast = 5.5; // RifleBaseLowStandActions | |||
</syntaxhighlight> | |||
== | ==== limitGunMovement ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Boolean]] | ||
;Description: Found in ''States''. | |||
<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> | |||
== | ==== looped ==== | ||
[[TokenNameValueTypes|Boolean]] | ;Type: [[TokenNameValueTypes|Boolean]] | ||
;Description: Found in ''States'', sets whether the current animation should start over once it is finished. Loop, that is. | |||
<syntaxhighlight lang="cpp"> | |||
looped = 1; | |||
</syntaxhighlight> | |||
== | ==== Lying ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|String]] | ||
''' | ;Description: Found in ''Actions'', points to the animation to play for the "''Prone with weapon''" situation. ''[[#CivilLying | CivilLying]]'' is the unarmed equivalent. | ||
<syntaxhighlight lang="cpp"> | |||
Lying = "AmovPpneMstpSnonWnonDnon"; | |||
</syntaxhighlight> | |||
== | === M === | ||
[[TokenNameValueTypes| | ==== medic ==== | ||
''' | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions'', points to the animation to be used by a medic when triggering the "''Heal..''" action. | |||
<syntaxhighlight lang="cpp"> | |||
medic = "AinvPknlMstpSlayWrflDnon_medic"; | |||
</syntaxhighlight> | |||
= | === O === | ||
==== onLadder ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', flags the animation as ladder related. | |||
== | <syntaxhighlight lang="cpp"> | ||
onLadder = 1; | |||
</syntaxhighlight> | |||
==== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
//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; | |||
</syntaxhighlight> | |||
==== onLandEnd ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: See above. | |||
== | <syntaxhighlight lang="cpp"> | ||
onLandEnd = 1; | |||
</syntaxhighlight> | |||
=== P === | |||
==== PlayerCrouch ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions''. Similar to ''[[#Crouch | Crouch]]'', except it applies only to player characters and not ''AI''. | |||
== | <syntaxhighlight lang="cpp"> | ||
PlayerCrouch = "AmovPknlMstpSrasWlnrDnon"; | |||
</syntaxhighlight> | |||
==== PlayerProne ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions''. Similar to ''[[#Lying | Lying]]'', except it applies only to player characters and not ''AI''. | |||
Sets the animation to be used when going prone. | |||
<syntaxhighlight lang="cpp"> | |||
PlayerProne = "AmovPpneMstpSnonWnonDnon"; | |||
</syntaxhighlight> | |||
== | ==== PlayerStand ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
''' | ;Description: Found in ''Actions''. Similar to ''[[#Stand | Stand]]'', except it applies only to player characters and not ''AI''. | ||
Sets the animation to be used when standing upright. | |||
== | <syntaxhighlight lang="cpp"> | ||
PlayerStand = "AwopPercMstpSoptWbinDnon_rfl"; | |||
</syntaxhighlight> | |||
==== predictSpeedCoef ==== | |||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: Disused in {{Name|arma2|short}}, appears once in {{Name|arma1|short}}. | |||
== | <syntaxhighlight lang="cpp"> | ||
predictSpeedCoef = 1; | |||
</syntaxhighlight> | |||
==== 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. | |||
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. | |||
<syntaxhighlight lang="cpp"> | |||
preload = 1; | |||
</syntaxhighlight> | |||
== | ==== primaryActionMaps[] ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Array]] | ||
;Description: Outlines the main action groups. | |||
<syntaxhighlight lang="cpp"> | |||
primaryActionMaps[] = {"DeadActions", "LauncherKneelActions", "BinocProneRflActions", "BinocProneCivilActions", | |||
"RifleProneActions", "PistolProneActions", "RifleKneelActions", "PistolKneelActions", "RifleStandActions", | |||
"PistolStandActions", "RifleLowStandActions", "SwimmingActions", "CivilStandActions", | |||
"BinocKneelRflActions", "BinocStandRflActions"}; | |||
</syntaxhighlight> | |||
== | ==== putDown ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions''. Sets the animation to be used when the character puts something on the ground (e.g. dropping some equipment). | |||
<syntaxhighlight lang="cpp"> | |||
putDown = "AmovPpneMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== PutDownEnd ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Float]] | ||
;Description: Not used in the {{Name|arma1|short}} series. | |||
<syntaxhighlight lang="cpp"> | |||
PutDownEnd = ""; | |||
</syntaxhighlight> | |||
== | === R === | ||
[[TokenNameValueTypes|String]] | ==== reload... ==== | ||
''' | ;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. | |||
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''. | |||
== | <syntaxhighlight lang="cpp"> | ||
[ | //game | ||
reloadAT = "LauncherReloadKneel"; | |||
reloadMagazine[] = {"WeaponMagazineReloadStand", "Gesture"}; | |||
reloadMGun = "AmovPpneMstpSrasWrflDnon"; | |||
reloadMortar = "AmovPpneMstpSrasWrflDnon"; | |||
//custom | |||
reloadM1Garand[] = {"M1GarandMagazineReloadStand", "Gesture"}; | |||
//CfgWeapons/CfgMagazines | |||
reloadAction = "ManActReloadM1Garand"; | |||
</syntaxhighlight> | |||
== | ==== relSpeedMax ==== | ||
[[TokenNameValueTypes|Float]] | ;Type: [[TokenNameValueTypes|Float]] | ||
;Description: Found in ''States''. | |||
<syntaxhighlight lang="cpp"> | |||
relSpeedMax = 0.6; | |||
</syntaxhighlight> | |||
== | ==== relSpeedMin ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Float]] | ||
;Description: Found in ''States''. | |||
<syntaxhighlight lang="cpp"> | |||
relSpeedMin = 0.5; | |||
</syntaxhighlight> | |||
== | ==== rightHandIKBeg ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Boolean]] | ||
;Description: See ''[[#leftHandIKBeg | leftHandIKBeg]]''. | |||
<syntaxhighlight lang="cpp"> | |||
rightHandIKBeg = 1; | |||
</syntaxhighlight> | |||
== | ==== rightHandIKEnd ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Boolean]] | ||
;Description: See ''[[#leftHandIKBeg | leftHandIKBeg]]''. | |||
<syntaxhighlight lang="cpp"> | |||
rightHandIKEnd = 1; | |||
</syntaxhighlight> | |||
== | ==== rightHandIKCurve ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Array]] | ||
;Description: See ''[[#leftHandIKCurve | leftHandIKCurve]]''. | |||
<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> | |||
== | === S === | ||
[[TokenNameValueTypes|String]] | ==== salute.. ==== | ||
''' | ;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. | |||
Neither of these properties point to the transition animations, where the character is actually raising/lowering it is arm. | |||
== | <syntaxhighlight lang="cpp"> | ||
salute = "AmovPercMstpSlowWrflDnon_salute"; | |||
saluteOff = "AmovPercMstpSlowWrflDnon"; | |||
</syntaxhighlight> | |||
==== showHandGun ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', sets pistol visibility on/off. | |||
== | <syntaxhighlight lang="cpp"> | ||
showHandGun = 1; | |||
</syntaxhighlight> | |||
==== showItemInHand ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', sets item (''binoculars'', specifically) visibility on/off. | |||
== | <syntaxhighlight lang="cpp"> | ||
showItemInHand = 1; | |||
</syntaxhighlight> | |||
==== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
showItemInRightHand = 0; | |||
</syntaxhighlight> | |||
==== showWeaponAim ==== | |||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', sets whether ''crosshairs'' are displayed or not for given animation. | |||
== | <syntaxhighlight lang="cpp"> | ||
showWeaponAim = 1; | |||
</syntaxhighlight> | |||
==== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
SitDown = ""; // RifleStandSaluteActions_Idle - can't sit down while saluting | |||
sitDown = "AmovPsitMstpSlowWrflDnon"; | |||
</syntaxhighlight> | |||
==== skeletonName ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Sets the skeleton to be used. | |||
= | <syntaxhighlight lang="cpp"> | ||
skeletonName = "OFP2_ManSkeleton"; | |||
skeletonName = "WomanSkeleton"; | |||
</syntaxhighlight> | |||
== | ==== slow.. ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: See ''[[#fast.. | fast..]]''. | |||
<syntaxhighlight lang="cpp"> | |||
slowB = "AmovPercMrunSlowWlnrDb"; | |||
slowF = "AmovPercMevaSlowWlnrDf"; | |||
slowL = "AmovPercMrunSlowWlnrDl"; | |||
slowLB = "AmovPercMrunSlowWlnrDbl"; | |||
slowLF = "AmovPercMrunSlowWlnrDfl"; | |||
slowR = "AmovPercMrunSlowWlnrDr"; | |||
slowRB = "AmovPercMrunSlowWlnrDbr"; | |||
slowRF = "AswmPercMrunSnonWnonDf"; | |||
</syntaxhighlight> | |||
== | ==== soundEdge.. ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Array]] | ||
''' | ;Description: Found in ''States''. Deprecated forms ''soundEdge1'', ''soundEdge2'' (used very little in {{Name|arma1|short}}, not at all in {{Name|arma2|short}}). | ||
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. | |||
== | <syntaxhighlight lang="cpp"> | ||
[ | 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; | |||
</syntaxhighlight> | |||
== | ==== soundEnabled ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Boolean]] | ||
;Description: Found in ''States'', enables/disables sounds being played with the animation. | |||
<syntaxhighlight lang="cpp"> | |||
soundEnabled = 1; | |||
</syntaxhighlight> | |||
== | ==== soundOverride ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''States'', points to the actual sound to play with the animation. | |||
<syntaxhighlight lang="cpp"> | |||
soundOverride = "bodyfall"; | |||
</syntaxhighlight> | |||
== | ==== speed ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|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 {{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. | |||
'' | |||
<syntaxhighlight lang="cpp"> | |||
speed = 0.00833333; | |||
</syntaxhighlight> | |||
== | ==== stand ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|String]] | ||
''' | ;Description: Found in ''Actions'', see ''[[#playerStand | playerStand]]''. | ||
<syntaxhighlight lang="cpp"> | |||
Stand = "AmovPknlMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== startSwim ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions'', points to the animation to be used when starting to swim. | |||
<syntaxhighlight lang="cpp"> | |||
startSwim = "AswmPercMrunSnonWnonDf"; | |||
</syntaxhighlight> | |||
== | ==== stop ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions'', points to the animation to be used when stopping. | |||
<syntaxhighlight lang="cpp"> | |||
stop = "AinvPknlMstpSlayWrflDnon"; | |||
</syntaxhighlight> | |||
== | ==== stopRelaxed ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
''' | ;Description: Found in ''Actions'', points to the animation to be used when stopping with weapon lowered ("''SAFE''" behaviour). | ||
<syntaxhighlight lang="cpp"> | |||
StopRelaxed = "AidlPercMstpSlowWrflDnon01"; | |||
</syntaxhighlight> | |||
== | ==== stopSwim ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions'', points to the animation to be used when ending swimming. | |||
<syntaxhighlight lang="cpp"> | |||
stopSwim = "AmovPercMstpSnonWnonDnon"; | |||
</syntaxhighlight> | |||
== | ==== strokeFist ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Float]] | ||
;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. | |||
<syntaxhighlight lang="cpp"> | |||
StrokeFist = ""; | |||
</syntaxhighlight> | |||
== | ==== strokeGun ==== | ||
[[TokenNameValueTypes|String]] | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Similar to ''strokeFist'' above, attempt at melee fighting but not used. | |||
<syntaxhighlight lang="cpp"> | |||
strokeGun = "AmovPercMstpSnonWnonDnon"; | |||
</syntaxhighlight> | |||
== | === T === | ||
[[TokenNameValueTypes| | ==== takeFlag ==== | ||
''' | ;Type: [[TokenNameValueTypes|String]] | ||
;Description: Found in ''Actions'', points to the animation to be used when taking the flag during a ''CTF'' match. | |||
<syntaxhighlight lang="cpp"> | |||
takeFlag = "AinvPknlMstpSlayWrflDnon"; | |||
</syntaxhighlight> | |||
= | ==== terminal ==== | ||
;Type: [[TokenNameValueTypes|Boolean]] | |||
;Description: Found in ''States'', flags the animation as being "''terminal''". ''True'' for death animations, ''false'' for everything else. | |||
== | <syntaxhighlight lang="cpp"> | ||
terminal = 1; | |||
</syntaxhighlight> | |||
==== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
//class ManActions | |||
TestDriver = "BasicDriver"; | |||
TestDriverOut = "BasicDriverOut"; | |||
TestGunner = "BasicSittingGunner"; | |||
</syntaxhighlight> | |||
==== testDriverOut ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: See above. | |||
== | <syntaxhighlight lang="cpp"> | ||
TestDriverOut = "BasicDriverOut"; | |||
</syntaxhighlight> | |||
==== testGunner ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: See ''[[#testDriver | testDriver]]''. | |||
== | <syntaxhighlight lang="cpp"> | ||
TestGunner = "BasicSittingGunner"; | |||
</syntaxhighlight> | |||
==== throwGrenade ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions'', points to the animation to be used when throwing a grenade. | |||
== | <syntaxhighlight lang="cpp"> | ||
throwGrenade = "AmovPercMrunSlowWpstDf_AmovPercMstpSrasWpstDnon_gthThrow"; | |||
</syntaxhighlight> | |||
==== transitionsDisabled[] ==== | |||
;Type: [[TokenNameValueTypes|Array]] | |||
;Description: Empty array in both {{Name|arma1|short}} & {{Name|arma2|short}}. No apparent use for it. | |||
= | <syntaxhighlight lang="cpp"> | ||
transitionsDisabled[] = {}; | |||
</syntaxhighlight> | |||
== | ==== transitionsInterpolated[] ==== | ||
[[TokenNameValueTypes|Array]] | ;Type: [[TokenNameValueTypes|Array]] | ||
;Description: Empty array in both {{Name|arma1|short}} & {{Name|arma2|short}}. No apparent use for it. | |||
<syntaxhighlight lang="cpp"> | |||
transitionsInterpolated[] = {}; | |||
</syntaxhighlight> | |||
== | ==== transitionsSimple[] ==== | ||
[[TokenNameValueTypes|Array]] | ;Type: [[TokenNameValueTypes|Array]] | ||
;Description: Empty array in both {{Name|arma1|short}} & {{Name|arma2|short}}. No apparent use for it. | |||
<syntaxhighlight lang="cpp"> | |||
transitionsSimple[] = {}; | |||
</syntaxhighlight> | |||
== | ==== treated ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|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 | medic]]''. | ||
<syntaxhighlight lang="cpp"> | |||
treated = "AinvPknlMstpSlayWrflDnon_healed"; | |||
</syntaxhighlight> | |||
== | ==== turn... ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|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. | ||
<syntaxhighlight lang="cpp"> | |||
turnL = "AmovPercMstpSlowWrflDnon_turnL"; | |||
turnLRelaxed = "AmovPercMstpSlowWrflDnon_turnL"; | |||
turnR = "AmovPpneMstpSrasWrflDnon_turnR"; | |||
turnRRelaxed = "AmovPpneMstpSrasWrflDnon_turnR"; | |||
</syntaxhighlight> | |||
= | ==== turnSpeed ==== | ||
;Type: [[TokenNameValueTypes|Float]] | |||
;Description: Found in ''Actions'', sets turning speed. | |||
== | <syntaxhighlight lang="cpp"> | ||
turnSpeed = 0.1; | |||
</syntaxhighlight> | |||
=== U === | |||
==== untiltWeapon ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Not found in {{Name|arma2|short}}, and not really used in {{Name|arma1|short}} either. | |||
== | <syntaxhighlight lang="cpp"> | ||
untiltWeapon = "untiltWeaponDefault"; | |||
</syntaxhighlight> | |||
==== untiltWeaponDefault[] ==== | |||
;Type: [[TokenNameValueTypes|Array]] | |||
;Description: Same as above. | |||
= | <syntaxhighlight lang="cpp"> | ||
[ | untiltWeaponDefault[] = {}; | ||
</syntaxhighlight> | |||
==== 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. | |||
== | <syntaxhighlight lang="cpp"> | ||
up = "AmovPknlMstpSlowWrflDnon"; // RifleBaseLowStandActions | |||
up = "AmovPknlMstpSrasWrflDnon"; // RifleBaseStandActions | |||
up = "AmovPknlMwlkSlowWrflDf"; // RifleLowStandActionsWlkF | |||
up = "AmovPercMstpSrasWrflDnon"; // RifleKneelActions | |||
</syntaxhighlight> | |||
==== upDegree ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''Actions'', seems to define the "''upright''" stance for each action group. | |||
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. | |||
'' | |||
<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> | |||
== | ==== useFastMove ==== | ||
[[TokenNameValueTypes| | ;Type: [[TokenNameValueTypes|Boolean]] | ||
''' | ;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}}. | ||
<syntaxhighlight lang="cpp"> | |||
useFastMove = 1; | |||
</syntaxhighlight> | |||
== | === V === | ||
[[TokenNameValueTypes| | ==== variantAfter[] ==== | ||
;Type: [[TokenNameValueTypes|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''. | |||
== | <syntaxhighlight lang="cpp"> | ||
[ | variantAfter[] = {5, 10, 20}; // Default | ||
VariantAfter[] = {5, 5, 5}; // AinvPknlMstpSnonWnonDnon_medic0S | |||
variantAfter[] = {2, 3, 5}; // AidlPercMstpSlowWrflDnon_player_0S | |||
variantAfter[] = {0, 0, 0}; // AidlPercMstpSrasWrflDnon_aiming0S | |||
</syntaxhighlight> | |||
==== variantsAI[] ==== | |||
;Type: [[TokenNameValueTypes|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 {{hl|1}}. | |||
== | <syntaxhighlight lang="cpp"> | ||
[ | //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}; | |||
</syntaxhighlight> | |||
==== variantsPlayer[] ==== | |||
;Type: [[TokenNameValueTypes|Array]] | |||
;Description: Same as '''variantsAI[]''' above, except for player characters. | |||
= | <syntaxhighlight lang="cpp"> | ||
[ | variantsPlayer[] = {"AdthPercMrunSlowWlnrDf_1", 0.5, "AdthPercMrunSlowWlnrDf_2", 0.5}; | ||
</syntaxhighlight> | |||
==== 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. | |||
= | <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> | |||
= | === W === | ||
==== walk.. ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: See ''[[#fast.. | fast..]]''. | |||
= | <syntaxhighlight lang="cpp"> | ||
walkB = "AmovPercMwlkSlowWrflDb"; | |||
walkF = "AmovPercMevaSlowWlnrDf"; | |||
walkL = "AmovPercMwlkSlowWrflDl"; | |||
walkLB = "AmovPercMwlkSlowWrflDbl"; | |||
walkLF = "AswmPercMwlkSnonWnonDf"; | |||
walkR = "AmovPpneMrunSnonWnonDr"; | |||
walkR = "AswmPercMstpSnonWnonDnon"; | |||
walkRB = "AmovPercMwlkSlowWrflDbr"; | |||
walkRF = "AmovPercMwlkSlowWrflDfr"; | |||
</syntaxhighlight> | |||
= | ==== weaponOff ==== | ||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: The opposite of ''weaponOn'' below. | |||
<syntaxhighlight lang="cpp"> | |||
weaponOff = "AmovPercMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
==== weaponOn ==== | |||
;Type: [[TokenNameValueTypes|String]] | |||
;Description: Found in ''States'', and references the animation that needs to be reached when switching to ''RPGs/MANPADS''. | |||
''' | |||
<syntaxhighlight lang="cpp"> | |||
weaponOn = "AmovPknlMstpSrasWlnrDnon"; // RifleBaseLowStandActions | |||
weaponOff = "AmovPercMstpSrasWrflDnon"; | |||
weaponOn = "AmovPknlMstpSrasWlnrDnon"; // RifleKneelActions | |||
weaponOff = "AmovPknlMstpSrasWrflDnon"; | |||
weaponOn = "AmovPknlMstpSrasWlnrDnon"; // RifleProneActions | |||
weaponOff = "AmovPpneMstpSrasWrflDnon"; | |||
</syntaxhighlight> | |||
{{ConfigPage|end}} | |||
{{GameCategory|ofp|Editing}} | |||
[[Category: | {{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[]
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[]
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
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
GetInHigh = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInHigh";
GetInLow
GetInLow = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInLow";
GetInMedium
GetInMedium = "AmovPercMstpSnonWnonDnon_AcrgPknlMstpSnonWnonDnon_getInMedium";
getInTank
getInTank = "AmovPknlMstpSrasWrflDnon";
getOutCar
getOutCar = "AmovPknlMstpSrasWrflDnon";
GetOutHigh
GetOutHigh = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutHigh";
GetOutLow
GetOutLow = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutLow";
GetOutMedium
GetOutMedium = "AcrgPknlMstpSnonWnonDnon_AmovPercMstpSrasWrflDnon_getOutMedium";
getOutTank
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
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..
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
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..
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";