playerSide: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "[[Category:Scripting Commands ArmA|" to "[[Category:Scripting Commands Armed Assault|")
m (Text replacement - "\{\{Feature *\| *Informative *\| ([^↵]+) *\}\}" to "{{Feature|informative|$1}}")
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma |Game name=
|game1= arma1
|version1= 1.00


|1.00|Game version=
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Returns the player's [[Side|side]]. This is valid even when the player controlled person is dead (a difference from [[side]] [[player]]).<br><br>
|game3= arma2oa
{{Informative | [[playerSide]] will not change automatically if [[player]] [[join]]s a [[group]] on different [[side]]. However, [[selectPlayer]] command can and does change [[playerSide]], so the following code will change the side of the player including [[playerSide]]:
|version3= 1.50
<code>[[private]] _player <nowiki>=</nowiki> [[player]];
<nowiki>[</nowiki>[[player]]] [[join]] [[createGroup]] [[east]];
[[selectNoPlayer]];
[[selectPlayer]] _player;
[[hint]] [[str]] [[playerSide]]; // EAST</code>}} |DESCRIPTION=
____________________________________________________________________________________________


| '''playerSide''' |SYNTAX=
|game4= tkoh
|version4= 1.00


| [[Side]] |RETURNVALUE=
|game5= arma3
|version5= 0.50


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


|x2=  
|descr= Returns the player's [[Side|side]]. This is valid even when the player controlled person is dead (a difference from [[side]] [[player]]).
<code>[[switch]] ([[playerSide]]) do {
{{Feature|informative|[[playerSide]] will not change automatically if [[player]] [[join]]s a [[group]] on different [[side]]. However, [[selectPlayer]] command can and does change [[playerSide]] - see {{Link|#Example 3}} for information.}}
    [[case]] [[west]]: {
        [[hint]] "You are BLUFOR";
    };
    [[case]] [[east]]: {
        [[hint]] "You are OPFOR";
    };
};</code>|EXAMPLE2=
____________________________________________________________________________________________


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


}}
|r1= [[Side]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>
<dl class="command_description">
if (side man1 == playerSide) then
<!-- Note Section BEGIN -->
{
hint "man1 is on your side!";
};
</sqf>


<dd class="notedate">Posted on 27 Jan, 2008
|x2= <sqf>
<dt class="note">[[User:Dr_Eyeball|Dr_Eyeball]]<dd class="note">
switch (playerSide) do
[[playerSide]] defaults to [[west]] for JIP players early on during initialization regardless of their side.<br>
{
So if you are a JIP player on another side (like [[east]]), you will need to cater for this for any early initializations.
case west: { hint "You are BLUFOR"; };
case east: { hint "You are OPFOR"; };
};
</sqf>


|x3= the following code will change the side of the player including [[playerSide]]:
<sqf>
private _player = player;
[player] join createGroup east;
selectNoPlayer;
selectPlayer _player;
hint str playerSide; // EAST
</sqf>


<dd class="notedate">Posted on 13 Oct, 2008
|seealso= [[Side]] [[side]] [[west]] [[east]] [[resistance]] [[civilian]] [[sideLogic]] [[sideFriendly]] [[sideEnemy]] [[sideUnknown]] [[sideEmpty]] [[sideAmbientLife]] [[Side Relations]]
<dt class="note">[[User:Dr_Eyeball|Dr_Eyeball]]<dd class="note">
}}
[[playerSide]] also shows your starting side, even if your [[side]] changes to [[enemy]] due to a bad [[rating]]. In that case, playerSide != side player.


{{Note
|user= Dr_Eyeball
|timestamp= 20080127075200
|text= [[playerSide]] defaults to [[west]] for JIP players early on during initialization regardless of their side.<br>
So if you are a JIP player on another side (like [[east]]), you will need to cater for this for any early initializations.
}}


<!-- Note Section END -->
{{Note
</dl>
|user= Dr_Eyeball
 
|timestamp= 20081013083000
<h3 style="display:none">Bottom Section</h3>
|text= [[playerSide]] also shows your starting side, even if your [[side]] changes to [[enemy]] due to a bad [[rating]]. In that case, playerSide != side player.
[[Category:Scripting Commands|PLAYERSIDE]]
}}
[[Category:Scripting Commands OFP Elite |PLAYERSIDE]]
[[Category:Scripting Commands Armed Assault|PLAYERSIDE]]
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Sides|{{uc:{{PAGENAME}}}}]]

Latest revision as of 18:11, 15 March 2024

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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:
Side side west east resistance civilian sideLogic sideFriendly sideEnemy sideUnknown sideEmpty sideAmbientLife Side 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
Dr_Eyeball - c
Posted on Jan 27, 2008 - 07:52 (UTC)
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.
Dr_Eyeball - c
Posted on Oct 13, 2008 - 08:30 (UTC)
playerSide also shows your starting side, even if your side changes to enemy due to a bad rating. In that case, playerSide != side player.
Retrieved from "https://community.bistudio.com/wiki?title=playerSide&oldid=353328"