getClientState: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "(\|[pr][0-9]+ *= *[^-]+) *- *C([a-eg-z])" to "$1 - c$2")
 
(38 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Wiki is broken I cannot add this page, says "error socket" something.
{{RV|type=command


<nowiki>
|game1= arma3
|version1= 1.08


{{Command|= Comments
|gr1= Multiplayer
____________________________________________________________________________________________


| arma3 |= Game name
|descr= Returns client state in network game. Works on both, client and dedicated server. The following states are possible:


|1.06|= Game version
{{{!}} class="wikitable"
____________________________________________________________________________________________
! [[getClientStateNumber]]
! [[getClientState]]
! Description
{{!}}-
{{!}} 0 {{!}}{{!}} "NONE" {{!}}{{!}} No client (or singleplayer)
{{!}}-
{{!}} 1 {{!}}{{!}} "CREATED" {{!}}{{!}} Client is created
{{!}}-
{{!}} 2 {{!}}{{!}} "CONNECTED" {{!}}{{!}} Client is connected to server, message formats are registered
{{!}}-
{{!}} 3 {{!}}{{!}} "LOGGED IN" {{!}}{{!}} Identity is created
{{!}}-
{{!}} 4 {{!}}{{!}} "MISSION SELECTED" {{!}}{{!}}Mission is selected
{{!}}-
{{!}} 5 {{!}}{{!}} "MISSION ASKED" {{!}}{{!}} Server was asked to send / not send mission
{{!}}-
{{!}} 6 {{!}}{{!}} "ROLE ASSIGNED" {{!}}{{!}} Role was assigned (and confirmed)
{{!}}-
{{!}} 7 {{!}}{{!}} "MISSION RECEIVED" {{!}}{{!}} Mission received
{{!}}-
{{!}} 8 {{!}}{{!}} "GAME LOADED" {{!}}{{!}} Island loaded, vehicles received
{{!}}-
{{!}} 9 {{!}}{{!}} "BRIEFING SHOWN" {{!}}{{!}} Briefing was displayed
{{!}}-
{{!}} 10 {{!}}{{!}} "BRIEFING READ" {{!}}{{!}} Ready to play mission
{{!}}-
{{!}} 11 {{!}}{{!}} "GAME FINISHED" {{!}}{{!}} Game was finished
{{!}}-
{{!}} 12 {{!}}{{!}} "DEBRIEFING READ" {{!}}{{!}} Debriefing read, ready to continue with next mission
{{!}}}


| Returns client state in network game. Works on both, client and dedicated server. |= Description
|s1= [[getClientState]]
____________________________________________________________________________________________


| '''getClientState''' |= Syntax
|r1= [[String]] - client state (see table above)


| [[String]] - Client state. Possible values are:
|x1= <sqf>_state = getClientState;</sqf>


<br/>DEBRIEFING READ
|x2= <sqf>if (getClientState == "BRIEFING READ") then { hint "Let the show begin!" };</sqf>
<br/>GAME FINISHED
<br/>BRIEFING READ
<br/>BRIEFING SHOWN
<br/>GAME LOADED
<br/>MISSION RECEIVED
<br/>ROLE ASSIGNED
<br/>MISSION ASKED
<br/>MISSION SELECTED
<br/>LOGGED IN
<br/>CONNECTED
<br/>CREATED
<br/>NONE - (Returns this in SP)


|= RETURNVALUE
|seealso= [[getClientStateNumber]] [[getPlayerUID]]
 
|x1= <code>_state = [[getClientState]];</code>|= EXAMPLE1
____________________________________________________________________________________________
 
| [[getPlayerUID]] |= SEEALSO
 
|  |= MPBEHAVIOUR
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
</nowiki>

Latest revision as of 14:00, 8 November 2023

Hover & click on the images for description

Description

Description:
Returns client state in network game. Works on both, client and dedicated server. The following states are possible:
getClientStateNumber getClientState Description
0 "NONE" No client (or singleplayer)
1 "CREATED" Client is created
2 "CONNECTED" Client is connected to server, message formats are registered
3 "LOGGED IN" Identity is created
4 "MISSION SELECTED" Mission is selected
5 "MISSION ASKED" Server was asked to send / not send mission
6 "ROLE ASSIGNED" Role was assigned (and confirmed)
7 "MISSION RECEIVED" Mission received
8 "GAME LOADED" Island loaded, vehicles received
9 "BRIEFING SHOWN" Briefing was displayed
10 "BRIEFING READ" Ready to play mission
11 "GAME FINISHED" Game was finished
12 "DEBRIEFING READ" Debriefing read, ready to continue with next mission
Groups:
Multiplayer

Syntax

Syntax:
getClientState
Return Value:
String - client state (see table above)

Examples

Example 1:
_state = getClientState;
Example 2:
if (getClientState == "BRIEFING READ") then { hint "Let the show begin!" };

Additional Information

See also:
getClientStateNumber getPlayerUID

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