Badges | Documentation - Hub Création Roblox

Un badge est une récompense spéciale que vous pouvez offrir aux joueurs lorsqu'ils atteignent un objectif dans le cadre de votre expérience, comme remplir un objectif difficile ou atteindre un certain temps de jeu. Dès qu'un joueur reçoit un badge, celui-ci s'affiche dans la catégorie Badges de son inventaire.

Créer des badges

Lorsque vous créez une image à utiliser pour votre badge, veuillez tenir compte des exigences suivantes :

Utilisez un modèle de 512 × 512 pixels.
Enregistrez l'image au format .jpg, .png, .tga, ou .bmp.
N'incluez aucun détail important en dehors des limites du cercle, car le processus de téléchargement réduit et recadre le badge final en une image en forme de cercle.

Vous pouvez créer gratuitement jusqu'à 5 badges par période de 24 heures (GMT) pour chaque expérience que vous possédez. Si vous souhaitez créer plus de badges pendant cette période de 24 heures, il vous en coûtera 100 Robux par badge supplémentaire.

Pour créer un badge :

Accédez à l'Interface de création.
Cliquez sur l'expérience pour laquelle vous souhaitez créer un badge. La page Aperçu de l'expérience s'affiche.
Dans la navigation de gauche, sélectionnez Objets associés. La page Objets associés s'affiche pour cette expérience spécifique et la section Badges est ouverte par défaut.
Cliquez sur le bouton CRÉER UN BADGE. La page Créer un passe s'affiche.
Cliquez sur le bouton TÉLÉCHARGER UNE IMAGE. Un navigateur de fichiers s'affiche.
Sélectionnez l'image que vous souhaitez afficher comme icône, puis cliquez sur le bouton Ouvrir.
Complétez les champs suivants :
- Nom : un titre pour votre badge.
- Description : une description de ce que le joueur peut faire pour gagner le badge.
Cliquez sur le bouton CRÉER un badge ou sur le bouton Acheter pour 100 Robux si vous avez déjà créé 5 badges en 24 heures. Le badge s'affiche dans la section Badges de la page Objets associés, ainsi que dans la section Badges de la page principale de l'expérience.

Localiser les ID de badge

Un ID de badge est l'identifiant unique d'un badge. Vous avez besoin de cet ID lorsque vous scriptez des Badges.

Pour localiser un ID de badge :

Accédez à la section Badges de la page Objets associés d'une expérience.
Passez le curseur sur une vignette de badge et cliquez sur le bouton ⋯. Un menu contextuel s'affichera.
Sélectionnez Copier l'ID de l'actif. L'ID du badge est copié dans le presse-papiers.

Scripter des badges

Utilisez des scripts pour attribuer des badges et en conserver la trace dans vos expériences. Les cas d'utilisation courants des scripts de badges comprennent l'attribution de badges, la vérification qu'un joueur a déjà obtenu un badge dans votre expérience et l'obtention d'informations sur les badges.

Attribuer des badges

Vous pouvez attribuer des badges aux joueurs dans le cadre de votre expérience en appelant la fonction BadgeService:AwardBadge() dans un Script côté serveur. BadgeService:GetBadgeInfoAsync() renvoie les propriétés du badge, y compris IsEnabled, qui confirme si le badge peut ou non être attribué à un joueur. Nous vous recommandons de l'appeler pour vérifier avant d'attribuer un badge.

Le script suivant contient un exemple de fonction sécurisée permettant d'attribuer des badges aux joueurs.


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
  end
end

Vérifier les badges gagnés

Le script suivant permet de vérifier à quel moment un joueur entre dans l'expérience, puis de contrôler si ce joueur possède le badge avec l'ID correspondant configuré dans la variable badgeID.


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

Obtenir des informations sur les badges

Pour obtenir des informations sur un badge, telles que sa description ou l'ID d'objet de l'icône, utilisez la fonction BadgeService:GetBadgeInfoAsync() avec un badge ID. Par exemple :


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