Aprenda
Classe do mecanismo
BadgeService
Não criável
Serviço

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Métodos
AwardBadge(userId: User,badgeId: number):boolean
Obsoleto
IsDisabled(badgeId: number):boolean
Obsoleto
IsLegal(badgeId: number):boolean
Obsoleto
UserHasBadge(userId: User,badgeId: number):boolean
Obsoleto
Membros herdados

Referência API
Métodos
AwardBadge
Obsoleto

AwardBadgeAsync
Rendimentos
Recursos: AssetManagement
BadgeService:AwardBadgeAsync(
userId:User, badgeId:number
Parâmetros
userId:User
badgeId:number
Devolução
Amostras de código
Concedendo um Distintivo
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local BADGE_ID = 0
local function awardBadge(player, badgeId)
-- Buscar informações do distintivo
local success, badgeInfo = pcall(function()
return BadgeService:GetBadgeInfoAsync(badgeId)
end)
if success then
-- Confirmar que o distintivo pode ser concedido
if badgeInfo.IsEnabled then
-- Conceder distintivo
local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
if not awarded then
warn("Erro ao conceder distintivo:", errorMessage)
end
end
else
warn("Erro ao buscar informações do distintivo: " .. badgeInfo)
end
end
local function onPlayerAdded(player)
awardBadge(player, BADGE_ID)
end
Players.PlayerAdded:Connect(onPlayerAdded)

CheckUserBadgesAsync
Rendimentos
Recursos: AssetManagement
BadgeService:CheckUserBadgesAsync(
userId:User, badgeIds:{any}
Parâmetros
userId:User
badgeIds:{any}
Devolução
Amostras de código
Verificando Distintivos Obtidos em Lotes
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeIds = { 0000000000, 1111111111, 2222222222 } -- Altere isso para uma lista dos seus IDs de distintivos
local function onPlayerAdded(player)
-- Verifique se o jogador possui algum dos distintivos
local success, result = pcall(function()
return BadgeService:CheckUserBadgesAsync(player.UserId, badgeIds)
end)
-- Se houver um erro, emita um aviso e saia da função
if not success then
warn("Erro ao verificar se o jogador", player.Name, "tem distintivos:", result)
return
end
local ownedBadgeIds = result
if #ownedBadgeIds == 0 then
print(player.Name, "não possui nenhum dos distintivos")
else
print(player.Name, "possui os seguintes distintivos:", table.concat(ownedBadgeIds, ", "))
end
end
Players.PlayerAdded:Connect(onPlayerAdded)

GetBadgeInfoAsync
Rendimentos
Recursos: AssetManagement
BadgeService:GetBadgeInfoAsync(badgeId:number):Dictionary
Parâmetros
badgeId:number
Devolução
Amostras de código
Obtendo Informações do Distintivo
local BadgeService = game:GetService("BadgeService")
-- Buscar informações do distintivo
local success, result = pcall(function()
return BadgeService:GetBadgeInfoAsync(00000000) -- Altere isso para o ID do distintivo desejado
end)
-- Exibir as informações
if success then
print("Distintivo:", result.Name)
print("Habilitado:", result.IsEnabled)
print("Descrição:", result.Description)
print("Ícone:", "rbxassetid://" .. result.IconImageId)
else
warn("Erro ao buscar informações do distintivo:", result)
end

IsDisabled
Obsoleto

IsLegal
Obsoleto

UserHasBadge
Obsoleto

UserHasBadgeAsync
Rendimentos
Recursos: AssetManagement
BadgeService:UserHasBadgeAsync(
userId:User, badgeId:number
Parâmetros
userId:User
badgeId:number
Devolução
Amostras de código
Verificando Distintivos Obtidos
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeId = 00000000 -- Altere isso para o ID do seu distintivo
local function onPlayerAdded(player)
-- Verifique se o jogador tem o distintivo
local success, hasBadge = pcall(function()
return BadgeService:UserHasBadgeAsync(player.UserId, badgeId)
end)
-- Se houver um erro, emita um aviso e saia da função
if not success then
warn("Erro ao verificar se o jogador tem o distintivo!")
return
end
if hasBadge then
-- Trate a posse do distintivo do jogador conforme necessário
print(player.Name, "tem o distintivo", badgeId)
end
end
-- Conecte eventos "PlayerAdded" à função "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.