tmf:assigngear

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
tmf:assigngear [2016/07/25 23:05] – [Assign Gear] morbotmf:assigngear [2025/08/03 14:24] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ==== Assign Gear ==== ==== Assign Gear ====
-Assign gear is the name of the feature that handles gear assignment. TMF does not support using arsenal loadouts for players. This is because it is tedious to hand craft VA loadouts for each player and has often been bugged in the past. 
  
-The assigngear system makes use of faction configs. These configs can either be in a mission or included in the modpack. +Assign gear is the name of the feature that handles gear assignment. TMF does not support using arsenal loadouts for players as assign gear renders it inefficient and avoids its past bugs in doing so.
- Every faction config contains all roles within that faction (Eg. Rifleman, Fireteam Leader). Through the editor, you can then assign these roles to particular units. +
  
-==== Configuring the gear a unit gets ==== +The assigngear system makes use of faction configs. These configs can either be in a mission or included in the modpack. Every faction config contains all roles within that faction (Eg. Rifleman, Fireteam Leader). Through the editor, you can then assign these roles to particular units. 
-Firstly in Eden on any soldier you use the assign gear component by right clicking on them and clicking on attributes. You will find the following section. This menu will automatically be filled will roles from faction configs that are present in either the missionfile or modpack.+ 
 +==== Configuring unit role assignment ==== 
 + 
 +To use the assign gear component in Eden, right click on the unit(s) and click on Attributes. You will find the following section. This menu will automatically be filled will roles from faction configs that are present in either the mission file or modpack.
  
 {{:tmf:tmf_assigngear.jpg}} {{:tmf:tmf_assigngear.jpg}}
  
 ==== Switching faction configs ==== ==== Switching faction configs ====
-To add more or tweak the factions available in a mission you need to open the file description.ext in the mission folder. There will be a section called 'class CfgLoadouts'+ 
 +**Tip! We provide a variety of finished presets through our mod pack, all of which can be found retrieved as .hpp files [[https://github.com/Sniperhid/1tac_misc/tree/master/addons/tm_tmf_loadouts|here]].** 
 + 
 +To add to or tweak the factions available in a mission, open the file description.ext in the mission folder. There is a section called 'class CfgLoadouts'
  
 {{:tmf:assigngear_loadouts.jpg}} {{:tmf:assigngear_loadouts.jpg}}
  
-Here you can create extra factions. You can also override the default ones. By default BLU_F, OPF_F, IND_F are used for the units in the template so if you change the class name of a faction BLU_F it will then be used by all NATO units in the default template. This is because faction configs are looked for first in the mission and then in the modpack and the NATO, FIA, CSAT and FIA faction configs are in the modpack rather than the mission.+Here you can create extra factions, or override the default ones. For the units in the template, BLU_F, OPF_F, IND_F are used by default; if you change the class name of a faction to BLU_F it will be used by all BLUFOR units in the default template. This is because faction configs are first taken from the mission file, while the default 'vanilla' loadouts (NATO/CSAT/AAF/FIA) are contained in the modpack.
  
 ==== Creating/Modifying your own faction config ==== ==== Creating/Modifying your own faction config ====
 +
 Text editors that support syntax highlighting are recommended for creating/modifying assigngear loadouts, for example Notepad++ Text editors that support syntax highlighting are recommended for creating/modifying assigngear loadouts, for example Notepad++
  
-If you wish to create your own, copy an existing config from the Loadouts folder in the mission's folder and modify it. +If you wish to create your own, copy an existing config from the Loadouts folder in the mission's folder and modify it.
  
 === Config 101 === === Config 101 ===
-Every role (rifleman/automatic rifleman etc.) requires its own class e.g. <code cpp>class baseMan {};</code>+ 
 +Every role (rifleman/automatic rifleman etc.) requires its own class e.g. 
 + 
 +<code cpp> 
 +class baseMan {}; 
 +</code>
  
 Every class has properties with the general pattern of: Every class has properties with the general pattern of:
  
-<code cpp>PROPERTY = VALUE;</code>+<code cpp> 
 +PROPERTY = VALUE; 
 +</code>
  
 Each of these properties is responsible for different things. For example the 'displayName' property is used as a description for this particular kit so if you use 'displayName = "Rifleman";' that will set the description of that role to Rifleman. Note: There can not be two of the same property within a class. Each of these properties is responsible for different things. For example the 'displayName' property is used as a description for this particular kit so if you use 'displayName = "Rifleman";' that will set the description of that role to Rifleman. Note: There can not be two of the same property within a class.
  
-There are also array properties. Arrays are lists which take the format of: <code cpp>PROPERTY[] = {"element1", "element2", ... };</code>+There are also array properties. Arrays are lists which take the format of: 
 + 
 +<code cpp> 
 +PROPERTY[] = {"element1", "element2", ... }; 
 +</code> 
 For example: For example:
-<code cpp>linkedItems[] = {"ItemMap","ItemCompass","ItemWatch"};</code>+ 
 +<code cpp> 
 +linkedItems[] = {"ItemMap","ItemCompass","ItemWatch"}; 
 +</code> 
 Here we have an array property called linkedItems that consists of 3 elements "ItemMap", "ItemCompass" and "ItemWatch". Here we have an array property called linkedItems that consists of 3 elements "ItemMap", "ItemCompass" and "ItemWatch".
  
Line 39: Line 60:
  
 Classes can inherit from others, for example 'class g : r' means that all the properties from class r now exist in class g with the same values. 'class g : r {};' would make class g exactly the same as class r. Any property we now set in g will override the value that is inherited from r. For example: Classes can inherit from others, for example 'class g : r' means that all the properties from class r now exist in class g with the same values. 'class g : r {};' would make class g exactly the same as class r. Any property we now set in g will override the value that is inherited from r. For example:
-<code cpp>class g : r { + 
 +<code cpp> 
 +class g : r {
     displayName = "Grenadier";     displayName = "Grenadier";
-};</code>+}; 
 +</code> 
 Class g is still the same as r except the displayName has now been changed. This is useful for making variations of a given loadout; for example, often the only difference between a Grenadier and a Rifleman (g and r, respectively) is the primaryWeapon and the addition of launcher grenades: Class g is still the same as r except the displayName has now been changed. This is useful for making variations of a given loadout; for example, often the only difference between a Grenadier and a Rifleman (g and r, respectively) is the primaryWeapon and the addition of launcher grenades:
  
-<code cpp>class r : baseMan+<code cpp> 
 +class r : baseMan
 { {
     displayName = "Rifleman";     displayName = "Rifleman";
     headgear[] = {"rhsusf_lwh_helmet_marpatd"};     headgear[] = {"rhsusf_lwh_helmet_marpatd"};
- vest[] = {"rhsusf_spc_rifleman"};+    vest[] = {"rhsusf_spc_rifleman"};
     primaryWeapon[] = {"rhs_weap_m16a4_carryhandle"};     primaryWeapon[] = {"rhs_weap_m16a4_carryhandle"};
     attachment[] = {"rhsusf_acc_anpeq15side"};     attachment[] = {"rhsusf_acc_anpeq15side"};
Line 58: Line 84:
         LIST_2("SmokeShell")         LIST_2("SmokeShell")
     };     };
- items[] = +    items[] = 
- { +    { 
- LIST_3("ACE_fieldDressing"), +        LIST_3("ACE_fieldDressing"), 
- "ACE_morphine" +        "ACE_morphine" 
- };+    };
 }; };
 class g : r class g : r
Line 73: Line 99:
         LIST_4("1Rnd_Smoke_Grenade_shell")         LIST_4("1Rnd_Smoke_Grenade_shell")
     };     };
-};</code>+}; 
 +</code>
  
 As displayed above, the primary weapon assigned to the Grenadier class overrides the one inherited from the Rifleman. However, in the case of magazines, the '+=' operator is used to append to the inherited array. In the above example, the Grenadier ('g') class is given all the same items as the Rifleman ('r') class, but with the addition of smoke and HE grenades for his grenade launcher due to the use of the '+=' operator in the magazines array. As displayed above, the primary weapon assigned to the Grenadier class overrides the one inherited from the Rifleman. However, in the case of magazines, the '+=' operator is used to append to the inherited array. In the above example, the Grenadier ('g') class is given all the same items as the Rifleman ('r') class, but with the addition of smoke and HE grenades for his grenade launcher due to the use of the '+=' operator in the magazines array.
- 
  
 === Getting classnames === === Getting classnames ===
-The easiest way to get the classname of items/weapons/uniforms etc. is to use ArmA 3's Virtual Arsenal (accessible from the main menu via Tutorials -> Virtual Arsenal). In VA, you can give yourself the gear you wish to include in a loadout. Pressing the export button will copy the loadout to the clipboard. An example output will look like this:+ 
 +The easiest way to get the classname of items/weapons/uniforms etc. is to use ArmA 3's Virtual Arsenal (accessible from the main menu via Tutorials → Virtual Arsenal). In VA, you can give yourself the gear you wish to include in a loadout. Pressing the export button will copy the loadout to the clipboard. An example output will look like this: 
 <code cpp> <code cpp>
 comment "Exported from Arsenal by Snippers"; comment "Exported from Arsenal by Snippers";
Line 113: Line 141:
 this linkItem "ItemWatch"; this linkItem "ItemWatch";
 </code> </code>
 +
 It's recommended to paste the Virtual Arsenal export into an empty text file besides the config; From there, you can find the classnames of the items you wish to use and paste them into the appropriate arrays in the faction config. It's recommended to paste the Virtual Arsenal export into an empty text file besides the config; From there, you can find the classnames of the items you wish to use and paste them into the appropriate arrays in the faction config.
 +
 +
  • tmf/assigngear.1469487958.txt.gz
  • Last modified: 2025/08/04 06:49
  • (external edit)