Distintivi

Un badge è un premio speciale che puoi regalare ai giocatori quando raggiungono un obiettivo all'interno della tua esperienza, come completare un obiettivo difficile o giocare per un certo periodo di tempo.Non appena un giocatore riceve un badge, viene visualizzato nella categoria Badge del suo Inventario, reportorio.

Crea distintivi

Puoi creare fino a 5 badge gratuiti in un periodo di 24 ore (GMT) per ogni esperienza che Proprio.Se vuoi creare di più nel periodo di 24 ore, ogni badge aggiuntivo costa 100 Robux.

Per creare un badge:

1. Naviga alla Dashboard del Creatore.

2. Passa il mouse su una miniatura di un'esperienza, fai clic sul pulsante ⋯ e seleziona Crea badge .

   

3. Sulla pagina di creazione, fai clic sul pulsante Carica immagine e quindi seleziona/conferma l'immagine che vuoi utilizzare come Iconadel badge.Quando crei un'immagine da utilizzare per un badge, considera quanto Seguendo:

   • Usa un modello di 512×512 pixel .

   • Il processo di caricamento taglia e ritaglia l'immagine del badge in un'Iconacircolare, quindi evita di inserire dettagli importanti al di fuori dei confini circolari.

     

     

4. Completa i seguenti campi:

   • Nome — Un titolo per il badge.
   • Descrizione — Una descrizione di ciò che il giocatore può fare per guadagnare il badge.
   • Il badge è abilitato — Se il badge verrà abilitato o meno quando viene creato.I badge disabilitati non vengono mostrati nella sezione Badge della pagina principale dell'esperienza e non possono essere guadagnati dai giocatori.

5. Fai clic sul pulsante Crea badge .Il nuovo badge viene visualizzato nella sezione Impegno ⟩ Badge della Dashboard del creatore.Se il nuovo badge è abilitato, verrà mostrato anche nella sezione Badges della pagina principale dell'esperienza.

   

Riorganizza i badge

Quando un badge viene creato per la prima volta, viene posizionato alla fine dell'elenco dei badge. Puoi riordinare fino a 50 badge contemporaneamente utilizzando l'interfaccia trascina e rilascia.

Per riordinare i badge:

1. Naviga all'esperienza associata.

2. Nel pannello laterale sotto l'intestazione Impegno , naviga alla pagina Badge .

3. Seleziona Riorganizza per navigare alla pagina di riorganizzazione.

   

4. Sulla pagina di riordino, trascina e rilascia i badge nell'ordine preferito.

   

5. Seleziona Salva per salvare questo ordine. L'ordine specificato dovrebbe ora apparire sulla pagina dettagli dell'esperienza.

Distintivi di script

I flussi di lavoro di script del badge comune includono assegnare badge , controllare se un giocatore ha precedentemente guadagnato un badge nella tua esperienza e ottenere informazioni sul badge .

Individua gli ID del badge

L'ID di un badge è il suo identificatore univoco. Avrai bisogno di questo ID quando implementi flussi di lavoro come assegnare il badge a un Giocatore.

1. Sulla Dashboard del creatore, naviga alla sezione Distintivi dell'esperienza associata sotto Impegno .

2. Passa il mouse su una miniatura di badge, fai clic sul pulsante ⋯ e seleziona Copia ID risorsa dal menu contestuale.

   

Distintivi di premio

Puoi assegnare badge ai giocatori durante la tua esperienza chiamando il metodo BadgeService:AwardBadge() in un lato server Script.BadgeService:GetBadgeInfoAsync() restituisce le proprietà del badge, tra cui IsEnabled che conferma se il badge può essere assegnato o meno a un Giocatore.Puoi abilitare o disabilitare un badge dalla forma Configura il badge sulla Dashboard del creatore.

Il seguente è un esempio di funzione sicura per assegnare badge ai giocatori.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
  -- Recupera le informazioni sul badge
  local success, badgeInfo = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, badgeId)
  if success then
    -- Conferma che il badge può essere assegnato
    if badgeInfo.IsEnabled then
      -- badgedi premio
      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

Controlla i badge guadagnati

Lo script seguente controlla quando qualsiasi giocatore entra nell'esperienza, quindi utilizza il metodo per verificare se quel giocatore possiede il badge con l'ID corrispondente impostato nella variabile .Puoi anche verificare la proprietà del badge in batch utilizzando il metodo BadgeService:CheckUserBadgesAsync().

local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")

local BADGE_ID = 00000000  -- Cambia questo per l'ID del tuo badge

local function onPlayerAdded(player)
  -- Verifica se il giocatore ha il badge
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- Se c'è un errore, emetti un avviso e esci dalla funzione
	if not success then
		warn("Error while checking if player has badge")
		return
	end

	if hasBadge then
		-- Gestisci la proprietà del badge del Giocatorecome necessario
	end
end

-- Connetti gli eventi "PlayerAdded" alla funzione "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Ottieni informazioni sul badge

Per ottenere informazioni su un badge, come la sua descrizione o l'ID risorsa dell'icona, chiama il metodo con un ID badge . Ad esempio:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Cambia questo per l'ID del tuo badge

-- Recupera le informazioni sul badge
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Esporta le informazioni
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