Registry

The player registry handles the creation, tracking, and lifecycle of all active player objects in BDSC.

It provides functions to:

  • Create and register new players

  • Access and remove player objects

  • Save player state

  • Retrieve client-side replicated data

This system is core to how BDSC manages players internally. Use these functions to safely access and interact with player objects.


Server


Creates and registers a player object from a source ID.

Parameters

  • source: number

Returns

  • boolean

bdsc.create_player(source)

add_player

Adds a player object to the internal registry. Realistically this should never need to be called externally, this is handled internally on object creation.

Parameters

  • player: table

Returns

  • boolean

bdsc.add_player(player)

remove_player

Removes a player from the internal registry.

Parameters

  • source: number

Returns

  • boolean

bdsc.remove_player(source)

get_players

Retrieves all currently registered players.

Returns

  • table

local all_players = bdsc.get_players()

get_player

Retrieves a specific player object from the registry.

Parameters

  • source: number

Returns

  • table|nil

local player = bdsc.get_player(source)

save_players

Calls :save()

bdsc.save_players()

Client


get_player_data

Retrieves replicated client-side player data.

Returns

  • table

local data = bdsc.get_player_data()

Last updated