roleDescription: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(WIP, not in todays dev :()
 
m (Some wiki formatting)
 
(41 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3dev |= Game name
|game1= arma3
|version1= 1.48


|1.47|= Game version
|gr1= Object Manipulation
____________________________________________________________________________________________


| Returns unit description set in Editor and visible on role selection screen in MP. Returns "" in SP.|= Description
|gr2= Multiplayer
____________________________________________________________________________________________


| '''roleDescription''' unit |= Syntax
|descr= Returns unit description set in the editor and visible on role selection screen in multiplayer.


|p1= unit: [[Object]] |=
|pr= '''Does not''' work in single player.


| [[String]] |= Return value
|s1= [[roleDescription]] unit
____________________________________________________________________________________________


| [[name]], [[getPlayerUID]], [[vehicleVarName]], [[worldName]], [[briefingName]], [[missionName]], [[serverName]]|= See also
|p1= unit: [[Object]]


|r1= [[String]]
|x1= <sqf>_playerRole = roleDescription player;</sqf>
|seealso= [[name]] [[getPlayerUID]] [[vehicleVarName]] [[worldName]] [[briefingName]] [[missionName]] [[serverName]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Killzone_Kid
|timestamp= 20150629120500
|text= One thing you should know about roles. When switching to units placed in editor on the fly in MP, it could mess up the role of the player. Could be bug, could be intended, but I would not recommend doing this. Create new unit dynamically if you need to switch to. Anyway, if role of the unit is messed up so is [[roleDescription]].
}}


</dl>
{{Note
 
|user= Pierre MGI
<h3 style="display:none">Bottom Section</h3>
|timestamp= 20170526011000
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
|text= [[roleDescription]] works for playableUnits only. That means not on AI disabled in lobby and not in SP (even for player).
}}

Latest revision as of 00:46, 22 July 2022

Hover & click on the images for description

Description

Description:
Returns unit description set in the editor and visible on role selection screen in multiplayer.
Problems:
Does not work in single player.
Groups:
Object ManipulationMultiplayer

Syntax

Syntax:
roleDescription unit
Parameters:
unit: Object
Return Value:
String

Examples

Example 1:
_playerRole = roleDescription player;

Additional Information

See also:
name getPlayerUID vehicleVarName worldName briefingName missionName serverName

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
Killzone_Kid - c
Posted on Jun 29, 2015 - 12:05 (UTC)
One thing you should know about roles. When switching to units placed in editor on the fly in MP, it could mess up the role of the player. Could be bug, could be intended, but I would not recommend doing this. Create new unit dynamically if you need to switch to. Anyway, if role of the unit is messed up so is roleDescription.
Pierre MGI - c
Posted on May 26, 2017 - 01:10 (UTC)
roleDescription works for playableUnits only. That means not on AI disabled in lobby and not in SP (even for player).