Insignes

Un badge est un prix spécial que vous pouvez offrir aux joueurs lorsqu'ils atteignent un objectif dans votre expérience, comme la réalisation d'un objectif difficile ou le jeu pendant une certaine période de temps. Dès que joueur reçoit un badge, il s'affiche dans la catégorie Badges de son 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 souhaitez 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. Passez la souris sur une miniatured'expérience, cliquez sur le bouton ⋯ et sélectionnez Créer badge .

   

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

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

   • Le processus de téléchargement coupe et recadre l'image du badge en une icône circulaire, évitez donc de placer 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 obtenir le badge.
   • Le badge est activé — Si le badge sera activé ou non lorsqu'il est créé.Les badges désactivés ne sont pas affichés dans 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 badge .Le nouveau badge s'affiche dans la section Engagement ⟩ Badges de la section Tableau de bord du créateur.Si le nouveau badge est activé, il sera également affiché dans la section badges de la page principale de l'expérience.

   

Recommander les badges

Lorsqu'un badge est créé pour la première fois, il est placé à la fin de la liste des badges. Vous pouvez réorganiser jusqu'à 50 badges à la fois en utilisant l'interface glisser-déposer.

Pour réorganiser les badges :

1. Accédez à l'expérience associée.

2. Dans le panneau latéral sous l'en-tête Engagement , naviguez vers la page Badges .

3. Sélectionnez Réorganiser pour naviguer vers la page de réorganisation.

   

4. Sur la page de réorganisation, faites glisser et déposez les badges dans l'ordre préféré.

   

5. Sélectionnez enregistrer pour enregistrer cet ordre. L'ordre spécifié devrait maintenant apparaître sur la page détails de l'expérience.

Insignes de script

Les flux de travail de script de badges communs 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 .

Localiser les ID 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. Passez la souris sur la miniatured'un badge, cliquez sur le bouton ⋯ et sélectionnez Copier l'ID de la ressource dans le menu contextuel.

   

Badges de récompense

Vous pouvez attribuer des badges aux joueurs tout au long de votre expérience en appelant la méthode BadgeService:AwardBadge() dans un côté serveur Script.BadgeService:GetBadgeInfoAsync() retourne les propriétés du badge, y compris IsEnabled qui confirme si le badge peut ou non être attribué à un joueur.Vous pouvez activer ou désactiver un badge à partir du formulaire Configurer le badge sur le tableau de bord du créateur.

Ce qui suit est un exemple d'une fonction sûre pour attribuer des badges aux joueurs.

local BadgeService = game:GetService("BadgeService")

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

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

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)

  -- S'il y a une erreur, émettez un avertissement et quittez la fonction
	if not success then
		warn("Error while checking if player has badge")
		return
	end

	if hasBadge then
		-- Gérer la propriété du badge du joueur comme nécessaire
	end
end

-- Relier les événements "Joueur ajouté" à 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'ID de la ressource iconique, appelez la méthode 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 sur le badge
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Afficher l'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