Badges

Un badge est un prix spécial que vous pouvez offrir aux joueurs lorsqu'ils atteignent un objectif dans votre expérience, comme terminer un objectif difficile ou jouer pendant un certain temps. Dès que quelqu'un reçoit un badge, il s'affiche dans la catégorie Badges de leur inventaire.

Créer des Badges

Vous pouvez créer jusqu'à 5 badges gratuits dans une période de 24 heures (GMT) pour chaque expérience que vous posséder. Si vous voulez en créer plus dans la période de 24 heures, chaque badge supplémentaire coûte 100 Robux.

Pour créer un badge :

1. Accédez à la tableau de bord du créateur.

2. Localisez l'expérience associée, cliquez sur le ⋯ dans le coin de sa miniature, et sélectionnez Créer un badge .

   

3. Sur la page de création, cliquez sur le bouton Télécharger image et sélectionnez/confirmez l'image que vous voulez utiliser comme l'icône de badge. Lors de la création d'une image à utiliser pour un badge, tenez compte des suivre:

   • Utilisez un modèle de 512×512 pixels .

   • Le processus de téléchargement coupe et recadre l'image de badge en un icône circulaire, afin d'éviter de mettre des détails importants en dehors des limites circulaires.

     

     

4. Remplissez les champs suivants :

   • Nom — Un titre pour le badge.
   • Description — une description de ce que le joueur peut faire pour gagner le badge.
   • Le badge est activé — Que le badge soit activé ou non lorsqu'il est créé. Les badges désactivés ne sont pas affichés sous la section Badges de la page principale de l'expérience et ne peuvent pas être gagnés par les joueurs.

5. Cliquez sur le bouton Créer un badge. Le nouveau badge s'affiche dans la section engagement → badges de la page principale de la création. Si le nouveau badge est activé, il s'affichera également sous la section 2>badges2> de la page principale de l'expérience.

   

Badges de script

Les workflows de script de badge commun incluent attribuer des badges , vérifier si un joueur a précédemment gagné un badge dans votre expérience, et obtenir des informations sur les badges .

Localisation des identifiants de badge

L'ID d'un badge est son identifiant unique. Vous aurez besoin de cet ID lors de l'implémentation de workflows tels que attribuer le badge à un joueur.

1. Sur le tableau de bord du créateur, naviguez dans la section Badges de l'expérience associée sous engagement.

   

2. Cliquez sur le bouton ⋯ pour un badge et sélectionnez Copier l'ID de la ressource .

   

Attribution de badges

Vous pouvez attribuer des badges aux joueurs tout au long de votre expérience en appelant la méthode BadgeService:AwardBadge() dans un Script côté serveur. Class.BadgeService:GetBadgeInfoAsync()</

Ce qui suit est un exemple d'une fonction de sécurité pour attribuer des badges aux joueurs.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
  -- Récupérer les informations de badge
  local success, badgeInfo = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, badgeId)
  if success then
    -- Confirmer que le badge peut être attribué
    if badgeInfo.IsEnabled then
      -- Récompense de 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

Vérification des badges gagnés

Le script suivant vérifie quand un joueur entre dans l'expérience, puis utilise la méthode BadgeService:UserHasBadgeAsync() pour vérifier si ce joueur possède le badge avec l'ID correspondant ID défini dans la variable BADGE_ID. Vous pouvez également vérifier la propriété du badge dans les lots en utilisant la méthode 1> Class

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

local BADGE_ID = 00000000  -- Changez-le en votre ID de badge

local function onPlayerAdded(player)
  -- Vérifiez si le joueur a le badge
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- Si une erreur se produit, avertissez et quittez la fonction
	if not success then
		warn("Error while checking if player has badge")
		return
	end

	if hasBadge then
		-- Gérez la propriété du badge du joueur au besoin
	end
end

-- Connectez les événements "PlayerAdded" à la fonction "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Obtenir des informations sur le badge

Pour obtenir des informations sur un badge, telles que sa description ou l'identifiant de l'icône, appelez la méthode Class.BadgeService:GetBadgeInfoAsync() avec un ID de badge. Par exemple :

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Changez-le en votre ID de badge

-- Récupérer les informations de badge
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Sortir les informations
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