setGroupId: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "[[Category:Scripting_Commands_Take_On_Helicopters" to "[[Category:Scripting Commands Take On Helicopters")
m (Text replacement - " \{\{GameCategory\|[a-z]+[0-9]?\|Scripting Commands\}\}" to "")
(37 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| ofp |Game name=
|game1= ofp
|version1= 1.00


|1.00|Game version=
|game2= ofpe
|version2= 1.00


|arg= global |Multiplayer Arguments=
|game3= arma1
|version3= 1.00


|eff= local |Multiplayer Effects=
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| Sets the group radio callsign, how it will be displayed in radio chat. Two groups on the same side '''cannot''' have the same callsign (different side is possible). When trying to apply the same callsign to two groups of the same side, the callsigns will simply be swapped, e.g:
|game5= arma2oa
|version5= 1.50
 
|game6= tkoh
|version6= 1.00
 
|game7= arma3
|version7= 0.50
 
|gr1= Groups
 
|arg= global
 
|eff= local
 
|descr= Sets the group radio callsign, how it will be displayed in radio chat. Two groups on the same side '''cannot''' have the same callsign (different side is possible). When trying to apply the same callsign to two groups of the same side, the callsigns will simply be swapped, e.g:
<code>group1 [[setGroupId]] ["Active Group"];
<code>group1 [[setGroupId]] ["Active Group"];
group2 [[setGroupId]] ["Inactive Group"];
group2 [[setGroupId]] ["Inactive Group"];
group2 [[setGroupId]] ["Active Group"]; {{cc|group1 is "Inactive Group" now}}</code>
group2 [[setGroupId]] ["Active Group"]; {{cc|group1 is "Inactive Group" now}}</code>


Line 20: Line 36:
Basically it is like [[format]] command but with some special group keywords (See Example 2).
Basically it is like [[format]] command but with some special group keywords (See Example 2).


{{Feature arma3 | Possible {{arma3}} values: <spoiler>
{{Feature | arma3 | Possible {{arma3}} values: <spoiler>
'''%GroupSquad''':
'''%GroupSquad''':
* "Squad1" → 1
* "Squad1" → 1
Line 91: Line 107:
* "Six" → Six
* "Six" → Six
</spoiler>}}
</spoiler>}}
{{Informative | From '''{{arma}}''', you can freely decide the callsign, e.g {{Inline code | [[group]] [[player]] [[setGroupId]] ["First Assault Recon Team"];}}.}}
{{Feature | Informative | Since '''{{arma1}}''', you can freely decide the callsign, e.g {{ic| [[group]] [[player]] [[setGroupId]] ["First Assault Recon Team"];}}.}}
{{Informative | In '''{{ofp}}''', group ID cannot be freely decided and format must be of [letter, colour, picture] or [letter, colour]. Possible values: <spoiler>
{{Feature | Informative | In '''{{ofp}}''', group ID cannot be freely decided and format must be of [letter, colour, picture] or [letter, colour]. Possible values: <spoiler>
'''Letter:'''
'''Letter:'''
* "Alpha"
* "Alpha"
Line 133: Line 149:
* STR_CFG_HQ_BASE</spoiler>}}
* STR_CFG_HQ_BASE</spoiler>}}


For the global variant of this command see [[setGroupIdGlobal]]. |DESCRIPTION=
|mp= For the global variant of this command see [[setGroupIdGlobal]].
____________________________________________________________________________________________


| group [[setGroupId]] [nameFormat, nameParam1, ..., nameParamN] |SYNTAX=
|s1= group [[setGroupId]] [nameFormat, nameParam1, ..., nameParamN]


|p1= group: [[Object]] or [[Group]] |PARAMETER1=
|p1= group: [[Object]] or [[Group]]


|p2= [nameFormat, nameParam1, ..., nameParamN]: [[Array]] |PARAMETER2=
|p2= [nameFormat, nameParam1, ..., nameParamN]: [[Array]]


|p3= nameFormat: [[String]] - format template (%keyword1 - %keyword2...etc) |PARAMETER3=
|p3= nameFormat: [[String]] - format template (%keyword1 - %keyword2...etc)


|p4= nameParam1: [[String]] - param keyword |PARAMETER4=
|p4= nameParam1: [[String]] - param keyword


| [[Nothing]] |RETURNVALUE=
|r1= [[Nothing]]
____________________________________________________________________________________________


|x1= '''{{arma3}}''':<code>[[group]] [[player]] [[setGroupId]] ["Some name for the group"];
|x1= '''{{arma3}}''':<code>[[group]] [[player]] [[setGroupId]] ["Some name for the group"];
[[hint]] [[groupId]] [[group]] [[player]]; {{cc|"Some name for the group"}}
[[hint]] [[groupId]] [[group]] [[player]]; {{cc|"Some name for the group"}}
[[player]] [[sideChat]] "lalala"; {{cc|Some name for the group (KK): "lalala"}}</code> |EXAMPLE1=
[[player]] [[sideChat]] "lalala"; {{cc|Some name for the group (KK): "lalala"}}</code>


|x2= '''{{arma3}}''':<code>[[group]] [[player]] [[setGroupId]] ["%GroupNames :{{=}}: %GroupColors", "Alpha", "GroupColor2"];
|x2= '''{{arma3}}''':<code>[[group]] [[player]] [[setGroupId]] ["%GroupNames :{{=}}: %GroupColors", "Alpha", "GroupColor2"];
[[hint]] [[groupId]] [[group]] [[player]]; {{cc|"Alpha :{{=}}: Red"}}
[[hint]] [[groupId]] [[group]] [[player]]; {{cc|"Alpha :{{=}}: Red"}}
[[player]] [[sideChat]] "lalala"; {{cc|Alpha :{{=}}: Red (KK): "lalala"}}</code> |EXAMPLE2=
[[player]] [[sideChat]] "lalala"; {{cc|Alpha :{{=}}: Red (KK): "lalala"}}</code>


|x3= '''ArmA / {{arma2}} / {{arma3}}''': <code>_group1 [[setGroupId]] ["Assault Squad"];</code> |EXAMPLE3=
|x3= '''{{arma1}} / {{arma2}} / {{arma3}}''': <code>_group1 [[setGroupId]] ["Assault Squad"];</code>


|x4= '''OFP''': <code>_group1 [[setGroupId]] ["Delta", "GroupColor4"]</code> |EXAMPLE4=
|x4= '''{{ofp}}''': <code>_group1 [[setGroupId]] ["Delta", "GroupColor4"]</code>
____________________________________________________________________________________________


| [[setGroupIdGlobal]], [[groupId]], [[group]] |SEEALSO=
|seealso= [[setGroupIdGlobal]], [[groupId]], [[group]]
}}
}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->


<dt><dt>
<dd class="notedate">Posted on April 21, 2015 - 23:21 (UTC)</dd>
<dd class="notedate">Posted on April 21, 2015 - 23:21 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
Line 174: Line 186:
List of available keywords from config: <code>"[[if]] (([[configName]] _x) select [0, 5] == 'group') [[then]] {
List of available keywords from config: <code>"[[if]] (([[configName]] _x) select [0, 5] == 'group') [[then]] {
[[diag_log]] ('%' + [[configName]] _x);
[[diag_log]] ('%' + [[configName]] _x);
[[for]] '_i' [[from]] 0 [[to]] [[count]] [[_x]] - 1 [[do]] {
[[for]] '_i' [[from]] 0 [[to]] [[count]] [[Magic Variables#x|_x]] - 1 [[do]] {
[[diag_log]] ('* ""' + [[configName]] (_x [[select]] _i) + '"" → ' + [[getText]] (([[_x]] [[select]] _i) >> 'name'));
[[diag_log]] ('* ""' + [[configName]] (_x [[select]] _i) + '"" → ' + [[getText]] (([[Magic Variables#x|_x]] [[select]] _i) >> 'name'));
};
};
}; [[false]]" [[configClasses]] ([[configFile]] >> "CfgWorlds");</code>
}; [[false]]" [[configClasses]] ([[configFile]] >> "CfgWorlds");</code>
</dd>
</dd>


<!-- Note Section END -->
</dl>
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Groups|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Object_Manipulation|{{uc:{{PAGENAME}}}}]]

Revision as of 23:45, 16 June 2021

Hover & click on the images for description

Description

Description:
Sets the group radio callsign, how it will be displayed in radio chat. Two groups on the same side cannot have the same callsign (different side is possible). When trying to apply the same callsign to two groups of the same side, the callsigns will simply be swapped, e.g: group1 setGroupId ["Active Group"]; group2 setGroupId ["Inactive Group"]; group2 setGroupId ["Active Group"]; // group1 is "Inactive Group" now The identity setup can also consist of format keywords (marked with %) and param keywords taken from CfgWorlds config. Basically it is like format command but with some special group keywords (See Example 2).
Arma 3
Possible Arma 3 values:

%GroupSquad:

  • "Squad1" → 1
  • "Squad2" → 2
  • "Squad3" → 3
  • "Squad4" → 4

%GroupPlatoon:

  • "Platoon1" → 1
  • "Platoon2" → 2
  • "Platoon3" → 3
  • "Platoon4" → 4

%GroupCompany:

  • "CompanyAlpha" → Alpha
  • "CompanyBravo" → Bravo
  • "CompanyCharlie" → Charlie
  • "CompanyDelta" → Delta
  • "CompanyEcho" → Echo
  • "CompanyFoxtrot" → Foxtrot
  • "CompanyGolf" → Golf
  • "CompanyHotel" → Hotel
  • "CompanyIndia" → India
  • "CompanyKilo" → Kilo
  • "CompanyLima" → Lima
  • "CompanyMike" → Mike
  • "CompanyNovember" → November
  • "CompanyOscar" → Oscar
  • "CompanyPapa" → Papa
  • "CompanyQuebec" → Quebec
  • "CompanyRomeo" → Romeo
  • "CompanySierra" → Sierra
  • "CompanyTango" → Tango
  • "CompanyUniform" → Uniform
  • "CompanyVictor" → Victor
  • "CompanyWhiskey" → Whiskey
  • "CompanyXray" → X-Ray
  • "CompanyYankee" → Yankee
  • "CompanyZulu" → Zulu

%GroupNames:

  • "Alpha" → Alpha
  • "Bravo" → Bravo
  • "Charlie" → Charlie
  • "Delta" → Delta
  • "Echo" → Echo
  • "Foxtrot" → Foxtrot
  • "Golf" → Golf
  • "Hotel" → Hotel
  • "November" → November
  • "Kilo" → Kilo
  • "Yankee" → Yankee
  • "Zulu" → Zulu
  • "Two" → Two
  • "Three" → Three
  • "Buffalo" → Buffalo
  • "Guardian" → Guardian
  • "Convoy" → Convoy
  • "Fox" → Fox

%GroupColors:

  • "GroupColor0" → (nothing)
  • "GroupColor1" → Black
  • "GroupColor2" → Red
  • "GroupColor3" → Green
  • "GroupColor4" → Blue
  • "GroupColor5" → Yellow
  • "GroupColor6" → Orange
  • "GroupColor7" → Pink
  • "Six" → Six
↑ Back to spoiler's top
Since Armed Assault, you can freely decide the callsign, e.g group player setGroupId ["First Assault Recon Team"];.
In Operation Flashpoint, group ID cannot be freely decided and format must be of [letter, colour, picture] or [letter, colour]. Possible values:

Letter:

  • "Alpha"
  • "Bravo"
  • "Charlie"
  • "Delta"
  • "Echo"
  • "Foxtrot"
  • "Golf"
  • "Hotel"
  • "Kilo"
  • "Yankee"
  • "Zulu"
  • "Buffalo"
  • "Convoy"
  • "Guardian"
  • "November"
  • "Two"
  • "Three"
  • "Fox"

Colour:

  • "GroupColor0" → (nothing)
  • "GroupColor1" → Black
  • "GroupColor2" → Red
  • "GroupColor3" → Green
  • "GroupColor4" → Blue
  • "GroupColor5" → Yellow
  • "GroupColor6" → Orange
  • "GroupColor7" → Pink
  • "Six" → Six
↑ Back to spoiler's top
The radio callsign strings can be overwritten in a mission by writing Stringtable entries of the same name. Some entry names:
  • STR_CFG_GRPNAMES_ALPHA
  • STR_CFG_GRPNAMES_FOX
  • STR_CFG_GRPCOL_BLACK
  • STR_CFG_GRPNAMES_SIX (unlike its name suggests, this is a "group colour")
  • STR_CFG_FIREFLYBASE
  • STR_CFG_PAPABEAR
  • STR_CFG_HQ_BASE
Multiplayer:
For the global variant of this command see setGroupIdGlobal.
Groups:
Groups

Syntax

Syntax:
group setGroupId [nameFormat, nameParam1, ..., nameParamN]
Parameters:
group: Object or Group
[nameFormat, nameParam1, ..., nameParamN]: Array
nameFormat: String - format template (%keyword1 - %keyword2...etc)
nameParam1: String - param keyword
Return Value:
Nothing

Examples

Example 1:
Arma 3:group player setGroupId ["Some name for the group"]; hint groupId group player; // "Some name for the group" player sideChat "lalala"; // Some name for the group (KK): "lalala"
Example 2:
Arma 3:group player setGroupId ["%GroupNames :=: %GroupColors", "Alpha", "GroupColor2"]; hint groupId group player; // "Alpha :=: Red" player sideChat "lalala"; // Alpha :=: Red (KK): "lalala"
Example 3:
Armed Assault / Arma 2 / Arma 3: _group1 setGroupId ["Assault Squad"];
Example 4:
Operation Flashpoint: _group1 setGroupId ["Delta", "GroupColor4"]

Additional Information

See also:
setGroupIdGlobalgroupIdgroup

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Posted on April 21, 2015 - 23:21 (UTC)
Killzone Kid
List of available keywords from config: "if ((configName _x) select [0, 5] == 'group') then { diag_log ('%' + configName _x); for '_i' from 0 to count _x - 1 do { diag_log ('* ""' + configName (_x select _i) + '"" → ' + getText ((_x select _i) >> 'name')); }; }; false" configClasses (configFile >> "CfgWorlds");