players global · type Players

Calls fn when a player arrives: on the globals when a client connects, on a room's table each time a player moves into it.

The same player value on_join had; it can no longer be sent to.

Returns every player in the room.

Returns the player with this name, or nil.

Who is within a radius of a point, and who is inside a box of blocks.

Returns every player inside a box of blocks, corners included.

Calls fn on a left or right click; hit holds the button and the entity, player, block and face it met.

Calls fn once per sneak press and release; down is true on the press.

Calls fn when a player picks a hotbar slot, 1..9.

Return false and the line is not said.

A stack taken off the ground, and one that landed on it. player is nil where the world dropped it, or where they have already left.

Calls fn when a stack lands on the ground; player is nil where the world dropped it or they have left.

Calls fn when a player dies, with the cause (fall, drown, void, lava, ...) and the line broadcast; player is nil once they have left.

Calls fn when a player respawns; player is nil once they have left.

Cancellable. Return false to stop it; return nothing to let it through. These are asked *before* the world changes and the engine waits milliseconds for the answer, so they must be quick and must never task.wait. Timeout, error, overflow and disabled handlers deny the action. Across packs any false wins. See docs/luau-api.md, "saying no".

Asks fn before a player puts a block down; return false to cancel it. A missed deadline denies the place.

Asks fn before damage lands on a player; return false to refuse it. A missed deadline denies it. A pack's own player:damage is not asked about.