Skip to main content
Blueprint

Client

Server Queue Client Subsystem (Game Instance subsystem) is everything a client needs to queue for a server.

Functions​

FunctionDescription
Set Auth TicketThe ticket sent to the server's auth provider. Call before Join Queue
Join QueueQueues for a server (host[:beacon port]) and travels there when a slot is ready
Join Queue With PartyQueues as party leader with the listed member ids
Join Queue As Party MemberJoins the leader's party in the queue
Leave QueueLeaves the queue
Travel To ServerTravels to the server with the reserved slot, when Auto Travel On Slot Ready is off
Connect To ServerConnects to a server's queue beacon without queueing, for example to ping it
DisconnectCloses the beacon connection
PingPings the beacon; the answer arrives in On Pong
Get StateThe client state, see below
Get Queue Position, Get Queue LengthPosition and length in places; a waiting party counts once
Get Estimated WaitEstimated wait in seconds
Is In Party, Get Party Num Joined, Get Party SizeParty progress while waiting

Events​

EventWhen
On State ChangedThe client state changed
On Queue UpdatedNew position, queue length and wait estimate
On Party UpdatedHow many party members are in the queue, out of the party size
On Slot ReadyA slot is reserved; the client travels unless Auto Travel On Slot Ready is off
On Join RefusedThe queue refused the join, with the reason (below)
On Reservation ExpiredThe reserved slot was not used in time
On WelcomeConnected to the queue beacon (and verified, with an auth provider)
On PongAnswer to Ping, with the round trip and the server's info
On RejectedThe server rejected the connection: protocol mismatch, no usable player id, or shutting down
On Connection LostThe queue connection is gone and the client stopped trying, or the server refused to verify the player

Client states​

StateMeaning
IdleNot connected to a queue
ConnectingConnecting to the server's queue beacon
ConnectedConnected, not in the queue
QueuedWaiting in the queue
Slot ReadyA slot is reserved; the client may travel to the server
ReconnectingLost the queue connection and trying to get the position back

Join results​

ResultMeaning
Slot ReadyA slot is reserved for the player; it may connect now
QueuedThe player waits in the queue
Already In GameThe player already holds an active slot on the server
Queue FullThe queue is at Max Queue Length
Invalid PlayerThe player id is not usable
Party Too LargeThe party has more players than Max Party Size or the server's slots
Party Not FoundThe party leader is not in the queue with a party (yet)
Not In PartyThe party leader did not list this player
Party DisbandedThe party left the queue: the leader left, or it was removed

Blueprint library​

Server Queue Blueprint Library:

FunctionDescription
Format Estimated WaitTurns seconds into display text
Get Client State TextDisplay text for a client state
Get Session Queue LengthThe number of waiting players on a session search result, see Server browser
Get Player Queue IdThe queue id for a unique net id, for parties