Meer informatie
Engine-klasse
Players
Niet maakbaar
Service

*Deze inhoud is vertaald met behulp van AI (bèta) en kan fouten bevatten. Klik hier om deze pagina in het Engels te bekijken.


Samenvatting

Methoden
BanAsync(config: Dictionary):()
Chat(message: string):()
getPlayers():{Player}
Verouderd
GetProfileConfigurationFromUserIdAsync(userId: User):ProfileConfiguration
playerFromCharacter(character: Model):Player
Verouderd
players():{Player}
Verouderd
TeamChat(message: string):()
Overgenomen leden

API-referentie
Eigenschappen
BanningEnabled
Parallel lezen
Mogelijkheden: Players, PluginOrOpenCloud
Players.BanningEnabled:boolean

BubbleChat
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: Chat, Players
Players.BubbleChat:boolean

CharacterAutoLoads
Niet gerepliceerd
Parallel lezen
Mogelijkheden: Players
Players.CharacterAutoLoads:boolean
Codevoorbeelden
Speler Respawn Timer
local Players = game:GetService("Players")
-- Stel CharacterAutoLoads in op false
Players.CharacterAutoLoads = false
-- Verwijder het karakter van de speler uit de workspace bij overlijden
Players.PlayerAdded:Connect(function(player)
while true do
local char = player.CharacterAdded:Wait()
char.Humanoid.Died:Connect(function()
char:Destroy()
end)
end
end)
-- Respawn alle dode spelers elke 10 seconden
while true do
local players = Players:GetChildren()
-- Controleer of elke speler dood is door te controleren of ze geen karakter hebben, als ze dood zijn laad dat karakter van de speler
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacterAsync()
end
end
-- Wacht 10 seconden tot de volgende respawn controle
task.wait(10)
end

ClassicChat
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: Chat, Players
Players.ClassicChat:boolean

LocalPlayer
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: Players
Players.LocalPlayer:Player

localPlayer
Verouderd

MaxPlayers
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: Players
Players.MaxPlayers:number

NumPlayers
Verouderd

numPlayers
Verouderd

PreferredPlayers
Alleen-lezen
Niet gerepliceerd
Parallel lezen
Mogelijkheden: Players
Players.PreferredPlayers:number

RespawnTime
Parallel lezen
Mogelijkheden: Players
Players.RespawnTime:number

UseStrafingAnimations
Parallel lezen
Mogelijkheden: Players, PluginOrOpenCloud
Players.UseStrafingAnimations:boolean

Methoden
BanAsync
Opbrengst
Mogelijkheden: Players, Consequences
Players:BanAsync(config:Dictionary):()
Parameters
config:Dictionary
Teruggaves
()
Codevoorbeelden
Gebruikers Verbannen
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = 86400 -- 24 uur in seconden. Aanbeveling: gebruik je eigen logica op basis van de BanHistory van de gebruiker
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "Je hebt de richtlijn van de gemeenschap #5 geschonden",
PrivateReason = "Plaats hier alles wat de gebruiker niet zou moeten weten maar nuttig is voor je administratie",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
end

Chat
Plugin-beveiliging
Mogelijkheden: Players
Players:Chat(message:string):()
Parameters
message:string
Teruggaves
()
Codevoorbeelden
Players:Chat
-- Opdrachtbalk
game:GetService("Players"):Chat("Hallo, wereld!") --Resultaat is dat 'Hallo, wereld!' verschijnt in het chatlog onder de naam van jouw speler.
-- Script
local Players = game:GetService("Players")
Players:Chat("Hallo, wereld!") --Fouten

CreateHumanoidModelFromDescription
Verouderd

CreateHumanoidModelFromDescriptionAsync
Opbrengst
Mogelijkheden: AvatarAppearance, Players
Players:CreateHumanoidModelFromDescriptionAsync(
description:HumanoidDescription, rigType:Enum.HumanoidRigType, assetTypeVerification:Enum.AssetTypeVerification
Parameters
assetTypeVerification:Enum.AssetTypeVerification
Standaardwaarde: Default
Teruggaves
Codevoorbeelden
Maak Humanoid Model Van Beschrijving
game.Players:CreateHumanoidModelFromDescriptionAsync(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.Workspace

CreateHumanoidModelFromUserId
Verouderd

CreateHumanoidModelFromUserIdAsync
Opbrengst
Mogelijkheden: Players
Players:CreateHumanoidModelFromUserIdAsync(userId:User):Model
Parameters
userId:User
Teruggaves
Codevoorbeelden
Maak Humanoid Model Van Een Gebruikers-ID
game.Players:CreateHumanoidModelFromUserIdAsync(1).Parent = game.Workspace

GetBanHistoryAsync
Opbrengst
Mogelijkheden: Players, Consequences
Players:GetBanHistoryAsync(userId:User):BanHistoryPages
Parameters
userId:User
Teruggaves

GetCharacterAppearanceAsync
Verouderd

GetCharacterAppearanceInfoAsync
Opbrengst
Mogelijkheden: Players
Players:GetCharacterAppearanceInfoAsync(userId:User):Dictionary
Parameters
userId:User
Teruggaves
Codevoorbeelden
Voorbeeld Teruggegeven Karakter Uiterlijk Woordenboek
local result = {
playerAvatarType = "R15",
defaultPantsApplied = false,
defaultShirtApplied = false,
scales = {
bodyType = 0,
head = 1,
height = 1.05,
proportion = 0,
depth = 0.92,
width = 0.85,
},
bodyColors = {
leftArmColorId = 1030,
torsoColorId = 1001,
rightArmColorId = 1030,
headColorId = 1030,
leftLegColorId = 1001,
rightLegColorId = 1001,
},
assets = {
{
id = 1031492,
assetType = {
name = "Hoed",
id = 8,
},
name = "Gestreepte Hoed",
},
{
id = 13062491,
assetType = {
name = "Gezicht Accessoire",
id = 42,
},
name = "Vision Française ",
},
{
id = 16598440,
assetType = {
name = "Hals Accessoire",
id = 43,
},
name = "Rode Vlinderdas",
},
{
id = 28999228,
assetType = {
name = "Ge gezicht",
id = 18,
},
name = "Vrolijke Verrassing",
},
{
id = 86896488,
assetType = {
name = "Shirt",
id = 11,
},
name = "Dure Rode Tuxedo Jas",
},
{
id = 86896502,
assetType = {
name = "Broek",
id = 12,
},
name = "Dure Rode Tuxedo Broek",
},
{
id = 376530220,
assetType = {
name = "Linker Arm",
id = 29,
},
name = "ROBLOX Jongens Linker Arm",
},
{
id = 376531012,
assetType = {
name = "Rechter Arm",
id = 28,
},
name = "ROBLOX Jongens Rechter Arm",
},
{
id = 376531300,
assetType = {
name = "Linker Been",
id = 30,
},
name = "ROBLOX Jongens Linker Been",
},
{
id = 376531703,
assetType = {
name = "Rechter Been",
id = 31,
},
name = "ROBLOX Jongens Rechter Been",
},
{
id = 376532000,
assetType = {
name = "Torso",
id = 27,
},
name = "ROBLOX Jongens Torso",
},
},
}
print(result)

GetFriendsAsync
Opbrengst
Mogelijkheden: Players, Social
Players:GetFriendsAsync(userId:User):FriendPages
Parameters
userId:User
Teruggaves
Codevoorbeelden
Print Roblox Vrienden
local Players = game:GetService("Players")
local USERNAME = "Cozecant"
-- Eerst, haal de gebruikers-ID van de speler op
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- Vervolgens, haal een FriendPages-object op voor hun vrienden
local friendPages = Players:GetFriendsAsync(userId)
-- Loop door de pagina's en verzamel de gebruikersnaam van elke vriend. Elke pagina-invoer is
-- een tabel met informatie over de vriend, inclusief Gebruikersnaam.
local usernames = {}
while true do
for _, friend in ipairs(friendPages:GetCurrentPage()) do
table.insert(usernames, friend.Username)
end
if friendPages.IsFinished then
break
end
friendPages:AdvanceToNextPageAsync()
end
print("Vrienden van " .. USERNAME .. ": " .. table.concat(usernames, ", "))

GetHumanoidDescriptionFromOutfitId
Verouderd

GetHumanoidDescriptionFromOutfitIdAsync
Opbrengst
Mogelijkheden: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromOutfitIdAsync(outfitId:number):HumanoidDescription
Parameters
outfitId:number
Codevoorbeelden
Krijg HumanoidDescription Van Outfit ID
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local function getOutfitId(bundleId)
if bundleId <= 0 then
return
end
local info = game.AssetService:GetBundleDetailsAsync(bundleId)
if not info then
return
end
for _, item in pairs(info.Items) do
if item.Type == "UserOutfit" then
return item.Id
end
end
return nil
end
local function getHumanoidDescriptionBundle(bundleId)
local itemId = getOutfitId(bundleId)
if itemId and itemId > 0 then
return Players:GetHumanoidDescriptionFromOutfitIdAsync(itemId)
end
return nil
end
local humanoidDescription = getHumanoidDescriptionBundle(799)
local humanoidModel = Players:CreateHumanoidModelFromDescriptionAsync(humanoidDescription, Enum.HumanoidRigType.R15)
humanoidModel.Parent = Workspace

GetHumanoidDescriptionFromUserId
Verouderd

GetHumanoidDescriptionFromUserIdAsync
Opbrengst
Mogelijkheden: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromUserIdAsync(userId:User):HumanoidDescription
Parameters
userId:User
Codevoorbeelden
Krijg HumanoidDescription Van Gebruikers-ID
game.Players:CreateHumanoidModelFromDescriptionAsync(
game.Players:GetHumanoidDescriptionFromUserIdAsync(1),
Enum.HumanoidRigType.R15
).Parent =
game.Workspace

GetNameFromUserIdAsync
Opbrengst
Mogelijkheden: Players
Players:GetNameFromUserIdAsync(userId:User):string
Parameters
userId:User
Teruggaves
Codevoorbeelden
Haal Naam op van UserId
local Players = game:GetService("Players")
-- Voorbeeldgegevens:
-- UserId: 118271 Naam: "RobloxRulez"
-- UserId: 131963979 Naam: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- print: "RobloxRulez docsRule"
Haal naam op van UserId met behulp van een cache
local Players = game:GetService("Players")
-- Maak een tabel genaamd 'cache' om elke 'Name' op te slaan zodra deze wordt gevonden.
-- Als we een 'Name' opzoeken met dezelfde 'UserId', komt de 'Name'
-- uit de cache (snel) in plaats van GetNameFromUserIdAsync() (yield).
local cache = {}
function getNameFromUserId(userId)
-- Controleer eerst of de cache 'userId' bevat
local nameFromCache = cache[userId]
if nameFromCache then
-- als er een waarde was opgeslagen in de cache met sleutel 'userId', dan is deze 'nameFromCache'
-- de juiste naam en kunnen we deze retourneren.
return nameFromCache
end
-- Als hier, was 'userId' niet eerder opgezocht en bestaat niet in de
-- cache. Nu moeten we GetNameFromUserIdAsync() gebruiken om de naam op te zoeken
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- als 'success' waar is, heeft GetNameFromUserIdAsync() succesvol de
-- naam gevonden. Sla deze naam op in de cache met 'userId' als sleutel zodat we
-- deze naam in de toekomst nooit meer hoeven op te zoeken. Retourneer dan de naam.
cache[userId] = name
return name
end
-- Als hier, was 'success' onwaar, wat betekent dat GetNameFromUserIdAsync()
-- niet in staat was om de 'naam' voor de opgegeven 'userId' te vinden. Waarschuw de gebruiker
-- dat dit is gebeurd en retourneer dan niets, of nil.
warn("Kon naam niet vinden voor UserId:", userId)
return nil
end
-- Voorbeeldgegevens:
-- UserId: 118271 Naam: "RobloxRulez"
-- UserId: 131963979 Naam: "docsRule"
-- De eerste keer dat een UserId wordt gebruikt, zal GetNameFromUserIdAsync() worden aangeroepen
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- Omdat 118271 eerder is gebruikt, haal de naam uit de cache
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- print: "RobloxRulez docsRule RobloxRulez"

GetPlayerByUserId
Parallel schrijven
Mogelijkheden: Players
Players:GetPlayerByUserId(userId:User):Player
Parameters
userId:User
Teruggaves
Codevoorbeelden
Players:GetPlayerByUserId
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("Speler met userId 1 is op deze server! Hun naam is: " .. player.Name)
else
print("Speler met userId 1 is niet op deze server!")
end

GetPlayerFromCharacter
Mogelijkheden: Players
Toegang tot simulatie
Players:GetPlayerFromCharacter(character:Model):Player
Parameters
character:Model
Teruggaves
Codevoorbeelden
Players:GetPlayerFromCharacter
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local PLAYER_NAME = "Nightriff"
local character = Workspace:FindFirstChild(PLAYER_NAME)
local player = Players:GetPlayerFromCharacter(character)
if player then
print(`Speler {player.Name} ({player.UserId}) is in het spel`)
else
print(`Speler {PLAYER_NAME} is niet in het spel!`)
end

GetPlayers
Parallel schrijven
Mogelijkheden: Players
Players:GetPlayers():{Player}
Teruggaves
Codevoorbeelden
Geef Sparkles aan Iedereen
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- Geef ze sparkles op hun hoofd als ze die nog niet hebben
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- Controleer of ze al zijn verschenen
if player.Character then
onCharacterAdded(player.Character)
end
-- Luister naar de speler die (her)verschijnt
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)

getPlayers
Verouderd

GetProfileConfigurationFromUserIdAsync
Opbrengst
Mogelijkheden: AvatarAppearance, Players
Players:GetProfileConfigurationFromUserIdAsync(userId:User):ProfileConfiguration
Parameters
userId:User
Teruggaves
ProfileConfiguration

GetUserIdFromNameAsync
Opbrengst
Mogelijkheden: Players
Players:GetUserIdFromNameAsync(userName:string):number
Parameters
userName:string
Teruggaves
Codevoorbeelden
Krijg UserId van Naam
local Players = game:GetService("Players")
-- Voorbeeldgegevens:
-- UserId: 118271 Naam: "RobloxRulez"
-- UserId: 131963979 Naam: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- print: "118271 131963979"
Krijg UserId van Naam met behulp van een cache
local Players = game:GetService("Players")
-- Maak een tabel genaamd 'cache' om elke 'UserId' op te slaan zodra ze gevonden worden.
-- Als we een 'UserId' opzoeken met dezelfde 'Name', komt de 'UserId'
-- uit de cache (snel) in plaats van GetUserIdFromNameAsync() (yield).
local cache = {}
function getUserIdFromName(name)
-- Controleer eerst of de cache 'name' bevat
local userIdFromCache = cache[name]
if userIdFromCache then
-- als er een waarde in de cache was opgeslagen onder de sleutel 'name', dan is deze 'userIdFromCache'
-- de juiste UserId en kunnen we deze retourneren.
return userIdFromCache
end
-- Als hier, was 'name' niet eerder opgezocht en bestaat niet in de
-- cache. Nu moeten we GetUserIdFromNameAsync() gebruiken om de userId op te zoeken
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- als 'success' waar is, heeft GetUserIdFromNameAsync() succesvol de
-- userId gevonden. Sla deze userId op in de cache met 'name' als sleutel zodat we
-- deze userId in de toekomst nooit meer hoeven op te zoeken. Retourneer dan userId.
cache[name] = userId
return userId
end
-- Als hier, was 'success' onwaar, wat betekent dat GetUserIdFromNameAsync()
-- niet in staat was om de 'userId' voor de gegeven 'name' te vinden. We kunnen de
-- gebruiker waarschuwen dat dit is gebeurd en dan niets retourneren, of nil.
warn("Niet in staat om UserId voor Naam te vinden:", name)
return nil
end
-- Voorbeeldgegevens:
-- UserId: 118271 Naam: "RobloxRulez"
-- UserId: 131963979 Naam: "docsRule"
-- De eerste keer dat een Naam wordt gebruikt, zal GetUserIdFromNameAsync() worden aangeroepen
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- Omdat "RobloxRulez" eerder is gebruikt, krijg zijn UserId uit de cache
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- print: "118271 131963979 118271"

GetUserThumbnailAsync
Opbrengst
Mogelijkheden: Players
Players:GetUserThumbnailAsync(
userId:User, thumbnailType:Enum.ThumbnailType, thumbnailSize:Enum.ThumbnailSize
Parameters
userId:User
thumbnailType:Enum.ThumbnailType
thumbnailSize:Enum.ThumbnailSize
Teruggaves
Codevoorbeelden
Speler Thumbnail Weergeven
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- vervang met placeholder afbeelding
-- haal de thumbnail op
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- stel de inhoud van de ImageLabel in op de gebruikersthumbnail
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)

playerFromCharacter
Verouderd

players
Verouderd

SetChatStyle
Plugin-beveiliging
Mogelijkheden: Players
Players:SetChatStyle(style:Enum.ChatStyle):()
Parameters
Standaardwaarde: Classic
Teruggaves
()
Codevoorbeelden
De chatstijl van een speler instellen
-- Command bar
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- Stelt de chatstijl in op Classic
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- Fouten

TeamChat
Plugin-beveiliging
Mogelijkheden: Players
Players:TeamChat(message:string):()
Parameters
message:string
Teruggaves
()
Codevoorbeelden
Teamchat Verzenden
-- Command bar
game.Players:TeamChat("Hallo Wereld") -- Stuurt een "Hallo Wereld" bericht naar alle spelers in het team van de lokale speler
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("Hallo Wereld") -- Fouten

UnbanAsync
Opbrengst
Mogelijkheden: Players, Consequences
Players:UnbanAsync(config:Dictionary):()
Parameters
config:Dictionary
Teruggaves
()
Codevoorbeelden
Gebruikers Ontbannen
local Players = game:GetService("Players")
if shouldBeUnbanned(player) then
local config: UnbanConfigType = {
UserIds = { player.UserId, 789 },
ApplyToUniverse = false,
}
local success, err = pcall(function()
return Players:UnbanAsync(config)
end)
print(success, err)
end

Evenementen
PlayerAdded
Mogelijkheden: Players
Players.PlayerAdded(player:Player):RBXScriptSignal
Parameters
player:Player
Codevoorbeelden
Players.PlayerAdded
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("Een speler is binnengekomen: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)

PlayerMembershipChanged
Mogelijkheden: Players
Players.PlayerMembershipChanged(player:Player):RBXScriptSignal
Parameters
player:Player
Codevoorbeelden
Omgaan met wijzigingen in Premium-lidmaatschappen
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- Geef de speler toegang tot alleen Premium-gebieden, items of wat je maar kunt bedenken!
print("Geef", player, "premium voordelen!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("Ontvangen evenement PlayerMembershipChanged. Nieuw lidmaatschap = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)

PlayerRemoving
Mogelijkheden: Players
Players.PlayerRemoving(
Parameters
player:Player
Codevoorbeelden
Players.PlayerRemoving
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("Een speler heeft de game verlaten: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)

UserSubscriptionStatusChanged
Mogelijkheden: Players, Monetization
Players.UserSubscriptionStatusChanged(
user:Player, subscriptionId:string
Parameters
user:Player
subscriptionId:string

©2026 Roblox Corporation. Roblox, het Roblox-logo en Powering Imagination behoren tot onze geregistreerde en niet-geregistreerde handelsmerken in de VS en andere landen.