Un badge est une récompense spéciale que vous pouvez offrir aux joueurs lorsqu'ils atteignent un objectif dans votre jeu, comme terminer un objectif difficile ou jouer pendant une certaine période. Dès qu'un 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 gratuitement dans une période de 24 heures (GMT) pour chaque jeu que vous possédez. Si vous souhaitez en créer plus dans la période de 24 heures, chaque badge supplémentaire coûte 100 Robux.
Pour créer un badge :
Accédez au Tableau de bord des créateurs.
Survolez la vignette 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 l'image puis sélectionnez/confirmez l'image que vous souhaitez utiliser comme icône du badge. Lorsque vous créez 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 ajuste et recadre 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 texte recadré
Remplissez les champs suivants :
- Nom — Un titre pour le badge.
- Description — Une description de ce que le joueur peut faire pour gagner le badge.
- Badge 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 du Tableau de bord des créateurs. 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 d'abord créé, il est placé à la fin de la liste des badges. Vous pouvez réorganiser jusqu'à 50 badges à la fois à l'aide de 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 naviguer vers la page de réorganisation.
Sur la page de réorganisation, faites glisser et déposez les badges dans l'ordre que vous souhaitez.
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 badges communs incluent attribuer des badges, vérifier si un joueur a déjà gagné un badge dans votre jeu, et obtenir des informations sur un 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 attribuer le badge à un joueur.
Sur le Tableau de bord des créateurs, accédez à la section Badges du jeu associé sous Engagement.
Survolez la vignette 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() retourne 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 depuis le formulaire Configurer le badge sur le Tableau de bord des créateurs.
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 lorsqu'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 du badge par lots en utilisant la méthode BadgeService:CheckUserBadgesAsync().
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local BADGE_ID = 00000000 -- Changez ceci avec 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)
-- En cas d'erreur, émettez un avertissement et quittez 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érez la possession du badge par le joueur au besoin
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 icône, appelez la méthode BadgeService:GetBadgeInfoAsync() avec un ID de badge. Par exemple :