Customized player intel

Upon joining in game players are attributed several additional intel. If the mission maker doesn't define specific intel the mod will set default values for them.

Definable intel are: **'Pretty' group name, radio frequency, rank insignia.**

## Setting group name and radio frequency

* Pretty group name and radio frequency are set from the editor's 'role description' field in the team leader's attributes.

*The 'pretty group name' is not set by MRH Milsim Tools but by CBA, it is a great feature that not many people are aware of. By default Arma 3 attributes names to the group styled like this for example: **Alpha 1-1** and even if you change the group's name in its attributes they will not be displayed properly. Now CBA allows you to change that to a personalized group name. To do that go in the **group leader's** attributes in the editor. There in the role description field of the group leader (and only the group leader) you can write the role description + @ + the group's pretty name.*

for example

```
Team Leader@[HITMAN1]

```

will be displayed in the lobby like this:

**Now** MRH Milsim Tools also makes use of this by piggybacking on the cba feature and using the pretty group name elsewhere (in the team roster or the admin menu for example).

In addition you can define a radio frequency by adding it after the separator | the radio frequency is just here for information purposes and has no effect on either TFAR or ACRE2.

In the example picture above the group leader's role description was set up as:

```
Team Leader@[HITMAN1]|shortwave 1

```

The radio frequency is read by various functions of MRH Milsim Tools in the Team Roster or the soldier's PDA for example.

in the following example the group leader's role description was set up as:

```
Superleader@SuperGroup|occ

```

***CAVEATS***: if the radio frequency is not defined by the mission maker or no one is slotted in the leader's slot the mod will display the radio frequency as "Undefined"

## Retrieving localized rank, rank insignia and nato code

Should you need to, you can retrieve any player's localized rank (English and French for now) by using the function MRH\_fnc\_MilsimTools\_Core\_LocRankIntel .

`Description: returns given unit's localized rank, path to rank image , nato code for the rank
you can define customized pics in a cfgMRHRankPictures, see online documentation`

`Return value: <ARRAY> of <STRINGS> in the form [localized Rank, path to image file, nato code ]`

`Public: yes
Parameters: <OBJECT> unit to check`

`Example(s):`

`_allIntel = [player] call MRH_fnc_MilsimTools_Core_LocRankIntel;`

`_localizedRank = ([player] call MRH_fnc_MilsimTools_Core_LocRankIntel) select 0;`

`_rankPaa =([player] call MRH_fnc_MilsimTools_Core_LocRankIntel) select 1;`

`_natoCode = ([player] call MRH_fnc_MilsimTools_Core_LocRankIntel) select 2;`

## Changing the default rank insignia pictures.

The mod contains and uses customized rank insignias graciously made by my mate [TGV] LeDJean. Shoul you want to change them, you can : mission makers can define their own by creating a

***cfgMRHRankPictures*** class in the mission's description.ext a template is provided in the mod's folder and an example in the demo mission.

You can use images either in .paa or .jpeg format but it is advisable to use .paa.

Your cfg should contain path to the new pictures in the form:

```
rankPic = "\pathtomyimage.paa";

```

Your class cfgMRHRankPictures should contain 7 subclasses (one for each Arma 3 rank)

Each subclass can be named anything you want and should contain 2 entries

rankPic: path to the picture

rank: capitalized rank name, (copy paste the example and do not change them)

```
class Whatever_you_want_to_name_it
   	{
   		rankPic = "directory\pathtoyourimage.paa"; // path to the pic
   		rank = "PRIVATE"; // rank in Arma 3 format
   	};

```

Example CFG:

```
class cfgMRHRankPictures
      {
      allMRHRanks[] = {"YOURRANKCLASSNAME_PRIVATE","YOURRANKCLASSNAME_CORPORAL",etc};
     // list your personnal rank classes above between quotes and separated by comas
      	class YOURRANKCLASSNAME_PRIVATE
      	{
      		rankPic = "directory\pathtoyourimage.paa";
      		rank = "PRIVATE";
      	};
      		class YOURRANKCLASSNAME_CORPORAL
      	{
      		rankPic = "directory\pathtoyourimage.paa";
      		rank = "CORPORAL";
      	};
      		class YOURRANKCLASSNAME_SERGEANT
      	{
      		rankPic = "directory\pathtoyourimage.paa";
      		rank = "SERGEANT";
      	};
      		class YOURRANKCLASSNAME_LIEUTENANT
      	{
      		rankPic = "directory\pathtoyourimage.paa";
      		rank = "LIEUTENANT";
      	};
      		class YOURRANKCLASSNAME_CAPTAIN
      	{
      		rankPic = "directory\pathtoyourimage.paa";
      		rank = "CAPTAIN";
      	};
      		class YOURRANKCLASSNAME_MAJOR
      	{
      		rankPic = "directory\pathtoyourimage.paa";
      		rank = "MAJOR";
      	};
      		class YOURRANKCLASSNAME_COLONEL
      	{
      		rankPic = "directory\pathtoyourimage.paa";
      		rank = "COLONEL";
      	};
      };

```