Lernen
Engine-Klasse
Players
Nicht erstellbar
Dienst

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.


Zusammenfassung
Methoden
BanAsync(config: Dictionary):()
Chat(message: string):()
getPlayers():{Player}
Veraltet
playerFromCharacter(character: Model):Player
Veraltet
players():{Player}
Veraltet
TeamChat(message: string):()
Geerbte Mitglieder

API-Referenz
Eigenschaften
BanningEnabled
Nicht skriptfähig
Parallel lesen
Funktionen: Players
Players.BanningEnabled:boolean

BubbleChat
Schreibgeschützt
Nicht repliziert
Parallel lesen
Funktionen: Chat, Players
Players.BubbleChat:boolean

CharacterAutoLoads
Nicht repliziert
Parallel lesen
Funktionen: Players
Players.CharacterAutoLoads:boolean
Code-Beispiele
Spieler Wiederbelebungs Timer
local Players = game:GetService("Players")
-- Setze CharacterAutoLoads auf false
Players.CharacterAutoLoads = false
-- Entferne den Charakter des Spielers aus dem Arbeitsbereich beim Sterben
Players.PlayerAdded:Connect(function(player)
while true do
local char = player.CharacterAdded:Wait()
char.Humanoid.Died:Connect(function()
char:Destroy()
end)
end
end)
-- Belebe alle toten Spieler alle 10 Sekunden wieder
while true do
local players = Players:GetChildren()
-- Überprüfe, ob jeder Spieler tot ist, indem du überprüfst, ob er keinen Charakter hat; falls tot, lade den Charakter des Spielers
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacterAsync()
end
end
-- Warte 10 Sekunden bis zur nächsten Überprüfung der Wiederbelebung
task.wait(10)
end

ClassicChat
Schreibgeschützt
Nicht repliziert
Parallel lesen
Funktionen: Chat, Players
Players.ClassicChat:boolean

LocalPlayer
Schreibgeschützt
Nicht repliziert
Parallel lesen
Funktionen: Players
Players.LocalPlayer:Player

localPlayer
Veraltet

MaxPlayers
Schreibgeschützt
Nicht repliziert
Parallel lesen
Funktionen: Players
Players.MaxPlayers:number

NumPlayers
Veraltet

numPlayers
Veraltet

PreferredPlayers
Schreibgeschützt
Nicht repliziert
Parallel lesen
Funktionen: Players
Players.PreferredPlayers:number

RespawnTime
Parallel lesen
Funktionen: Players
Players.RespawnTime:number

UseStrafingAnimations
Nicht skriptfähig
Parallel lesen
Funktionen: Players
Players.UseStrafingAnimations:boolean

Methoden
BanAsync
Angehalten
Funktionen: Players, Consequences
Players:BanAsync(config:Dictionary):()
Parameter
config:Dictionary
Rückgaben
()
Code-Beispiele
Benutzer sperren
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = 86400 -- 24 Stunden in Sekunden. Empfehlung: Verwenden Sie Ihre eigene Logik basierend auf dem BanHistory des Benutzers
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "Sie haben die Gemeinschaftsrichtlinie #5 verletzt",
PrivateReason = "Geben Sie hier alles ein, was der Benutzer nicht wissen sollte, das aber für Ihre Aufzeichnungen hilfreich ist",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
end

Chat
Plugin-Sicherheit
Funktionen: Players
Players:Chat(message:string):()
Parameter
message:string
Rückgaben
()
Code-Beispiele
Spieler:Chat
-- Befehlszeile
game:GetService("Players"):Chat("Hallo, Welt!") --Ergebnis ist, dass 'Hallo, Welt!' im Chatprotokoll unter dem Namen deines Spielers erscheint.
-- Skript
local Players = game:GetService("Players")
Players:Chat("Hallo, Welt!") --Fehler

CreateHumanoidModelFromDescription
Veraltet

CreateHumanoidModelFromDescriptionAsync
Angehalten
Funktionen: AvatarAppearance, Players
Players:CreateHumanoidModelFromDescriptionAsync(
description:HumanoidDescription, rigType:Enum.HumanoidRigType, assetTypeVerification:Enum.AssetTypeVerification
Parameter
assetTypeVerification:Enum.AssetTypeVerification
Standardwert: "Default"
Rückgaben
Code-Beispiele
Humanoides Modell aus Beschreibung erstellen
game.Players:CreateHumanoidModelFromDescriptionAsync(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.Workspace

CreateHumanoidModelFromUserId
Veraltet

CreateHumanoidModelFromUserIdAsync
Angehalten
Funktionen: Players
Players:CreateHumanoidModelFromUserIdAsync(userId:User):Model
Parameter
userId:User
Rückgaben
Code-Beispiele
Humanoidenmodell aus einer Benutzer-ID erstellen
game.Players:CreateHumanoidModelFromUserIdAsync(1).Parent = game.Workspace

GetBanHistoryAsync
Angehalten
Funktionen: Players, Consequences
Players:GetBanHistoryAsync(userId:User):BanHistoryPages
Parameter
userId:User
Rückgaben

GetCharacterAppearanceAsync
Veraltet

GetCharacterAppearanceInfoAsync
Angehalten
Funktionen: Players
Players:GetCharacterAppearanceInfoAsync(userId:User):Dictionary
Parameter
userId:User
Rückgaben
Code-Beispiele
Beispiel Rückgabe Charakter Erscheinungsbild Wörterbuch
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 = "Hut",
id = 8,
},
name = "Gestreifter Hut",
},
{
id = 13062491,
assetType = {
name = "Gesichtsaccessoire",
id = 42,
},
name = "Vision Française ",
},
{
id = 16598440,
assetType = {
name = "Halsaccessoire",
id = 43,
},
name = "Rote Fliege",
},
{
id = 28999228,
assetType = {
name = "Gesicht",
id = 18,
},
name = "Freudige Überraschung",
},
{
id = 86896488,
assetType = {
name = "Hemd",
id = 11,
},
name = "Teure Rote Smokingjacke",
},
{
id = 86896502,
assetType = {
name = "Hose",
id = 12,
},
name = "Teure Rote Smokinhose",
},
{
id = 376530220,
assetType = {
name = "Linker Arm",
id = 29,
},
name = "ROBLOX Junge Linker Arm",
},
{
id = 376531012,
assetType = {
name = "Rechter Arm",
id = 28,
},
name = "ROBLOX Junge Rechter Arm",
},
{
id = 376531300,
assetType = {
name = "Linkes Bein",
id = 30,
},
name = "ROBLOX Junge Linkes Bein",
},
{
id = 376531703,
assetType = {
name = "Rechtes Bein",
id = 31,
},
name = "ROBLOX Junge Rechtes Bein",
},
{
id = 376532000,
assetType = {
name = "Torso",
id = 27,
},
name = "ROBLOX Junge Torso",
},
},
}
print(result)

GetFriendsAsync
Angehalten
Funktionen: Players, Social
Players:GetFriendsAsync(userId:User):FriendPages
Parameter
userId:User
Rückgaben
Code-Beispiele
Roblox-Freunde drucken
local Players = game:GetService("Players")
local USERNAME = "Cozecant"
local function iterPageItems(pages)
return coroutine.wrap(function()
local pagenum = 1
while true do
for _, item in ipairs(pages:GetCurrentPage()) do
coroutine.yield(item, pagenum)
end
if pages.IsFinished then
break
end
pages:AdvanceToNextPageAsync()
pagenum = pagenum + 1
end
end)
end
-- Zuerst, hole die Benutzer-ID des Spielers
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- Dann, hole ein FriendPages-Objekt für deren Freunde
local friendPages = Players:GetFriendsAsync(userId)
-- Über die Elemente in den Seiten iterieren. Für FriendPages sind dies
-- Tabellen mit Informationen über den Freund, einschließlich Benutzername.
-- Sammle jeden Benutzernamen in einer Tabelle
local usernames = {}
for item, _pageNo in iterPageItems(friendPages) do
table.insert(usernames, item.Username)
end
print("Verbindungen von " .. USERNAME .. ": " .. table.concat(usernames, ", "))

GetHumanoidDescriptionFromOutfitId
Veraltet

GetHumanoidDescriptionFromOutfitIdAsync
Angehalten
Funktionen: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromOutfitIdAsync(outfitId:number):HumanoidDescription
Parameter
outfitId:number
Code-Beispiele
HumanoidDescription Aus Outfit-ID Abrufen
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
Veraltet

GetHumanoidDescriptionFromUserIdAsync
Angehalten
Funktionen: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromUserIdAsync(userId:User):HumanoidDescription
Parameter
userId:User
Code-Beispiele
Holo die HumanoidDescription von Benutzer-ID
game.Players:CreateHumanoidModelFromDescriptionAsync(
game.Players:GetHumanoidDescriptionFromUserIdAsync(1),
Enum.HumanoidRigType.R15
).Parent =
game.Workspace

GetNameFromUserIdAsync
Angehalten
Funktionen: Players
Players:GetNameFromUserIdAsync(userId:User):string
Parameter
userId:User
Rückgaben
Code-Beispiele
Name vom Benutzer abrufen
local Players = game:GetService("Players")
-- Beispieldaten:
-- BenutzerId: 118271 Name: "RobloxRulez"
-- BenutzerId: 131963979 Name: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- gibt aus: "RobloxRulez docsRule"
Name von UserId unter Verwendung eines Caches abrufen
local Players = game:GetService("Players")
-- Erstellen Sie eine Tabelle namens 'cache', um jeden 'Name' zu speichern, sobald sie gefunden werden.
-- Wenn wir einen 'Name' mit der gleichen 'UserId' nachschlagen, wird der 'Name'
-- aus dem Cache (schnell) anstelle von GetNameFromUserIdAsync() (yieldet) abgerufen.
local cache = {}
function getNameFromUserId(userId)
-- Zuerst überprüfen, ob der Cache 'userId' enthält
local nameFromCache = cache[userId]
if nameFromCache then
-- Wenn ein Wert im Cache unter dem Schlüssel 'userId' gespeichert wurde, dann ist dieser 'nameFromCache'
-- der richtige Name und wir können ihn zurückgeben.
return nameFromCache
end
-- Wenn wir hier sind, wurde 'userId' zuvor nicht nachgeschlagen und existiert nicht im
-- Cache. Jetzt müssen wir GetNameFromUserIdAsync() verwenden, um den Namen nachzuschlagen
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- Wenn 'success' wahr ist, hat GetNameFromUserIdAsync() erfolgreich den
-- Namen gefunden. Speichern Sie diesen Namen im Cache unter Verwendung von 'userId' als Schlüssel, damit wir
-- diesen Namen in Zukunft niemals nachschlagen müssen. Dann den Namen zurückgeben.
cache[userId] = name
return name
end
-- Wenn wir hier sind, war 'success' falsch, was bedeutet, dass GetNameFromUserIdAsync()
-- nicht in der Lage war, den 'name' für die angegebene 'userId' zu finden. Warnen Sie den Benutzer,
-- dass dies passiert ist und geben Sie dann nichts oder nil zurück.
warn("Konnte Name für UserId nicht finden:", userId)
return nil
end
-- Beispiel-Daten:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
-- Beim ersten Mal, wenn eine UserId verwendet wird, wird GetNameFromUserIdAsync() aufgerufen
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- Da 118271 zuvor verwendet wurde, holen Sie sich seinen Namen aus dem Cache
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- gibt aus: "RobloxRulez docsRule RobloxRulez"

GetPlayerByUserId
Parallel schreiben
Funktionen: Players
Players:GetPlayerByUserId(userId:User):Player
Parameter
userId:User
Rückgaben
Code-Beispiele
Spieler:GetPlayerByUserId
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("Spieler mit userId 1 ist auf diesem Server! Ihr Name ist: " .. player.Name)
else
print("Spieler mit userId 1 ist nicht auf diesem Server!")
end

GetPlayerFromCharacter
Funktionen: Players
Simulationszugang
Players:GetPlayerFromCharacter(character:Model):Player
Parameter
character:Model
Rückgaben
Code-Beispiele
Spieler: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(`Spieler {player.Name} ({player.UserId}) ist im Spiel`)
else
print(`Spieler {PLAYER_NAME} ist nicht im Spiel!`)
end

GetPlayers
Parallel schreiben
Funktionen: Players
Players:GetPlayers():{Player}
Rückgaben
Code-Beispiele
Gib jedem Funkeln
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- Gib ihnen Funkeln auf ihrem Kopf, wenn sie diese noch nicht haben
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- Überprüfen, ob sie bereits erschienen sind
if player.Character then
onCharacterAdded(player.Character)
end
-- Auf das (Re)Erscheinen des Spielers hören
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)

getPlayers
Veraltet

GetUserIdFromNameAsync
Angehalten
Funktionen: Players
Players:GetUserIdFromNameAsync(userName:string):number
Parameter
userName:string
Rückgaben
Code-Beispiele
Benutzer-ID aus Namen abrufen
local Players = game:GetService("Players")
-- Beispieldaten:
-- Benutzer-ID: 118271 Name: "RobloxRulez"
-- Benutzer-ID: 131963979 Name: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- gibt aus: "118271 131963979"
Benutzer-ID von Name mit einem Cache abrufen
local Players = game:GetService("Players")
-- Erstellen Sie eine Tabelle namens 'cache', um jede 'UserId' zu speichern, während sie gefunden wird.
-- Wenn wir eine 'UserId' mit dem gleichen 'Name' nachschlagen, wird die 'UserId'
-- aus dem Cache (schnell) anstelle von GetUserIdFromNameAsync() (yieldet) kommen.
local cache = {}
function getUserIdFromName(name)
-- Zuerst überprüfen, ob der Cache 'name' enthält
local userIdFromCache = cache[name]
if userIdFromCache then
-- Wenn ein Wert im Cache am Schlüssel 'name' gespeichert wurde, dann ist diese 'userIdFromCache'
-- die korrekte Benutzer-ID und wir können sie zurückgeben.
return userIdFromCache
end
-- Wenn wir hier sind, wurde 'name' zuvor nicht nachgeschlagen und existiert nicht im
-- Cache. Jetzt müssen wir GetUserIdFromNameAsync() verwenden, um die Benutzer-ID nachzuschlagen
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- Wenn 'success' wahr ist, hat GetUserIdFromNameAsync() die
-- Benutzer-ID erfolgreich gefunden. Speichern Sie diese Benutzer-ID im Cache und verwenden Sie 'name' als Schlüssel,
-- sodass wir diese Benutzer-ID in Zukunft nie wieder nachschlagen müssen. Dann geben wir die Benutzer-ID zurück.
cache[name] = userId
return userId
end
-- Wenn wir hier sind, war 'success' falsch, was bedeutet, dass GetUserIdFromNameAsync()
-- die 'userId' für den angegebenen 'name' nicht finden konnte. Wir können die
-- Benutzer warnen, dass dies passiert ist, und dann nichts oder nil zurückgeben.
warn("Benutzer-ID für Name nicht gefunden:", name)
return nil
end
-- Beispieldaten:
-- Benutzer-ID: 118271 Name: "RobloxRulez"
-- Benutzer-ID: 131963979 Name: "docsRule"
-- Beim ersten Mal, dass ein Name verwendet wird, wird GetUserIdFromNameAsync() aufgerufen
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- Da "RobloxRulez" zuvor verwendet wurde, holen Sie sich seine Benutzer-ID aus dem Cache
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- gibt aus: "118271 131963979 118271"

GetUserThumbnailAsync
Angehalten
Funktionen: Players
Players:GetUserThumbnailAsync(
userId:User, thumbnailType:Enum.ThumbnailType, thumbnailSize:Enum.ThumbnailSize
Parameter
userId:User
thumbnailType:Enum.ThumbnailType
thumbnailSize:Enum.ThumbnailSize
Rückgaben
Code-Beispiele
Spieler-Thumbnail anzeigen
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- durch Platzhalterbild ersetzen
-- Thumbnail abrufen
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- den Inhalt des ImageLabels auf das Benutzer-Thumbnail setzen
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)

playerFromCharacter
Veraltet

players
Veraltet

SetChatStyle
Plugin-Sicherheit
Funktionen: Players
Players:SetChatStyle(style:Enum.ChatStyle):()
Parameter
Standardwert: "Classic"
Rückgaben
()
Code-Beispiele
Einstellen des Chat-Stils eines Spielers
-- Befehlszeile
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- Setzt den Chat-Stil auf Klassisch
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- Fehler

TeamChat
Plugin-Sicherheit
Funktionen: Players
Players:TeamChat(message:string):()
Parameter
message:string
Rückgaben
()
Code-Beispiele
Team-Chat senden
-- Befehlszeile
game.Players:TeamChat("Hallo Welt") -- Sendet eine "Hallo Welt" Nachricht an alle Spieler im Team des lokalen Spielers
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("Hallo Welt") -- Fehler

UnbanAsync
Angehalten
Funktionen: Players, Consequences
Players:UnbanAsync(config:Dictionary):()
Parameter
config:Dictionary
Rückgaben
()
Code-Beispiele
Benutzern das Verbot aufheben
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

Events
PlayerAdded
Funktionen: Players
Players.PlayerAdded(player:Player):RBXScriptSignal
Parameter
player:Player
Code-Beispiele
Spieler.PlayerAdded
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("Ein Spieler ist beigetreten: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)

PlayerMembershipChanged
Funktionen: Players
Players.PlayerMembershipChanged(player:Player):RBXScriptSignal
Parameter
player:Player
Code-Beispiele
Änderungen der Premium-Mitgliedschaft verwalten
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- Gewähren Sie dem Spieler Zugang zu nur für Premium zugänglichen Bereichen, Gegenständen oder was auch immer Sie sich vorstellen können!
print("Gebe", player, "Premium-Vorteile!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("Ereignis PlayerMembershipChanged empfangen. Neue Mitgliedschaft = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)

PlayerRemoving
Funktionen: Players
Players.PlayerRemoving(
Parameter
player:Player
Code-Beispiele
Players.PlayerRemoving
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("Ein Spieler hat verlassen: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)

UserSubscriptionStatusChanged
Funktionen: Players, Monetization
Players.UserSubscriptionStatusChanged(
user:Player, subscriptionId:string
Parameter
user:Player
subscriptionId:string

©2026 Roblox Corporation. Roblox, das Roblox-Logo und "Powering Imagination" gehören zu unseren eingetragenen und nicht eingetragenen Markenzeichen in den USA und anderen Ländern.