getPlayerUID: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...) |
m (Text replacement - "{{Inline code|" to "{{ic|") |
||
(6 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{RV|type=command | ||
| arma2 | | arma2 | ||
Line 6: | Line 6: | ||
|gr1 = Multiplayer | |gr1 = Multiplayer | ||
|arg= global | |arg= global | ||
Line 13: | Line 11: | ||
| Return a UniqueID of the given unit (player). | | Return a UniqueID of the given unit (player). | ||
{{ | {{Feature|important|Up until [[{{arma2oa}}]] v1.60, the result always consisted of a [[str|stringified]] number (see [[getPlayerUIDOld]]), but always had to be considered and processed as a [[String]].<!-- | ||
--> Converting it to a [[Number]] could cause precision problems, as [[Number]] cannot accurately represent integers above 16777216 (2<sup>24</sup>).<!-- | --> Converting it to a [[Number]] could cause precision problems, as [[Number]] cannot accurately represent integers above 16777216 (2<sup>24</sup>).<!-- | ||
--> Moreover, games since [[{{arma2oa}}]] v1.61 provide a value that is not all-numeric.}} | --> Moreover, games since [[{{arma2oa}}]] v1.61 provide a value that is not all-numeric.}} | ||
Line 32: | Line 30: | ||
The unique ID may be up to 100 characters long and may contain numbers, uppercase letters and underscores.<br> | The unique ID may be up to 100 characters long and may contain numbers, uppercase letters and underscores.<br> | ||
The value can be used to construct a valid variable name by appending to another valid variable name,<br> | The value can be used to construct a valid variable name by appending to another valid variable name,<br> | ||
e.g {{ | e.g {{ic|[[missionNamespace]] [[setVariable]] ["TAG_player" + _uid, _unit];}} | ||
|x1= <code>[[private]] _uid = [[getPlayerUID]] [[player]];</code> | |x1= <code>[[private]] _uid = [[getPlayerUID]] [[player]];</code> | ||
| [[BIS_fnc_getUnitByUID]], [[getPlayerUIDOld]], [[getClientState]], [[getClientStateNumber]] | |seealso= [[BIS_fnc_getUnitByUID]], [[getPlayerUIDOld]], [[getClientState]], [[getClientStateNumber]] | ||
}} | }} | ||
{{GameCategory|arma3|Scripting Commands}} | {{GameCategory|arma3|Scripting Commands}} | ||
{{GameCategory|tkoh|Scripting Commands}} | {{GameCategory|tkoh|Scripting Commands}} |
Revision as of 19:10, 27 February 2021
Description
- Description:
- Description needed
- Problems:
- In some cases, the identity of certain player units might fail to propagate to other clients and the server, which causes isPlayer and getPlayerUID to incorrectly return false and "" respectively, where the affected units are not local - see this bug report (GitHub). Therefore, beware of false negatives.
- Groups:
- Multiplayer
Syntax
- Syntax:
- Syntax needed
- Parameters:
- unit: Object
- Return Value:
- Return value needed
Examples
- Example 1:
private _uid = getPlayerUID player;
Additional Information
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