playersNumber: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (improved note formatting.)
 
(50 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofpr |= Game name
|game1= ofp
|version1= 1.80


|1.8|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| Returns count of occupied role selection slots for given side. Players who claimed a slot in the lobby but didn't start the mission are counted as well. If <tt>disabledAI <nowiki>=</nowiki> 0;</tt> in [[description.ext#disabledAI|description.ext]] or Enable AI option is checked in [[3DEN]], AI bots will be treated as valid players and will be counted too. Multiplayer only, in singleplayer always returns 0.  |= Description
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


| '''playersNumber''' side |= Syntax
|game4= arma2
|version4= 1.00


|p1= side: [[Side]] |= Parameter 1
|game5= arma2oa
|version5= 1.50


| [[Number]] |= Return value
|game6= tkoh
____________________________________________________________________________________________
|version6= 1.00
 
|x1= <code>_west = [[playersNumber]] [[west]];
_east = [[playersNumber]] [[east]];
_civ = [[playersNumber]] [[civilian]];
[[hint]] [[format]] ["West:%1 East:%2, Civ:%3", _west, _east, _civ];</code>
|= Example 1


____________________________________________________________________________________________
|game7= arma3
|version7= 0.50


| [[countSide]], [[allPlayers]], [[allUnits]] |= See also
|gr1= Multiplayer


}}
|descr= Returns count of occupied role selection slots for given side. Players who claimed a slot in the lobby but did not start the mission are counted as well. If <syntaxhighlight lang="cpp" inline>disabledAI = 0;</syntaxhighlight> in [[Description.ext#disabledAI|description.ext]] or ''Enable AI'' option is checked in [[:Category:Eden Editor|Eden Editor]], AI bots will be treated as valid players and will be counted too.
 
|mp= '''Multiplayer only''', in singleplayer it always returns 0.
 
|s1= [[playersNumber]] side
 
|p1= side: [[Side]]
 
|r1= [[Number]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>_west = playersNumber west;
<dl class="command_description">
_east = playersNumber east;
</dl>
_civ = playersNumber civilian;
hint format ["West:%1 East:%2, Civ:%3", _west, _east, _civ];</sqf>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[playableSlotsNumber]] [[countSide]] [[allPlayers]] [[allUnits]]
[[Category:Scripting Commands|PLAYERSNUMBER]]
}}
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|PLAYERSNUMBER]]
[[Category:Scripting Commands ArmA|PLAYERSNUMBER]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Multiplayer|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
{{Note
<dl class="command_description">
|user= Nelis.75733126
<dd class="notedate">Posted on April 13, 2015 - 09:44 (UTC)</dd>
|timestamp= 20150413094400
<dt class="note">[[User:IT07|IT07]]</dt>
|text= '''2024-04-16 edit:'''<br>
<dd class="note">
<sqf inline>playersNumber</sqf> returns playable AI as well as human players.<br>
playersNumber returns playable AI as well as human players. It does not include non playable AI. [NOTE: This was observed in ArmA 1.05]<br>
By default, a unit (placed down in the editor for example) ONLY becomes playable when the creator specifically checks the relevant checkbox.<br>
To get the amount of players that are on the same side as the person executing the script:
<br>
<code>playersNumber playerSide;</code>
In addition to the examples already given, this is how <sqf inline>playersNumber</sqf> can be used to get an array of players and playable AI on the same side as the side of the player:<br>
</dd>
<sqf>playersNumber playerSide;</sqf>
</dl>
|game= arma1
<!-- DISCONTINUE Notes -->
|version= 1.05
}}

Latest revision as of 19:30, 16 April 2024

Logo A0.png1.80ofpe logo.png1.00Logo 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 count of occupied role selection slots for given side. Players who claimed a slot in the lobby but did not start the mission are counted as well. If disabledAI = 0; in description.ext or Enable AI option is checked in Eden Editor, AI bots will be treated as valid players and will be counted too.
Multiplayer:
Multiplayer only, in singleplayer it always returns 0.
Groups:
Multiplayer

Syntax

Syntax:
playersNumber side
Parameters:
side: Side
Return Value:
Number

Examples

Example 1:
_west = playersNumber west; _east = playersNumber east; _civ = playersNumber civilian; hint format ["West:%1 East:%2, Civ:%3", _west, _east, _civ];

Additional Information

See also:
playableSlotsNumber countSide allPlayers allUnits

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
Nelis.75733126 - c
Posted on Apr 13, 2015 - 09:44 (UTC)
Logo A1 black.png1.05

2024-04-16 edit:
playersNumber returns playable AI as well as human players.
By default, a unit (placed down in the editor for example) ONLY becomes playable when the creator specifically checks the relevant checkbox.

In addition to the examples already given, this is how playersNumber can be used to get an array of players and playable AI on the same side as the side of the player:

playersNumber playerSide;

Retrieved from "https://community.bistudio.com/wiki?title=playersNumber&oldid=363708"