Players

Everyone connected, and the signals for joining and leaving.

Players holds one Player per connected client. It is where a script finds players and where it hears about new ones.

Members

Member	Type	What it does
LocalPlayer	Player or nil	The player for this client. Read-only, and always nil on the server.
MaxPlayers	number	The player limit. Stored and replicated; connections are not refused because of it.

Events

Event	Callback arguments	When it fires
PlayerAdded	player	Someone joined. Fires on the server only.
PlayerRemoving	player	Someone is about to leave. Fires on the server only.

Methods

Method	Returns	What it does
GetPlayers()	array of Player	Every player currently connected.

Connecting to joins

A script that connects to PlayerAdded may have missed players who joined before it ran. Loop GetPlayers after connecting to catch them:

local Players = game:GetService("Players")

local function greet(player)
    print("hello", player.Name)
end

Players.PlayerAdded:Connect(greet)

for _, player in ipairs(Players:GetPlayers()) do
    greet(player)
end

LocalPlayer is set on a client. Reading it on the server gives nil, so guard it before use.

PlayerAdded and PlayerRemoving fire on the server only. A client sees players arrive as they replicate, but gets neither signal, so a client script that needs to react to a join has to watch for the Player instance another way.

Example

local Players = game:GetService("Players")

Players.PlayerRemoving:Connect(function (player)
    print(player.Name, "left")
end)

print(#Players:GetPlayers(), "players connected")