Difference between revisions of "cmf common fnc setRole"
Jump to navigation
Jump to search
(Initial commit) |
m (fixed typo) |
||
| (15 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{CMF Function | {{CMF Function | ||
|game1= | |game1=arma3 | ||
|version1= | |version1=0.50 | ||
|descr=This function sets the team and squad role of a playerunit, due to how | |game2=cmf3 | ||
|version2=2.1.0 | |||
|descr=This function sets the team and squad role of a playerunit, due to how CMF3 functions it is recommended you run this function for each playable unit in your mission. | |||
|exec=Call | |exec=Call | ||
| Line 12: | Line 15: | ||
|s1=[unit, role, team] call [[cmf_common_fnc_setRole]] | |s1=[unit, role, team] call [[cmf_common_fnc_setRole]] | ||
|p1= unit: [https://community.bistudio.com/wiki/Object Object] | |p1= unit: [https://community.bistudio.com/wiki/Object Object] - The unit to assign a role and team to | ||
|p2= role: [https://community.bistudio.com/wiki/String String] - (Optional, | |p2= role: [https://community.bistudio.com/wiki/String String] - (Optional, default "RFL") Role to assign unit | ||
|p3= team: [https://community.bistudio.com/wiki/Number Number] - (Optional, default 0) Which team to assign unit, when 0 will use the first supplied loadoutfile | |p3= team: [https://community.bistudio.com/wiki/Number Number] - (Optional, default 0) Which team to assign unit, when 0 will use the first supplied loadoutfile | ||
| Line 20: | Line 23: | ||
|r1=None | |r1=None | ||
|x1= | |x1= {{code|lang=scilab|// Set myUnit's role to "SL" | ||
[myUnit, "SL"] call | [myUnit, "SL"] call cmf_common_fnc_setRole;}} | ||
|x2= {{code|lang=scilab|// Set this object's role to "MED" and team to 1 | |||
[this, "MED", 1] call cmf_common_fnc_setRole;}} | |||
|seealso= [[cmf_common_fnc_getConfigParam]] [[cmf_common_fnc_isRole]] [[cmf_common_fnc_setCallsign]] | |||
|var1= {{!}} GLOBAL {{!}}{{!}} Unit {{!}}{{!}} cmf_common_role {{!}}{{!}} A [https://community.bistudio.com/wiki/String String] variable containing the assigned unit's CMF role. e.g. "RFL" | |||
|var2= {{!}} GLOBAL {{!}}{{!}} Unit {{!}}{{!}} cmf_common_team {{!}}{{!}} A [https://community.bistudio.com/wiki/String String] variable containing the assigned unit's CMF team. e.g. 0 | |||
| | |event1= {{!}} UNITLOCAL {{!}}{{!}} cmf_common_onUnitRoleChanged {{!}}{{!}} [unit, role, team] {{!}}{{!}} Is fired locally for unit when the unit's role is changed. | ||
[ | |||
}} | }} | ||
Latest revision as of 19:08, 28 November 2023
Description
- Description:
- This function sets the team and squad role of a playerunit, due to how CMF3 functions 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, default "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 cmf_common_fnc_setRole;
- Example 2:
// Set this object's role to "MED" and team to 1 [this, "MED", 1] call cmf_common_fnc_setRole;
Additional Information
Internal Variables
| Locality | Namespace | Name | Description |
|---|---|---|---|
| GLOBAL | Unit | cmf_common_role | A String variable containing the assigned unit's CMF role. e.g. "RFL" |
| GLOBAL | Unit | cmf_common_team | A String variable containing the assigned unit's CMF team. e.g. 0 |
Events
| Locality | Name | Variables | Description |
|---|---|---|---|
| UNITLOCAL | cmf_common_onUnitRoleChanged | [unit, role, team] | Is fired locally for unit when the unit's role is changed. |
Notes