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)
-- Recupera informações do badge
local success, badgeInfo = pcall(function()
return BadgeService:GetBadgeInfoAsync(badgeId)
end)
if success then
-- Confirma que o badge pode ser concedido
if badgeInfo.IsEnabled then
-- Concede o badge
local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
if not awarded then
warn("Erro ao conceder o badge:", errorMessage)
end
end
else
warn("Erro ao recuperar informações do badge: " .. 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 Insígnias Obtidas em Lotes
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeIds = { 0000000000, 1111111111, 2222222222 } -- Altere isso para uma lista de seus IDs de crachá
local function onPlayerAdded(player)
-- Verifique se o jogador tem algum dos crachás
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 crachás:", result)
return
end
local ownedBadgeIds = result
if #ownedBadgeIds == 0 then
print(player.Name, "não tem nenhum dos crachás")
else
print(player.Name, "tem os seguintes crachás:", 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 Emblema
local BadgeService = game:GetService("BadgeService")
-- Busca informações do emblema
local success, result = pcall(function()
return BadgeService:GetBadgeInfoAsync(00000000) -- Altere isso para o ID do emblema desejado
end)
-- Saída das informações
if success then
print("Emblema:", result.Name)
print("Habilitado:", result.IsEnabled)
print("Descrição:", result.Description)
print("Ícone:", "rbxassetid://" .. result.IconImageId)
else
warn("Erro ao buscar informações do emblema:", 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 Insígnias Obtidas
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeId = 00000000 -- Altere isso para o ID da sua insígnia
local function onPlayerAdded(player)
-- Verifique se o jogador possui a insígnia
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 possui insígnia!")
return
end
if hasBadge then
-- Manipule a posse da insígnia do jogador conforme necessário
print(player.Name, "possui a insígnia", 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.