playerSide: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
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...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| arma1 |Game name=
| arma1


|1.00|Game version=
|1.00


|gr1= Sides |GROUP1=
|gr1= Sides


| Returns the player's [[Side|side]]. This is valid even when the player controlled person is dead (a difference from [[side]] [[player]]).
| Returns the player's [[Side|side]]. This is valid even when the player controlled person is dead (a difference from [[side]] [[player]]).
{{Informative | [[playerSide]] will not change automatically if [[player]] [[join]]s a [[group]] on different [[side]]. However, [[selectPlayer]] command can and does change [[playerSide]] - see '''[[#Examples|Example 3]]''' for information.}} |DESCRIPTION=
{{Informative | [[playerSide]] will not change automatically if [[player]] [[join]]s a [[group]] on different [[side]]. However, [[selectPlayer]] command can and does change [[playerSide]] - see '''[[#Examples|Example 3]]''' for information.}}


| '''playerSide''' |SYNTAX=
| '''playerSide'''


| [[Side]] |RETURNVALUE=
| [[Side]]


|x1=  
|x1=  
<code>[[if]] ([[side]] man1 == '''playerSide''') [[then]] {
<code>[[if]] ([[side]] man1 == '''playerSide''') [[then]] {
     [[hint]] "man1 is on your side!";
     [[hint]] "man1 is on your side!";
};</code>|EXAMPLE1=
};</code>


|x2= <code>[[switch]] ([[playerSide]]) do {
|x2= <code>[[switch]] ([[playerSide]]) do {
Line 26: Line 26:
         [[hint]] "You are OPFOR";
         [[hint]] "You are OPFOR";
     };
     };
};</code>|EXAMPLE2=
};</code>


|x3= the following code will change the side of the player including [[playerSide]]:
|x3= the following code will change the side of the player including [[playerSide]]:
Line 33: Line 33:
[[selectNoPlayer]];  
[[selectNoPlayer]];  
[[selectPlayer]] _player;
[[selectPlayer]] _player;
[[hint]] [[str]] [[playerSide]]; {{cc|EAST}}</code> |EXAMPLE3=
[[hint]] [[str]] [[playerSide]]; {{cc|EAST}}</code>


| [[Side]], [[side]], [[west]], [[east]], [[resistance]], [[civilian]], [[sideLogic]], [[sideFriendly]], [[sideEnemy]], [[sideUnknown]], [[sideEmpty]], [[sideAmbientLife]], [[Side relations]] |SEEALSO=
| [[Side]], [[side]], [[west]], [[east]], [[resistance]], [[civilian]], [[sideLogic]], [[sideFriendly]], [[sideEnemy]], [[sideUnknown]], [[sideEmpty]], [[sideAmbientLife]], [[Side relations]]
}}
}}



Revision as of 01:27, 18 January 2021

Hover & click on the images for description

Description

Description:
Returns the player's side. This is valid even when the player controlled person is dead (a difference from side player).
playerSide will not change automatically if player joins a group on different side. However, selectPlayer command can and does change playerSide - see Example 3 for information.
Groups:
Sides

Syntax

Syntax:
playerSide
Return Value:
Side

Examples

Example 1:
if (side man1 == playerSide) then { hint "man1 is on your side!"; };
Example 2:
switch (playerSide) do { case west: { hint "You are BLUFOR"; }; case east: { hint "You are OPFOR"; }; };
Example 3:
the following code will change the side of the player including playerSide: private _player = player; [player] join createGroup east; selectNoPlayer; selectPlayer _player; hint str playerSide; // EAST

Additional Information

See also:
SidesidewesteastresistanceciviliansideLogicsideFriendlysideEnemysideUnknownsideEmptysideAmbientLifeSide relations

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

Notes

Posted on 27 Jan, 2008
Dr_Eyeball
playerSide defaults to west for JIP players early on during initialization regardless of their side.
So if you are a JIP player on another side (like east), you will need to cater for this for any early initializations.
Posted on 13 Oct, 2008
Dr_Eyeball
playerSide also shows your starting side, even if your side changes to enemy due to a bad rating. In that case, playerSide != side player.

Bottom Section