Abzeichen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Ein Abzeichen ist eine spezielle Auszeichnung, die du Spielern schenken kannst, wenn sie ein Ziel innerhalb deiner Erlebniserreichen, wie das Abschließen eines schwierigen Ziels oder das Spielen für eine bestimmte Zeit.Sobald ein Spieler ein Abzeichen erhält, wird es innerhalb der Abzeichen -Kategorie seines Inventars angezeigt.

Example badges in a player's inventory
Beispiele für Abzeichen im Inventar eines Spieler:in

Abzeichen erstellen

Du kannst bis zu 5 Abzeichen kostenlos in einem 24-Stunden-Zeitraum (GMT) für jede Erfahrung erstellen, die du besitzen.Wenn du mehr innerhalb der 24-Stunden-Periode erstellen möchtest, kostet jedes zusätzliche Abzeichen 100 Robux.

Um ein Abzeichen zu erstellen:

  1. Navigiere zum Creator-Dashboard.

  2. Bewegen Sie den Mauszeiger über eine Miniaturansichteines Erlebnisses, klicken Sie auf die Schaltfläche und wählen Sie Abzeichen erstellen .

  3. Klicke auf der Seite "Erstellen" auf die Schaltfläche Bild hochladen und wähle dann das Bild aus, das du als das Symbol des Abzeichens verwenden möchtest.Wenn du ein Bild erstellst, das für ein Abzeichen verwendet wird, berücksichtige gefolgte Profile:

    • Verwende eine Vorlage von 512×512 Pixel .

    • Der Upload-Prozess schneidet und beschneidet das Abzeichenbild in ein rundenförmiges Symbol, vermeide es daher, wichtige Details außerhalb der runden Grenzen zu platzieren.

      Good circular trimming

      >

      >

      Bad circular trimming

      >

      >

  4. Fülle die folgenden Felder aus:

    • Name — Ein Titel für das Abzeichen.
    • Beschreibung — Eine Beschreibung dessen, was der Spieler tun kann, um das Abzeichen zu verdienen.
    • Abzeichen ist aktiviert — Ob das Abzeichen aktiviert wird oder nicht, wenn es erstellt wird.Deaktivierte Abzeichen werden unter der Abzeichen -Sektion der Hauptseite des Erlebnisses nicht angezeigt und können von Spielern nicht verdient werden.
  5. Klicken Sie auf die Schaltfläche Abzeichen erstellen .Das neue Abzeichen wird im EngagementAbzeichen Abschnitt des Creator-Dashboards angezeigt.Wenn das neue Abzeichen aktiviert ist, wird es auch unter der Abzeichen -Sektion der Hauptseite des Erlebnisses angezeigt.

    Abzeichen auf der Hauptseite des Erlebnisses

Abzeichen neu ordnen

Wenn ein Abzeichen zum ersten Mal erstellt wird, wird es am Ende der Abzeichenliste platziert. Du kannst bis zu 50 Abzeichen auf einmal mit dem Drag-and-Drop-Interface neu ordnen.

Um Abzeichen neu zu ordnen:

  1. Navigiere zum verbundenen Erlebnis.

  2. Im Seitenfeld unter dem Engagement -Header navigieren Sie zur Seite Abzeichen .

  3. Wählen Sie Umordern , um zur Umordierungsseite zu navigieren.

    Badge reorder button
  4. Auf der Seite "Neu anordnen" ziehe und lasse Abzeichen in ihre bevorzugte Reihenfolge ziehen.

    Badge drag-and-drop to reorder
  5. Wählen Sie Speichern , um diese Reihenfolge zu speichern. Die angegebene Reihenfolge sollte jetzt auf der Seite mit den Details des Erlebnisses angezeigt werden.

Skript-Abzeichen

Gewöhnliche Abzeichen-Skript-Workflows umfassen das Verleihen von Abzeichen, das Überprüfen, ob ein Spieler zuvor ein Abzeichen in deiner Erlebnisverdient hat und das Erhalten von Abzeicheninformationen.

Abzeichen-IDs finden

Die ID eines Abzeichens ist seine eindeutige Kennung. Du wirst diese ID benötigen, wenn du Workflows wie das Abzeichen vergeben an einen Spieler:inimplementierst.

  1. Auf dem Creator-Dashboard, navigiere zum Abschnitt Abzeichen der zugeordneten Erlebnisunter Engagement .

  2. Bewegen Sie den Mauszeiger über ein Abzeichen-Vorschaubild, klicken Sie auf die Schaltfläche und wählen Sie Kopiere Asset-ID aus dem Kontextmenü.

Auszeichnungsschleifen

Du kannst Abzeichen an Spieler während deiner gesamten Erfahrung vergeben, indem du die Methode BadgeService:AwardBadge() auf der Serverseite aufrufst in einem Script .BadgeService:GetBadgeInfoAsync() gibt Eigenschaften des Abzeichens zurück, einschließlich IsEnabled, die bestätigen, ob das Abzeichen einem Spieler:inverliehen werden kann oder nicht.Du kannst ein Abzeichen aktivieren oder deaktivieren aus der Abzeichen konfigurieren Form auf dem Creator-Dashboard.

Das Folgende ist ein Beispiel für eine sichere Funktion zur Verleihung von Abzeichen an Spieler.


local BadgeService = game:GetService("BadgeService")
local function awardBadge(player, badgeId)
-- Abrufen von Abzeicheninformationen
local success, badgeInfo = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, badgeId)
if success then
-- Bestätigen, dass das Abzeichen verliehen werden kann
if badgeInfo.IsEnabled then
-- Abzeichen
local awarded, errorMessage = pcall(BadgeService.AwardBadge, BadgeService, player.UserId, badgeId)
if not awarded then
warn("Error while awarding badge:", errorMessage)
end
end
else
warn("Error while fetching badge info!")
end
end

Verdiente Abzeichen überprüfen

Das folgende Skript prüft, wenn ein Spieler die Erlebnisbetritt, und verwendet dann die Methode BadgeService:UserHasBadgeAsync(), um zu überprüfen, ob dieser Spieler das Abzeichen mit der passenden ID besitzt, das in der Variable BADGE_ID festgelegt wurde.Du kannst auch die Abzeigeneigentümer in Serien mit der Methode BadgeService:CheckUserBadgesAsync() überprüfen.


local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local BADGE_ID = 00000000 -- Ändere dies zu deiner Abzeichen-ID
local function onPlayerAdded(player)
-- Überprüfe, ob der Spieler das Abzeichen hat
local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)
-- Wenn es einen Fehler gibt, geben Sie eine Warnung aus und beenden Sie die Funktion
if not success then
warn("Error while checking if player has badge")
return
end
if hasBadge then
-- Kümmere dich um die Abzeichenbesitz des Spieler:in, wie nötig
end
end
-- Verbinde "Spieler hinzugefügt"-Ereignisse mit der Funktion "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Abzeicheninformationen abrufen

Um Informationen über ein Abzeichen zu erhalten, wie seine Beschreibung oder die Icon-Asset-ID, rufe die BadgeService:GetBadgeInfoAsync() -Methode mit einer Abzeichen-ID auf. Zum Beispiel:


local BadgeService = game:GetService("BadgeService")
local BADGE_ID = 00000000 -- Ändere dies zu deiner Abzeichen-ID
-- Abrufen von Abzeicheninformationen
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)
-- Geben Sie die Informationen aus
if success then
print("Badge:", result.Name)
print("Enabled:", result.IsEnabled)
print("Description:", result.Description)
print("Icon:", "rbxassetid://" .. result.IconImageId)
else
warn("Error while fetching badge info:", result)
end