Skip to main content

traceless.players

Players are represented by validated controller and pawn userdata. A returned handle is revalidated every time a live method uses it.

local_controller​

traceless.players.local_controller()

Returns: Controller; or nil, reason.

Returns the local controller, or local controller is unavailable.

local_pawn​

traceless.players.local_pawn()

Returns: Pawn; or nil, reason.

Returns the local pawn, or local pawn is unavailable.

from_userid​

traceless.players.from_userid(userid)

Returns: Controller; or nil, reason.

Accepts an integer user ID observed in delivered game events. Resolves the current controller from the runtime's mapping; unobserved or stale IDs fail with a reason.

all​

traceless.players.all([enemies_only = false])

Returns: array of Controller userdata.

Snapshots matching controllers. A truthy filter restricts results to enemies of the local pawn. Returns an empty table when the entity system is unavailable.

local traceless = require("traceless")
local controller = traceless.players.local_controller()
local pawn = controller and controller:pawn()
if pawn then traceless.console.info(pawn:health()) end