PendingConnection

Defined in: server/api.d.ts:4266

A player asking to join, handed to playerConnecting. Every identifier is reported by the player’s own client and is not verified by the server.

Methods

isPending()

isPending(): boolean

Defined in: server/api.d.ts:4323

Checks whether this connection is still waiting on a decision.

Returns

boolean

False once it was let in or turned away, or the player gave up and left; a queue drops such entries.

---

reject()

reject(reason?): void

Defined in: server/api.d.ts:4311

Turns the player away before they receive anything. Takes effect on the next server tick, whatever other handlers are still doing. Does nothing once the connection is decided or the player has left.

Parameters

reason?

string

Shown to the player as written, up to 512 bytes. Omitted, they read that the server refused the connection.

Returns

void

---

update()

update(message): void

Defined in: server/api.d.ts:4317

Shows the waiting player a line of status and restarts the admission timeout, so a queue that keeps updating its players is never timed out. Does nothing once the connection is decided or the player has left.

Parameters

message

string

One line for the player’s connecting screen, up to 256 bytes: ‘Checking the whitelist’, ‘You are 4th in the queue’.

Returns

void

Properties

discordId

readonly discordId: string

Defined in: server/api.d.ts:4285

Discord identifier the client reported, or an empty string when it had none.

---

discordName

readonly discordName: string

Defined in: server/api.d.ts:4290

Discord username the client reported, or an empty string when it had none.

---

epicId

readonly epicId: string

Defined in: server/api.d.ts:4280

Epic Games account identifier the client reported, or an empty string when it had none.

---

hardwareId

readonly hardwareId: string

Defined in: server/api.d.ts:4295

Framework hardware identifier the client reported, or an empty string when it had none.

---

ip

readonly ip: string

Defined in: server/api.d.ts:4305

The remote address the connection comes from, without its port.

---

nickname

readonly nickname: string

Defined in: server/api.d.ts:4270

The name the player asked to join under.

---

steamId

readonly steamId: string

Defined in: server/api.d.ts:4275

Steam identifier the client reported, or an empty string when it had none.

---

ticket

readonly ticket: string

Defined in: server/api.d.ts:4300

The string the client was launched with, as the ticket of its launch link, or an empty string. The framework passes it through untouched; checking it – against a one-time join ticket your own launcher or website issued, typically – is the script’s job.