Skip to Content

Players

Service that tracks connected players and fires join, leave, chat and rank events.

local Players = game:GetService("Players")

Each connected client is represented by a Player with an associated Character.

Methods

GetPlayers

Players:GetPlayers(): { Player }

Returns all connected players.

for _, player in ipairs(Players:GetPlayers()) do
	player:SendMessage("Hello!")
end

FindFirstChild

Players:FindFirstChild(username: string): Player?

Returns the player with the given username, or nil.

Events

PlayerAdded

Players.PlayerAdded(player: Player)

Fires when a player joins.

Players.PlayerAdded:Connect(function(player)
	print(player.Name .. " joined")
end)

PlayerRemoving

Players.PlayerRemoving(player: Player)

Fires before a player is removed from the server.

PlayerChatted

Players.PlayerChatted(player: Player, text: string)

Fires when any player sends a chat message.

RankChanged

Players.RankChanged(player: Player)

Fires when a player's rank in this game changes.

On this page