Downtown Chronicles
LibraryModulesPlayer

Exports

Expors for player related data.

ExportInternal / helper name
GetPlayerGetPlayer
GetIdGetId
GetSourceGetSource
GetUserIdGetUserId
GetPersistIdGetPersistId
GetIdMapGetIdMap
GetAllIdsGetAllIds
GetAllPlayersGetAll
GetPlayersByUserIdGetPlayersByUserId
GetPlayersByPersistIdGetPlayersByPersistId
GetPlayerNameGetName
GetPlayerIdentifiersGetIdentifiers
GetPlayerIdentifierGetIdentifier

Behavior matches lib.player where the names line up; object shape for GetPlayer is the same as GetPlayer.

GetPlayer

local p = exports['dc_lib']:GetPlayer(source)

Parameters: sourcenumber | string
Returns: player object or nil if not connected (see GetPlayer).

local p = exports['dc_lib']:GetPlayer(source)
if not p then return end
print(p.getUserId())

GetId

local dataId = exports['dc_lib']:GetId(source)

Parameters: sourcenumber | string
Returns: data id (integer?).

GetSource

local source = exports['dc_lib']:GetSource(dataId)

Parameters: dataIdinteger
Returns: player id string or nil.

GetUserId

local userId = exports['dc_lib']:GetUserId(source)

Parameters: sourcenumber | string
Returns: integer?.

GetPersistId

local persistId = exports['dc_lib']:GetPersistId(source)

Parameters: sourcenumber | string
Returns: integer?.

GetIdMap

local map = exports['dc_lib']:GetIdMap()

Returns: table<string, integer> — sources that have a data id.

GetAllIds

local ids = exports['dc_lib']:GetAllIds()

Returns: integer[] — data ids currently online.

GetAllPlayers

local sources = exports['dc_lib']:GetAllPlayers()

Returns: string[] — same as internal GetAll (typically all player id strings).

for _, src in ipairs(exports['dc_lib']:GetAllPlayers() or {}) do
    print(src)
end

GetPlayersByUserId

local sources = exports['dc_lib']:GetPlayersByUserId(userId)

Parameters: userIdinteger
Returns: string[] — player ids.

GetPlayersByPersistId

local sources = exports['dc_lib']:GetPlayersByPersistId(persistId)

Parameters: persistIdinteger
Returns: string[] — player ids.

GetPlayerName

local name = exports['dc_lib']:GetPlayerName(source)

Parameters: sourcenumber | string
Returns: display name (string?) — same as internal GetName.

GetPlayerIdentifiers

local ids = exports['dc_lib']:GetPlayerIdentifiers(source)

Parameters: sourcenumber | string
Returns: identifier list — same as internal GetIdentifiers.

GetPlayerIdentifier

local license = exports['dc_lib']:GetPlayerIdentifier(source, 'license')

Parameters: sourcenumber | string; typestring (e.g. 'license', 'discord')
Returns: full identifier string or nil — same as internal GetIdentifier.

See also: GetPlayer · helpers

On this page