Badges

Un badge è un premo speciale che puoi regalare ai giocatori quando raggiungono un obiettivo all'interno della tua esperienza, come ad esempio completare un obiettivo difficile o giocare per un certo periodo di tempo. Non appena un Giocatore riceve un Badge, questo viene visualizzato nella Categoria Badge nel proprio Inventario.

Creazione Badge

Quando stai creando un'immagine da utilizzare per il tuo Badge, considera i seguenti requisiti:

• Usa un modello 512×512 pixel.
• salva l'immagine in formato .jpg, .png, .tga, o .bmp.
• Non includere dettagli importanti al di fuori dei confini circolari perché il processo di caricamento trims e ritaglia il Badge finale in un'immagine circolare.

Puoi creare fino a 5 Badge gratuitamente in un periodo di 24 ore (GMT) per ogni esperienza che possiedi. Se vuoi creare più Badge entro il periodo di 24 ore, costa 100 Robux per ogni Badge aggiuntivo.

Per creare un Badge:

1. Vai al Pannello di creazione; Verranno visualizzate tutte le tue esperienze.

2. Clicca sull'esperienza per cui vuoi creare un Badge. viene visualizzata la pagina Panoramica dell'esperienza.

3. nel menu di navigazione a sinistra, seleziona Articoli Associati. La pagina Articoli associati visualizza per quella specifica esperienza con la sezione Badges aperta per impostazione predefinita.

   

4. Fai clic sul CREARE BADGE pulsante. La pagina Crea un Badge visualizza.

5. Fai clic sul pulsante CARICA IMMAGINE. Viene visualizzato un browser di file.

6. Selezione l'immagine che vuoi visualizzare come l'Icona, e poi fai click sul pulsanteApri;

7. Compila i seguenti campi:

   • Nome: Un titolo per il tuo Badge.
   • Descrizione: Una descrizione di quello che il giocatore può fare per guadagnare il Badge.

8. Clicca sul pulsante CREA Badge o Acquista per 100 Robux se hai già creato 5 Badge in un periodo di 24 ore. Il Distintivo viene visualizzato nella sezione Distintivi nella pagina degli Articoli Associati Items, e nella sezione Distintivi nella pagina principale dell'esperienza.

   

Individuazione degli ID badge

Un ID Badge è l'identificatore univoco di un Badge. Hai bisogno di questo ID quando sei Badge di scripting.

Per trovare un ID Badge:

1. Vai alla sezione Badges della pagina Articoli associati di un'esperienza.

2. Passa sopra una miniatura Badge e fai clic sul pulsante ⋯. Viene visualizzato un menu contestuale.

3. Seleziona Copia ID risorsa. L'ID Badge copia negli appunti.

   

Scripting dei badge

Usa lo scripting per dare e tenere traccia dei Badge nelle tue esperienze. I casi d'uso comuni dello script di badge includono assegnazione Distintivi, controllare se un giocatore ha precedentemente guadagnato un Badge nella tua esperienza, e ottenere informazioni sul distintivo.

Badge Premiazione

Puoi assegnare Badge ai giocatori durante la tua esperienza chiamando il BadgeService:AwardBadge() funzione in un lato server Classe.Script. Classe . adgeService:GetBadgeInfoAsync() restituisce le proprietà del Badge, incluso IsEnabled, che conferma se il Badge può essere assegnato o meno ad un giocatore. Dovresti chiamare questo per controllare prima di assegnare un Badge.

Lo script seguente contiene un esempio di una funzione sicura per l'assegnazione di Badge ai giocatori.

local BadgeService = game:GetService("BadgeService")
local function awardBadge(player, badgeId)
  -- Fetch Badge information
  local success, badgeInfo = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, badgeId)
  if success then
    -- Confirm that badge can be awarded
    if badgeInfo.IsEnabled then
      -- Award badge
      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

Controllo dei Distintivi guadagnati

Il seguente script controlla quando un giocatore entra nell'esperienza, quindi verifica se quel giocatore possiede il distintivo con l'ID corrispondente impostato nella variabilebadgeID.

local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local BADGE_ID = 00000000  -- Change this to your Badge ID
local function onPlayerAdded(player)
  -- Check if the player has the Badge
    local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, badgeID)
  -- If there's an error, issue a warning and exit the function
    if not success then
        warn("Error while checking if player has Badge!")
        return
    end
    if hasBadge then
        -- Handle player's Badge ownership as needed
    end
end
-- Connect "PlayerAdded" events to the "onPlayerAdded()" function
Players.PlayerAdded:Connect(onPlayerAdded)

Ottenere informazioni sul Distintivo

Per ottenere informazioni su un Distintivo, come la sua Descrizione o l' l'ID, usa la funzione BadgeService:GetBadgeInfoAsync() con un badge ID. Ad esempio:

local BadgeService = game:GetService("BadgeService")
local BADGE_ID = 00000000  -- Change this to your Badge ID
-- Fetch Badge information
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)
print(success, result)
-- Output the information
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