Ein Abzeichen ist eine besondere Auszeichnung, die Sie Spielern schenken können, wenn sie ein Ziel in Ihrem Spiel erreichen, wie zum Beispiel das Abschließen eines schwierigen Ziels oder das Spielen über einen bestimmten Zeitraum. Sobald ein Spieler ein Abzeichen erhält, wird es in der Kategorie Abzeichen seines Inventars angezeigt.
Abzeichen erstellen
Sie können in einem Zeitraum von 24 Stunden (GMT) bis zu 5 Abzeichen kostenlos für jedes Spiel erstellen, das Sie besitzen. Wenn Sie innerhalb des 24‑Stunden-Zeitraums mehr erstellen möchten, kostet jedes zusätzliche Abzeichen 100 Robux.
Um ein Abzeichen zu erstellen:
Navigieren Sie zum Creator Dashboard.
Fahren Sie mit der Maus über das Thumbnail eines Spiels, klicken Sie auf die ⋯-Schaltfläche und wählen Sie Abzeichen erstellen.
Klicken Sie auf der Erstellungsseite auf die Schaltfläche Bild hochladen und wählen/bestätigen Sie das Bild, das Sie als Abzeichen-Icon verwenden möchten. Wenn Sie ein Bild erstellen, das Sie für ein Abzeichen verwenden möchten, beachten Sie Folgendes:
Verwenden Sie eine Vorlage von 512×512 Pixel.
Der Upload-Prozess schneidet das Abzeichenbild in ein kreisförmiges Icon, vermeiden Sie es daher, wichtige Details außerhalb der kreisförmigen Grenzen zu platzieren.
Hauptinhalt enthalten
Textinhalt beschnitten
Füllen Sie die folgenden Felder aus:
- Name — Ein Titel für das Abzeichen.
- Beschreibung — Eine Beschreibung, was der Spieler tun kann, um das Abzeichen zu verdienen.
- Abzeichen ist aktiviert — Ob das Abzeichen aktiviert wird, wenn es erstellt wird. Deaktivierte Abzeichen werden im Abschnitt Abzeichen der Hauptseite des Spiels nicht angezeigt und können von Spielern nicht erworben werden.
Klicken Sie auf die Schaltfläche Abzeichen erstellen. Das neue Abzeichen wird im Abschnitt Engagement ⟩ Abzeichen auf dem Creator Dashboard angezeigt. Wenn das neue Abzeichen aktiviert ist, wird es auch im Abschnitt Abzeichen der Hauptseite des Spiels angezeigt.
Abzeichen auf der Hauptseite des Spiels
Abzeichen neu ordnen
Wenn ein Abzeichen zuerst erstellt wird, wird es am Ende der Abzeichenliste eingereiht. Sie können bis zu 50 Abzeichen gleichzeitig mit der Drag-and-Drop-Oberfläche neu anordnen.
Um Abzeichen neu anzuordnen:
Navigieren Sie zum zugehörigen Spiel.
Navigieren Sie im Seitenbereich unter der Überschrift Engagement zur Seite Abzeichen.
Wählen Sie Neu anordnen, um zur Neuordnungsseite zu navigieren.
Ziehen und dropen Sie auf der Neuordnungsseite die Abzeichen in die gewünschte Reihenfolge.
Wählen Sie Speichern, um diese Reihenfolge zu speichern. Die angegebene Reihenfolge sollte jetzt auf der Detailseite des Spiels angezeigt werden.
Abzeichen-Skripte
Häufige Abzeichen-Skriptarbeitsabläufe umfassen das Zuweisen von Abzeichen, das Überprüfen, ob ein Spieler zuvor ein Abzeichen in Ihrem Spiel erhalten hat und das Abrufen von Abzeicheninformationen.
Abzeichen-IDs lokalisieren
Die ID eines Abzeichens ist sein eindeutiger Identifikator. Sie benötigen diese ID, wenn Sie Arbeitsabläufe wie das Zuweisen des Abzeichens an einen Spieler implementieren.
Navigieren Sie auf dem Creator Dashboard zum entsprechenden Spiel im Abschnitt Abzeichen unter Engagement.
Fahren Sie mit der Maus über das Thumbnail eines Abzeichens, klicken Sie auf die ⋯-Schaltfläche und wählen Sie Asset-ID kopieren aus dem Kontextmenü.
Abzeichen zuweisen
Sie können Spielern in Ihrem Spiel Abzeichen zuweisen, indem Sie die Methode BadgeService:AwardBadgeAsync() in einem serverseitigen Script aufrufen. BadgeService:GetBadgeInfoAsync() gibt Eigenschaften des Abzeichens zurück, einschließlich IsEnabled, was bestätigt, ob das Abzeichen einem Spieler zugewiesen werden kann oder nicht. Sie können ein Abzeichen im Formular Abzeichen konfigurieren auf dem Creator Dashboard aktivieren oder deaktivieren.
Im Folgenden finden Sie ein Beispiel für eine sichere Funktion zum Zuweisen von Abzeichen an Spieler.
local BadgeService = game:GetService("BadgeService")
local function awardBadge(player, badgeId)
-- Abrufen von Abzeicheninformationen
local success, badgeInfo = pcall(function()
return BadgeService:GetBadgeInfoAsync(badgeId)
end)
if success then
-- Bestätigen, dass das Abzeichen zugewiesen werden kann
if badgeInfo.IsEnabled then
-- Abzeichen zuweisen
local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
if not awarded then
warn("Fehler beim Zuweisen des Abzeichens:", errorMessage)
end
end
else
warn("Fehler beim Abrufen der Abzeicheninformationen: " .. badgeInfo)
end
end
Überprüfen, ob Abzeichen verdient wurden
Das folgende Skript überprüft, wann ein Spieler das Spiel betritt, und verwendet dann die Methode BadgeService:UserHasBadgeAsync(), um zu überprüfen, ob dieser Spieler das Abzeichen mit der im Variablen BADGE_ID festgelegten übereinstimmenden ID besitzt. Sie können auch die Abzeichenbesitzüberprüfung in Chargen mit der Methode BadgeService:CheckUserBadgesAsync() überprüfen.
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local BADGE_ID = 00000000 -- Ändern Sie dies in Ihre Abzeichen-ID
local function onPlayerAdded(player)
-- Überprüfen, ob der Spieler das Abzeichen hat
local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)
-- Wenn ein Fehler auftritt, eine Warnung ausgeben und die Funktion verlassen
if not success then
warn("Fehler beim Überprüfen, ob der Spieler das Abzeichen hat")
return
end
if hasBadge then
-- Verarbeiten des Abzeichenbesitzes des Spielers, wie erforderlich
end
end
-- Verbinden Sie die "PlayerAdded"-Ereignisse mit der Funktion "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)
Abzeicheninformationen abrufen
Um Informationen über ein Abzeichen zu erhalten, z. B. seine Beschreibung oder Asset-ID, rufen Sie die Methode BadgeService:GetBadgeInfoAsync() mit einer Abzeichen-ID auf. Zum Beispiel: