BasePlayer

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

Framework-owned base handle for a connected player, extended by each game or mod.

Extends

• Entity

Extended by

• Player

Methods

emit()

emit(eventName, payloadJson?): void

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

Emits a named script event to this player’s client connection.

Parameters

eventName

string

Client event name.

payloadJson?

string

Optional JSON payload forwarded verbatim to the owning client.

Returns

void

---

getIP()

getIP(): string

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

Returns this player’s current remote network address.

Returns

string

Address string, or an empty string when the player or peer is unavailable.

---

getNametagColor()

getNametagColor(): number

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

Reads this player’s nametag color.

Returns

number

Packed 0xAARRGGBB color; opaque white when untinted.

---

getNametagText()

getNametagText(): string

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

Reads this player’s nametag text override.

Returns

string

The override, or an empty string when the player’s own name is drawn.

---

isNametagHealthVisible()

isNametagHealthVisible(): boolean

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

Checks whether the health bar under this player’s nametag is shown.

Returns

boolean

True unless the health bar was hidden; false also when this game has no nametags.

---

isNametagVisible()

isNametagVisible(): boolean

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

Checks whether this player’s nametag is shown to other players.

Returns

boolean

True unless the nametag was hidden; false also when this game has no nametags.

---

kick()

kick(reason?): void

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

Disconnects this player from the server.

Parameters

reason?

string

Optional reason shown to the disconnected player; omitting it uses the generic kicked reason.

Returns

void

---

setNametagColor()

setNametagColor(color): void

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

Tints the text on this player’s nametag.

Parameters

color

number

Packed 0xAARRGGBB color.

Returns

void

---

setNametagHealthVisible()

setNametagHealthVisible(visible): void

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

Shows or hides the health bar under this player’s nametag, leaving the name itself alone.

Parameters

visible

boolean

True to show the health bar under this player’s name, false to hide it.

Returns

void

---

setNametagText()

setNametagText(text?): void

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

Overrides the text drawn on this player’s nametag.

Parameters

text?

string

Text to show instead of the player’s name, cut to 64 bytes; empty or omitted restores the name.

Returns

void

---

setNametagVisible()

setNametagVisible(visible): void

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

Shows or hides the name over this player’s head for every other player. The health bar has its own switch, and each player can still hide all nametags locally.

Parameters

visible

boolean

True to show this player’s nametag to everyone, false to hide it.

Returns

void

---

setVirtualWorld()

setVirtualWorld(world): void

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

Moves this entity into another virtual world.

Parameters

world

number

Virtual-world identifier used to partition replication and visibility.

Returns

void

Inherited from

Entity.setVirtualWorld

---

setVisibleTo()

setVisibleTo(player): void

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

Restricts replication of this entity to one owning connection while preserving normal range and visibility checks.

Parameters

player

Entity | null

Player-owned entity whose connection should exclusively receive this entity, or null to clear the restriction.

Returns

void

Inherited from

Entity.setVisibleTo

---

toString()

toString(): string

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

Formats this player handle for logging and debugging.

Returns

string

Text containing the player’s network entity ID.

Overrides

Entity.toString

Properties

discordId

readonly discordId: string

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

Authenticated Discord identifier, or an empty string when unavailable.

---

discordName

readonly discordName: string

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

Discord username the client reported, not verified by the server, or an empty string when unavailable.

---

epicId

readonly epicId: string

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

Epic Games account identifier the client reported, not verified by the server, or an empty string when unavailable.

---

hardwareId

readonly hardwareId: string

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

Framework hardware identifier, or an empty string when unavailable.

---

id

readonly id: number

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

Immutable network entity identifier.

Inherited from

Entity.id

---

ip

readonly ip: string

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

Current remote network address, or an empty string when unavailable.

---

ping

readonly ping: number

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

Current round-trip latency in milliseconds, or -1 when unavailable.

---

position

position: Vector3

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

Authoritative world-space position; assignment forces replicated state.

Inherited from

Entity.position

---

rotation

rotation: Vector3 | Quaternion

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

Authoritative rotation; reads return a quaternion and assignments accept a quaternion or Euler angles in degrees.

Inherited from

BasePlayer.rotation

---

state

readonly state: StateBag

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

Arbitrary key/value state carried by this entity. The server writes it and every client that can see the entity receives it; see StateBag.

Inherited from

Entity.state

---

steamId

readonly steamId: string

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

Authenticated Steam identifier, or an empty string when unavailable.

---

virtualWorld

readonly virtualWorld: number

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

Current virtual-world identifier.

Inherited from

Entity.virtualWorld