Impara
Classe motore
Players
Non costruibile
Assistenza

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.


Sommario
Metodi
BanAsync(config: Dictionary):()
Chat(message: string):()
getPlayers():{Player}
Obsoleto
playerFromCharacter(character: Model):Player
Obsoleto
players():{Player}
Obsoleto
TeamChat(message: string):()
Membri ereditati

Riferimento API
Proprietà
BanningEnabled
Non programmabile
Lettura Parallela
Capacità: Players
Players.BanningEnabled:boolean

BubbleChat
Sola Lettura
Non Replicato
Lettura Parallela
Capacità: Chat, Players
Players.BubbleChat:boolean

CharacterAutoLoads
Non Replicato
Lettura Parallela
Capacità: Players
Players.CharacterAutoLoads:boolean
Campioni di codice
Timer di Respawn del Giocatore
local Players = game:GetService("Players")
-- Imposta CharacterAutoLoads su false
Players.CharacterAutoLoads = false
-- Rimuovi il personaggio del giocatore dallo spazio di lavoro alla morte
Players.PlayerAdded:Connect(function(player)
while true do
local char = player.CharacterAdded:Wait()
char.Humanoid.Died:Connect(function()
char:Destroy()
end)
end
end)
-- Respawna tutti i giocatori morti ogni 10 secondi
while true do
local players = Players:GetChildren()
-- Controlla se ogni giocatore è morto controllando se non ha un personaggio, se morto carica il personaggio di quel giocatore
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacterAsync()
end
end
-- Aspetta 10 secondi fino al prossimo controllo di respawn
task.wait(10)
end

ClassicChat
Sola Lettura
Non Replicato
Lettura Parallela
Capacità: Chat, Players
Players.ClassicChat:boolean

LocalPlayer
Sola Lettura
Non Replicato
Lettura Parallela
Capacità: Players
Players.LocalPlayer:Player

localPlayer
Obsoleto

MaxPlayers
Sola Lettura
Non Replicato
Lettura Parallela
Capacità: Players
Players.MaxPlayers:number

NumPlayers
Obsoleto

numPlayers
Obsoleto

PreferredPlayers
Sola Lettura
Non Replicato
Lettura Parallela
Capacità: Players
Players.PreferredPlayers:number

RespawnTime
Lettura Parallela
Capacità: Players
Players.RespawnTime:number

UseStrafingAnimations
Non programmabile
Lettura Parallela
Capacità: Players
Players.UseStrafingAnimations:boolean

Metodi
BanAsync
Resa
Capacità: Players, Consequences
Players:BanAsync(config:Dictionary):()
Parametri
config:Dictionary
Restituzioni
()
Campioni di codice
Bannare gli utenti
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = 86400 -- 24 ore in secondi. Raccomandazione: usa la tua logica basata sulla BanHistory dell'utente
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "Hai violato la linea guida della comunità n. #5",
PrivateReason = "Metti qui qualsiasi cosa che l'utente non dovrebbe sapere ma è utile per i tuoi registri",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
end

Chat
Sicurezza Plugin
Capacità: Players
Players:Chat(message:string):()
Parametri
message:string
Restituzioni
()
Campioni di codice
Players:Chat
-- Command bar
game:GetService("Players"):Chat("Ciao, mondo!") --Risultato: 'Ciao, mondo!' appare nel registro Chat sotto il nome del tuo Giocatore.
-- Script
local Players = game:GetService("Players")
Players:Chat("Ciao, mondo!") --Errore

CreateHumanoidModelFromDescription
Obsoleto

CreateHumanoidModelFromDescriptionAsync
Resa
Capacità: AvatarAppearance, Players
Players:CreateHumanoidModelFromDescriptionAsync(
description:HumanoidDescription, rigType:Enum.HumanoidRigType, assetTypeVerification:Enum.AssetTypeVerification
Parametri
assetTypeVerification:Enum.AssetTypeVerification
Valore predefinito: "Default"
Restituzioni
Campioni di codice
Crea un Modello Umanoide dalla Descrizione
game.Players:CreateHumanoidModelFromDescriptionAsync(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.Workspace

CreateHumanoidModelFromUserId
Obsoleto

CreateHumanoidModelFromUserIdAsync
Resa
Capacità: Players
Players:CreateHumanoidModelFromUserIdAsync(userId:User):Model
Parametri
userId:User
Restituzioni
Campioni di codice
Crea un Modello Umanoide da un ID Utente
game.Players:CreateHumanoidModelFromUserIdAsync(1).Parent = game.Workspace

GetBanHistoryAsync
Resa
Capacità: Players, Consequences
Players:GetBanHistoryAsync(userId:User):BanHistoryPages
Parametri
userId:User
Restituzioni

GetCharacterAppearanceAsync
Obsoleto

GetCharacterAppearanceInfoAsync
Resa
Capacità: Players
Players:GetCharacterAppearanceInfoAsync(userId:User):Dictionary
Parametri
userId:User
Restituzioni
Campioni di codice
Esempio di Dizionario dell'Aspetto del Personaggio di Ritorno
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 = "Hat",
id = 8,
},
name = "Cappello Striato",
},
{
id = 13062491,
assetType = {
name = "Face Accessory",
id = 42,
},
name = "Vision Française ",
},
{
id = 16598440,
assetType = {
name = "Neck Accessory",
id = 43,
},
name = "Papillon Rosso",
},
{
id = 28999228,
assetType = {
name = "Face",
id = 18,
},
name = "Sorpresa Gioiosa",
},
{
id = 86896488,
assetType = {
name = "Shirt",
id = 11,
},
name = "Giacca Tuxedo Rossa Costosa",
},
{
id = 86896502,
assetType = {
name = "Pants",
id = 12,
},
name = "Pantaloni Tuxedo Rossi Costosi",
},
{
id = 376530220,
assetType = {
name = "Left Arm",
id = 29,
},
name = "Braccio Sinistro ROBLOX Boy",
},
{
id = 376531012,
assetType = {
name = "Right Arm",
id = 28,
},
name = "Braccio Destro ROBLOX Boy",
},
{
id = 376531300,
assetType = {
name = "Left Leg",
id = 30,
},
name = "Gamba Sinistra ROBLOX Boy",
},
{
id = 376531703,
assetType = {
name = "Right Leg",
id = 31,
},
name = "Gamba Destra ROBLOX Boy",
},
{
id = 376532000,
assetType = {
name = "Torso",
id = 27,
},
name = "Torso ROBLOX Boy",
},
},
}
print(result)

GetFriendsAsync
Resa
Capacità: Players, Social
Players:GetFriendsAsync(userId:User):FriendPages
Parametri
userId:User
Restituzioni
Campioni di codice
Stampa Amici di Roblox
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
-- Prima, ottieni l'ID utente del giocatore
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- Poi, ottieni un oggetto FriendPages per i loro amici
local friendPages = Players:GetFriendsAsync(userId)
-- Itera sugli elementi nelle pagine. Per FriendPages, questi
-- sono tabelle di informazioni sull'amico, incluso il Nome Utente.
-- Raccogli ogni nome utente in un table
local usernames = {}
for item, _pageNo in iterPageItems(friendPages) do
table.insert(usernames, item.Username)
end
print("Connessioni di " .. USERNAME .. ": " .. table.concat(usernames, ", "))

GetHumanoidDescriptionFromOutfitId
Obsoleto

GetHumanoidDescriptionFromOutfitIdAsync
Resa
Capacità: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromOutfitIdAsync(outfitId:number):HumanoidDescription
Parametri
outfitId:number
Campioni di codice
Ottieni HumanoidDescription da 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
Obsoleto

GetHumanoidDescriptionFromUserIdAsync
Resa
Capacità: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromUserIdAsync(userId:User):HumanoidDescription
Parametri
userId:User
Campioni di codice
Ottieni HumanoidDescription da User ID
game.Players:CreateHumanoidModelFromDescriptionAsync(
game.Players:GetHumanoidDescriptionFromUserIdAsync(1),
Enum.HumanoidRigType.R15
).Parent =
game.Workspace

GetNameFromUserIdAsync
Resa
Capacità: Players
Players:GetNameFromUserIdAsync(userId:User):string
Parametri
userId:User
Restituzioni
Campioni di codice
Ottieni Nome da UserId
local Players = game:GetService("Players")
-- Dati di esempio:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- stampa: "RobloxRulez docsRule"
Ottieni il nome dall'UserId utilizzando una cache
local Players = game:GetService("Players")
-- Crea una tabella chiamata 'cache' per memorizzare ogni 'Name' man mano che vengono trovati.
-- Se cerchiamo un 'Name' utilizzando lo stesso 'UserId', il 'Name' verrà
-- dalla cache (veloce) invece di GetNameFromUserIdAsync() (restituisce).
local cache = {}
function getNameFromUserId(userId)
-- Prima, controlla se la cache contiene 'userId'
local nameFromCache = cache[userId]
if nameFromCache then
-- se un valore è stato memorizzato nella cache con la chiave 'userId', allora questo 'nameFromCache'
-- è il nome corretto e possiamo restituirlo.
return nameFromCache
end
-- Se siamo qui, 'userId' non è stato precedentemente cercato e non esiste nella
-- cache. Ora dobbiamo usare GetNameFromUserIdAsync() per cercare il nome
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- se 'success' è vero, GetNameFromUserIdAsync() ha trovato con successo il
-- nome. Memorizza questo nome nella cache utilizzando 'userId' come chiave in modo che
-- non dobbiamo mai cercare questo nome in futuro. Poi restituisci il nome.
cache[userId] = name
return name
end
-- Se siamo qui, 'success' è stato falso, il che significa che GetNameFromUserIdAsync()
-- non è stato in grado di trovare il 'name' per l' 'userId' fornito. Avvisa l'utente
-- che è successo e poi restituisci nulla, o nil.
warn("Impossibile trovare il nome per UserId:", userId)
return nil
end
-- Dati di esempio:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
-- La prima volta che viene utilizzato un UserId, verrà chiamato GetNameFromUserIdAsync()
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- Poiché 118271 è stato utilizzato in precedenza, ottieni il suo nome dalla cache
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- stampa: "RobloxRulez docsRule RobloxRulez"

GetPlayerByUserId
Scrivi Parallelo
Capacità: Players
Players:GetPlayerByUserId(userId:User):Player
Parametri
userId:User
Restituzioni
Campioni di codice
Players:GetPlayerByUserId
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("Il giocatore con userId 1 è in questo server! Il suo nome è: " .. player.Name)
else
print("Il giocatore con userId 1 non è in questo server!")
end

GetPlayerFromCharacter
Capacità: Players
Accesso alla simulazione
Players:GetPlayerFromCharacter(character:Model):Player
Parametri
character:Model
Restituzioni
Campioni di codice
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(`Giocatore {player.Name} ({player.UserId}) è nel gioco`)
else
print(`Giocatore {PLAYER_NAME} non è nel gioco!`)
end

GetPlayers
Scrivi Parallelo
Capacità: Players
Players:GetPlayers():{Player}
Restituzioni
Campioni di codice
Dare Glitter a Tutti
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- Dare loro dei glitter in testa se non ce l'hanno già
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- Controlla se sono già stati creati
if player.Character then
onCharacterAdded(player.Character)
end
-- Ascolta il giocatore che (ri)spawna
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)

getPlayers
Obsoleto

GetUserIdFromNameAsync
Resa
Capacità: Players
Players:GetUserIdFromNameAsync(userName:string):number
Parametri
userName:string
Restituzioni
Campioni di codice
Ottieni UserId da Nome
local Players = game:GetService("Players")
-- Dati di esempio:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- stampa: "118271 131963979"
Ottieni UserId da Nome utilizzando una cache
local Players = game:GetService("Players")
-- Crea una tabella chiamata 'cache' per memorizzare ogni 'UserId' man mano che vengono trovati.
-- Se cerchiamo un 'UserId' utilizzando lo stesso 'Name', l' 'UserId' verrà
-- dalla cache (veloce) invece di GetUserIdFromNameAsync() (restituisce).
local cache = {}
function getUserIdFromName(name)
-- Prima, controlla se la cache contiene 'name'
local userIdFromCache = cache[name]
if userIdFromCache then
-- se un valore è stato memorizzato nella cache con la chiave 'name', allora questo 'userIdFromCache'
-- è il corretto UserId e possiamo restituirlo.
return userIdFromCache
end
-- Se siamo qui, 'name' non è stato precedentemente cercato e non esiste nella
-- cache. Ora dobbiamo usare GetUserIdFromNameAsync() per cercare l'userId
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- se 'success' è vero, GetUserIdFromNameAsync() ha trovato con successo il
-- userId. Memorizza questo userId nella cache utilizzando 'name' come chiave in modo che
-- non dobbiamo mai cercare questo userId in futuro. Poi restituisci userId.
cache[name] = userId
return userId
end
-- Se siamo qui, 'success' è stato falso, il che significa che GetUserIdFromNameAsync()
-- non è stato in grado di trovare l' 'userId' per il 'name' fornito. Possiamo avvisare il
-- utente che è successo e poi restituire nulla, o nil.
warn("Impossibile trovare UserId per Nome:", name)
return nil
end
-- Esempio di Dati:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
-- La prima volta che viene utilizzato un Nome, GetUserIdFromNameAsync() verrà chiamato
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- Poiché "RobloxRulez" è stato utilizzato in precedenza, ottieni il suo UserId dalla cache
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- stampa: "118271 131963979 118271"

GetUserThumbnailAsync
Resa
Capacità: Players
Players:GetUserThumbnailAsync(
userId:User, thumbnailType:Enum.ThumbnailType, thumbnailSize:Enum.ThumbnailSize
Parametri
userId:User
thumbnailType:Enum.ThumbnailType
thumbnailSize:Enum.ThumbnailSize
Restituzioni
Campioni di codice
Visualizza Miniatura Giocatore
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- sostituisci con l'immagine segnaposto
-- recupera la miniatura
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- imposta il contenuto dell'ImageLabel sulla miniatura dell'utente
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)

playerFromCharacter
Obsoleto

players
Obsoleto

SetChatStyle
Sicurezza Plugin
Capacità: Players
Players:SetChatStyle(style:Enum.ChatStyle):()
Parametri
Valore predefinito: "Classic"
Restituzioni
()
Campioni di codice
Impostare lo Stile di Chat di un Giocatore
-- Command bar
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- Imposta lo stile di chat su Classic
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- Errori

TeamChat
Sicurezza Plugin
Capacità: Players
Players:TeamChat(message:string):()
Parametri
message:string
Restituzioni
()
Campioni di codice
Invio Chat di Squadra
-- Command bar
game.Players:TeamChat("Ciao Mondo") -- Invia un messaggio "Ciao Mondo" a tutti i giocatori nella squadra del giocatore locale
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("Ciao Mondo") -- Genera errori

UnbanAsync
Resa
Capacità: Players, Consequences
Players:UnbanAsync(config:Dictionary):()
Parametri
config:Dictionary
Restituzioni
()
Campioni di codice
Rimuovere il divieto agli utenti
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

Eventi
PlayerAdded
Capacità: Players
Players.PlayerAdded(player:Player):RBXScriptSignal
Parametri
player:Player
Campioni di codice
Players.PlayerAdded
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("Un giocatore è entrato: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)

PlayerMembershipChanged
Capacità: Players
Players.PlayerMembershipChanged(player:Player):RBXScriptSignal
Parametri
player:Player
Campioni di codice
Gestione delle modifiche all'abbonamento Premium
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- Concedi al giocatore l'accesso ad aree, oggetti o qualsiasi cosa tu possa immaginare riservati ai Premium!
print("Concedendo", player, "benefici premium!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("Evento ricevuto PlayerMembershipChanged. Nuovo abbonamento = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)

PlayerRemoving
Capacità: Players
Players.PlayerRemoving(
Parametri
player:Player
Campioni di codice
Players.PlayerRemoving
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("Un giocatore è uscito: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)

UserSubscriptionStatusChanged
Capacità: Players, Monetization
Players.UserSubscriptionStatusChanged(
user:Player, subscriptionId:string
Parametri
user:Player
subscriptionId:string

© 2026 Roblox Corporation. Roblox, il logo Roblox e Powering Imagination sono tra i nostri marchi registrati e non registrati negli Stati Uniti. e altri paesi.