Engine-Klasse
BadgeService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Zusammenfassung
Methoden
AwardBadge(userId: User,badgeId: number):boolean |
AwardBadgeAsync(userId: User,badgeId: number):boolean |
CheckUserBadgesAsync(userId: User,badgeIds: {any}):{any} |
GetBadgeInfoAsync(badgeId: number):Dictionary |
IsDisabled(badgeId: number):boolean |
UserHasBadge(userId: User,badgeId: number):boolean |
UserHasBadgeAsync(userId: User,badgeId: number):boolean |
API-Referenz
Methoden
AwardBadge
AwardBadgeAsync
Rückgaben
Code-Beispiele
Eine Auszeichnung verleihen
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local BADGE_ID = 0
local function awardBadge(player, badgeId)
-- Abzeicheninformationen abrufen
local success, badgeInfo = pcall(function()
return BadgeService:GetBadgeInfoAsync(badgeId)
end)
if success then
-- Bestätigen, dass das Abzeichen verliehen werden kann
if badgeInfo.IsEnabled then
-- Abzeichen verleihen
local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
if not awarded then
warn("Fehler beim Verleihen des Abzeichens:", errorMessage)
end
end
else
warn("Fehler beim Abrufen der Abzeicheninformationen: " .. badgeInfo)
end
end
local function onPlayerAdded(player)
awardBadge(player, BADGE_ID)
end
Players.PlayerAdded:Connect(onPlayerAdded)CheckUserBadgesAsync
Rückgaben
Code-Beispiele
Überprüfung der verdienten Abzeichen in Stapeln
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeIds = { 0000000000, 1111111111, 2222222222 } -- Ändern Sie dies in eine Liste Ihrer Abzeichen-IDs
local function onPlayerAdded(player)
-- Überprüfen Sie, ob der Spieler eines der Abzeichen hat
local success, result = pcall(function()
return BadgeService:CheckUserBadgesAsync(player.UserId, badgeIds)
end)
-- Wenn ein Fehler auftritt, geben Sie eine Warnung aus und beenden Sie die Funktion
if not success then
warn("Fehler beim Überprüfen, ob Spieler", player.Name, "Abzeichen hat:", result)
return
end
local ownedBadgeIds = result
if #ownedBadgeIds == 0 then
print(player.Name, "hat keine der Abzeichen")
else
print(player.Name, "hat die folgenden Abzeichen:", table.concat(ownedBadgeIds, ", "))
end
end
Players.PlayerAdded:Connect(onPlayerAdded)GetBadgeInfoAsync
Parameter
Rückgaben
Code-Beispiele
Badge-Info abrufen
local BadgeService = game:GetService("BadgeService")
-- Badge-Informationen abrufen
local success, result = pcall(function()
return BadgeService:GetBadgeInfoAsync(00000000) -- Ändere dies zur gewünschten Badge-ID
end)
-- Die Informationen ausgeben
if success then
print("Badge:", result.Name)
print("Aktiv:", result.IsEnabled)
print("Beschreibung:", result.Description)
print("Icon:", "rbxassetid://" .. result.IconImageId)
else
warn("Fehler beim Abrufen der Badge-Infos:", result)
endIsDisabled
IsLegal
UserHasBadge
UserHasBadgeAsync
Rückgaben
Code-Beispiele
Überprüfen der verdienten Abzeichen
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeId = 00000000 -- Ändere dies auf deine Abzeichen-ID
local function onPlayerAdded(player)
-- Überprüfen, ob der Spieler das Abzeichen hat
local success, hasBadge = pcall(function()
return BadgeService:UserHasBadgeAsync(player.UserId, badgeId)
end)
-- Wenn ein Fehler auftritt, gebe eine Warnung aus und verlasse die Funktion
if not success then
warn("Fehler beim Überprüfen, ob der Spieler das Abzeichen hat!")
return
end
if hasBadge then
-- Verwalte den Abzeichenbesitz des Spielers nach Bedarf
print(player.Name, "hat Abzeichen", badgeId)
end
end
-- Verbinde "PlayerAdded"-Ereignisse mit der "onPlayerAdded()"-Funktion
Players.PlayerAdded:Connect(onPlayerAdded)