Classe do mecanismo
Players
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Resumo
Propriedades
Métodos
Eventos
PlayerAdded(player: Player):RBXScriptSignal |
PlayerMembershipChanged(player: Player):RBXScriptSignal |
PlayerRemoving(player: Player,reason: Enum.PlayerExitReason):RBXScriptSignal |
UserSubscriptionStatusChanged(user: Player,subscriptionId: string):RBXScriptSignal |
Referência API
Propriedades
CharacterAutoLoads
Amostras de código
Temporizador de Respawn do Jogador
local Players = game:GetService("Players")
-- Defina CharacterAutoLoads como falso
Players.CharacterAutoLoads = false
-- Remova o personagem do jogador do workspace na 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 todos os jogadores mortos a cada 10 segundos
while true do
local players = Players:GetChildren()
-- Verifique se cada jogador está morto verificando se não tem personagem, se morto carregue o personagem daquele jogador
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacterAsync()
end
end
-- Aguarde 10 segundos até a próxima verificação de respawn
task.wait(10)
endlocalPlayer
NumPlayers
numPlayers
Métodos
BanAsync
Parâmetros
Devolução
()
Amostras de código
Banindo Usuários
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = 86400 -- 24 horas em segundos. Recomendação: use sua própria lógica com base no BanHistory do usuário
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "Você violou a diretriz da comunidade #5",
PrivateReason = "Coloque qualquer coisa aqui que o usuário não deve saber, mas que é útil para seus registros",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
endChat
Parâmetros
Devolução
()
Amostras de código
Players:Chat
-- Barra de comando
game:GetService("Players"):Chat("Olá, mundo!") --Resulta em 'Olá, mundo!' aparecendo no log de Chat sob o nome do seu Jogador.
-- Script
local Players = game:GetService("Players")
Players:Chat("Olá, mundo!") --Gera errosCreateHumanoidModelFromDescription
CreateHumanoidModelFromDescriptionAsync
Players:CreateHumanoidModelFromDescriptionAsync(
description:HumanoidDescription, rigType:Enum.HumanoidRigType, assetTypeVerification:Enum.AssetTypeVerification
Parâmetros
| Valor Padrão: Default |
Devolução
Amostras de código
Criar Modelo Humanoide a partir da Descrição
game.Players:CreateHumanoidModelFromDescriptionAsync(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.WorkspaceCreateHumanoidModelFromUserId
CreateHumanoidModelFromUserIdAsync
GetBanHistoryAsync
Parâmetros
Devolução
GetCharacterAppearanceAsync
GetCharacterAppearanceInfoAsync
Parâmetros
Devolução
Amostras de código
Exemplo de Dicionário de Aparência de Personagem Retornado
GetFriendsAsync
Parâmetros
Devolução
Amostras de código
Imprimir Amigos do Roblox
local Players = game:GetService("Players")
local USERNAME = "Cozecant"
-- Primeiro, obtenha o ID do usuário do jogador
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- Em seguida, obtenha um objeto FriendPages para os amigos dele
local friendPages = Players:GetFriendsAsync(userId)
-- Percorra as páginas, coletando o nome de usuário de cada amigo. Cada entrada de página é
-- uma tabela de informações sobre o amigo, incluindo Nome de Usuário.
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("Amigos de " .. USERNAME .. ": " .. table.concat(usernames, ", "))GetHumanoidDescriptionFromOutfitId
GetHumanoidDescriptionFromOutfitIdAsync
Parâmetros
Devolução
Amostras de código
Obter HumanoidDescription a partir do ID do Traje
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 = WorkspaceGetHumanoidDescriptionFromUserId
GetHumanoidDescriptionFromUserIdAsync
Parâmetros
Devolução
Amostras de código
Obter HumanoidDescription a partir do ID do Usuário
game.Players:CreateHumanoidModelFromDescriptionAsync(
game.Players:GetHumanoidDescriptionFromUserIdAsync(1),
Enum.HumanoidRigType.R15
).Parent =
game.WorkspaceGetNameFromUserIdAsync
Parâmetros
Devolução
Amostras de código
Obter Nome do UserId
local Players = game:GetService("Players")
-- Dados de Exemplo:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- imprime: "RobloxRulez docsRule"Obter Nome do UserId usando um cache
local Players = game:GetService("Players")
-- Crie uma tabela chamada 'cache' para armazenar cada 'Name' à medida que são encontrados.
-- Se procurarmos um 'Name' usando o mesmo 'UserId', o 'Name' virá
-- do cache (rápido) em vez de GetNameFromUserIdAsync() (demora).
local cache = {}
function getNameFromUserId(userId)
-- Primeiro, verifique se o cache contém 'userId'
local nameFromCache = cache[userId]
if nameFromCache then
-- se um valor foi armazenado no cache na chave 'userId', então este 'nameFromCache'
-- é o Nome correto e podemos retorná-lo.
return nameFromCache
end
-- Se chegou aqui, 'userId' não foi procurado anteriormente e não existe no
-- cache. Agora precisamos usar GetNameFromUserIdAsync() para procurar o nome
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- se 'success' for verdadeiro, GetNameFromUserIdAsync() encontrou com sucesso o
-- nome. Armazene este nome no cache usando 'userId' como a chave para que
-- nunca tenhamos que procurar este nome no futuro. Então retorne o nome.
cache[userId] = name
return name
end
-- Se chegou aqui, 'success' foi falso, significando que GetNameFromUserIdAsync()
-- não conseguiu encontrar o 'name' para o 'userId' fornecido. Avise o usuário
-- que isso aconteceu e então retorne nada, ou nil.
warn("Não foi possível encontrar o Nome para UserId:", userId)
return nil
end
-- Dados de Exemplo:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
-- A primeira vez que um UserId é usado, GetNameFromUserIdAsync() será chamado
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- Como 118271 foi usado anteriormente, obtenha seu Nome do cache
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- imprime: "RobloxRulez docsRule RobloxRulez"GetPlayerByUserId
Parâmetros
Devolução
Amostras de código
Players:GetPlayerByUserId
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("O jogador com userId 1 está neste servidor! O nome dele é: " .. player.Name)
else
print("O jogador com userId 1 não está neste servidor!")
endGetPlayerFromCharacter
Parâmetros
Devolução
Amostras de código
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(`Jogador {player.Name} ({player.UserId}) está no jogo`)
else
print(`Jogador {PLAYER_NAME} não está no jogo!`)
endGetPlayers
Devolução
{Player}
Amostras de código
Dar Brilhos a Todos
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- Dê a eles brilhos na cabeça se ainda não tiverem
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- Verifique se eles já apareceram
if player.Character then
onCharacterAdded(player.Character)
end
-- Escute o jogador (re)aparecendo
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)getPlayers
GetProfileConfigurationFromUserIdAsync
GetUserIdFromNameAsync
Parâmetros
Devolução
Amostras de código
Obter UserId a partir do Nome
local Players = game:GetService("Players")
-- Exemplo de Dados:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- imprime: "118271 131963979"Obter UserId a partir do Nome usando um cache
local Players = game:GetService("Players")
-- Crie uma tabela chamada 'cache' para armazenar cada 'UserId' à medida que são encontrados.
-- Se procurarmos um 'UserId' usando o mesmo 'Name', o 'UserId' virá
-- do cache (rápido) em vez de GetUserIdFromNameAsync() (interrompe).
local cache = {}
function getUserIdFromName(name)
-- Primeiro, verifique se o cache contém 'name'
local userIdFromCache = cache[name]
if userIdFromCache then
-- se um valor foi armazenado no cache na chave 'name', então este 'userIdFromCache'
-- é o UserId correto e podemos retorná-lo.
return userIdFromCache
end
-- Se chegou aqui, 'name' não foi procurado anteriormente e não existe no
-- cache. Agora precisamos usar GetUserIdFromNameAsync() para procurar o userId
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- se 'success' for verdadeiro, GetUserIdFromNameAsync() encontrou com sucesso o
-- userId. Armazene este userId no cache usando 'name' como a chave para que
-- nunca tenhamos que procurar este userId no futuro. Então retorne userId.
cache[name] = userId
return userId
end
-- Se chegou aqui, 'success' foi falso, significando que GetUserIdFromNameAsync()
-- não conseguiu encontrar o 'userId' para o 'name' fornecido. Podemos avisar o
-- usuário que isso aconteceu e então retornar nada, ou nil.
warn("Não foi possível encontrar UserId para o Nome:", name)
return nil
end
-- Exemplo de Dados:
-- UserId: 118271 Nome: "RobloxRulez"
-- UserId: 131963979 Nome: "docsRule"
-- A primeira vez que um Nome é usado, GetUserIdFromNameAsync() será chamado
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- Como "RobloxRulez" foi usado anteriormente, obtenha seu UserId do cache
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- imprime: "118271 131963979 118271"GetUserThumbnailAsync
Players:GetUserThumbnailAsync(
Parâmetros
Devolução
Amostras de código
Exibir Miniatura do Jogador
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- substitua pela imagem de espaço reservado
-- buscar a miniatura
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- definir o conteúdo do ImageLabel para a miniatura do usuário
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)playerFromCharacter
players
SetChatStyle
Parâmetros
| Valor Padrão: Classic |
Devolução
()
Amostras de código
Definindo o Estilo de Chat de um Jogador
-- Barra de comando
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- Define o estilo de chat como Clássico
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- Gera errosTeamChat
Parâmetros
Devolução
()
Amostras de código
Enviando Chat da Equipe
-- Barra de comando
game.Players:TeamChat("Olá Mundo") -- Envia uma mensagem "Olá Mundo" para todos os jogadores na equipe do jogador local
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("Olá Mundo") -- Gera errosUnbanAsync
Parâmetros
Devolução
()
Amostras de código
Desbanindo Usuários
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)
endEventos
PlayerAdded
Parâmetros
Amostras de código
Players.PlayerAdded
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("Um jogador entrou: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)PlayerMembershipChanged
Parâmetros
Amostras de código
Gerenciando Mudanças na Assinatura Premium
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- Conceda ao jogador acesso a áreas, itens ou qualquer coisa que você possa imaginar, apenas para Premium!
print("Dando", player, "benefícios premium!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("Recebido evento PlayerMembershipChanged. Nova assinatura = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)PlayerRemoving
Parâmetros
Amostras de código
Players.PlayerRemoving
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("Um jogador saiu: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)UserSubscriptionStatusChanged