Difference between revisions of "cmf common fnc setRole"

From cluster wiki
Jump to navigation Jump to search
Line 28: Line 28:
|x2= {{code|lang=scilab|// Set this object's role to "MED" and team to 1
|x2= {{code|lang=scilab|// Set this object's role to "MED" and team to 1
[this, "MED", 1] call emf_gameplay_fnc_setRole;}}
[this, "MED", 1] call emf_gameplay_fnc_setRole;}}
|v1= {{!}} '''GLOBAL''' {{!}}{{!}} '''Unit''' {{!}}{{!}} '''cmf_common_role''' {{!}}{{!}} A [https://community.bistudio.com/wiki/String String] variable containing the assigned unit's CMF role. e.g. "RFL"
|v2= {{!}} '''GLOBAL''' {{!}}{{!}} '''Unit''' {{!}}{{!}} '''cmf_common_team''' {{!}}{{!}} A [https://community.bistudio.com/wiki/String String] variable containing the assigned unit's CMF team. e.g. 0


|notes=
|notes=
'''Internal Variables:'''
{{{!}} class="wikitable"
! Locality !! Namespace !! Name !! Description
{{!}}-
{{!}} '''GLOBAL''' {{!}}{{!}} '''Unit''' {{!}}{{!}} '''cmf_common_role''' {{!}}{{!}} A [https://community.bistudio.com/wiki/String String] variable containing the assigned unit's CMF role. e.g. "RFL"
{{!}}-
{{!}} '''GLOBAL''' {{!}}{{!}} '''Unit''' {{!}}{{!}} '''cmf_common_team''' {{!}}{{!}} A [https://community.bistudio.com/wiki/String String] variable containing the assigned unit's CMF team. e.g. 0
{{!}}}
'''Events:'''
'''Events:'''
{{{!}} class="wikitable"
{{{!}} class="wikitable"

Revision as of 16:22, 5 November 2022


Hover & click on the images for description
Description
Description:
This function sets the team and squad role of a playerunit, due to how i use EMF in missions it is required for a lot of functions in EMF. it is recommended you run this function for each playable unit in your mission.
Execution:
Call
Groups:
CMF3: common
Syntax
Syntax:
[unit, role, team] call cmf_common_fnc_setRole
Parameters:
unit: Object - The unit to assign a role and team to
role: String - (Optional, deafult "RFL") Role to assign unit
team: Number - (Optional, default 0) Which team to assign unit, when 0 will use the first supplied loadoutfile
Return Value:
None
Examples
Example 1:
// Set myUnit's role to "SL"
[myUnit, "SL"] call emf_gameplay_fnc_setRole;
Example 2:
// Set this object's role to "MED" and team to 1
[this, "MED", 1] call emf_gameplay_fnc_setRole;
Additional Information
See also:
See also needed
Internal Variables
No internal variables
Events
No events
Notes
Events:
Locality Name Description
LOCAL cmf_common_onUnitRoleChanged Is fired locally for unit when the unit's role is changed.