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 votre jeu, comme compléter un objectif difficile ou jouer pendant un certain temps. Dès qu'un joueur reçoit un badge, il s'affiche dans la catégorie Badges de son inventaire.

Exemple de badges dans l'inventaire d'un joueur

Créer des badges

Vous pouvez créer jusqu'à 5 badges gratuitement dans une période de 24 heures (GMT) pour chaque jeu que vous possédez. Si vous souhaitez en créer plus dans cette période de 24 heures, chaque badge supplémentaire coûte 100 Robux.

Pour créer un badge :

Accédez au Tableau de bord du créateur.
Survolez la miniature d'un jeu, cliquez sur le bouton ⋯ et sélectionnez Créer un badge.
Sur la page de création, cliquez sur le bouton Télécharger une image puis sélectionnez/confirmez l'image que vous souhaitez utiliser comme icône du badge. Lors de la création d'une image à utiliser pour un badge, considérez les éléments suivants :
- Utilisez un modèle de 512×512 pixels.
- Le processus de téléchargement découpe et rogne l'image du badge en une icône circulaire, donc évitez de mettre des détails importants en dehors des limites circulaires.
  
  Contenu principal inclus
  Contenu textuel rogné
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é — Indique si le badge sera activé lorsqu'il sera créé. Les badges désactivés ne sont pas affichés dans la section Badges de la page principale du jeu et ne peuvent pas être gagnés par les joueurs.
Cliquez sur le bouton Créer un badge. Le nouveau badge s'affiche dans la section Engagement ⟩ Badges sur le Tableau de bord du créateur. Si le nouveau badge est activé, il sera également affiché dans la section Badges de la page principale du jeu.

Badge sur la page principale du jeu

Réorganiser 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 de glisser-déposer.

Pour réorganiser les badges :

Accédez au jeu associé.
Dans le panneau latéral sous l'en-tête Engagement, accédez à la page Badges.
Sélectionnez Réorganiser pour accéder à la page de réorganisation.
Sur la page de réorganisation, faites glisser et déposez les badges dans l'ordre souhaité.
Sélectionnez Enregistrer pour sauvegarder cet ordre. L'ordre spécifié devrait maintenant apparaître sur la page des détails du jeu.

Script des badges

Les flux de travail de script de badge courants incluent l'attribution de badges, la vérification si un joueur a déjà gagné un badge dans votre jeu, et l'obtention d'informations sur le badge.

Localiser les ID de badge

L'ID d'un badge est son identifiant unique. Vous aurez besoin de cet ID lors de la mise en œuvre de flux de travail tels que l'attribution du badge à un joueur.

Sur le Tableau de bord du créateur, accédez à la section Badges du jeu associé sous Engagement.
Survolez la miniature d'un badge, cliquez sur le bouton ⋯ et sélectionnez Copier l'ID de l'actif dans le menu contextuel.

Attribuer des badges

Vous pouvez attribuer des badges aux joueurs tout au long de votre jeu en appelant la méthode BadgeService:AwardBadgeAsync() dans un Script côté serveur. BadgeService:GetBadgeInfoAsync() renvoie les propriétés du badge, y compris IsEnabled qui confirme si le badge peut ê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.

Voici un exemple d'une fonction sécurisée 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(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- Confirmer que le badge peut être attribué
		if badgeInfo.IsEnabled then
			-- Attribuer le badge
			local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
			if not awarded then
				warn("Erreur lors de l'attribution du badge :", errorMessage)
			end
		end
	else
		warn("Erreur lors de la récupération des informations sur le badge : " .. badgeInfo)
	end
end

Vérifier les badges gagnés

Le script suivant vérifie quand un joueur entre dans le jeu, puis utilise la méthode BadgeService:UserHasBadgeAsync() pour vérifier si ce joueur possède le badge avec l'ID correspondant défini dans la variable BADGE_ID. Vous pouvez également vérifier la possession de badges par lots en utilisant la méthode BadgeService:GetUserBadgesAsync().

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

local BADGE_ID = 00000000  -- Changez ceci avec l'ID de votre badge

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

  -- S'il y a une erreur, émettre un avertissement et quitter la fonction
	if not success then
		warn("Erreur lors de la vérification si le joueur a le badge")
		return
	end

	if hasBadge then
		-- Gérer la possession du badge par le joueur selon les besoins
	end
end

-- Connecter 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 son ID d'actif d'icône, appelez la méthode BadgeService:GetBadgeInfoAsync() avec un ID de badge. Par exemple :

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Changez ceci avec l'ID de votre badge

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

-- Afficher les informations
if success then
	print("Badge :", result.Name)
	print("Activé :", result.IsEnabled)
	print("Description :", result.Description)
	print("Icône :", "rbxassetid://" .. result.IconImageId)
else
	warn("Erreur lors de la récupération des informations sur le badge :", result)
end