Distintivos

Um distintivo é um prêmio especial que você pode conceder aos jogadores quando eles atingem uma meta dentro do seu jogo, como completar um objetivo difícil ou jogar por um determinado período de tempo. Assim que um jogador recebe um distintivo, ele é exibido na categoria Distintivos do seu inventário.

Criar distintivos

Você pode criar até 5 distintivos gratuitamente em um período de 24 horas (GMT) para cada jogo que você possui. Se você quiser criar mais dentro do período de 24 horas, cada distintivo adicional custa 100 Robux.

Para criar um distintivo:

1. Navegue até o Painel do Criador.

2. Passe o mouse sobre a miniatura de um jogo, clique no botão ⋯ e selecione Criar Distintivo.

   

3. Na página de criação, clique no botão Carregar Imagem e, em seguida, selecione/confirme a imagem que você deseja usar como ícone do distintivo. Ao criar uma imagem para usar em um distintivo, considere o seguinte:

   • Use um template de 512×512 pixels.

   • O processo de upload recorta e ajusta a imagem do distintivo em um ícone circular, portanto, evite colocar detalhes importantes fora dos limites circulares.

     

     

4. Preencha os seguintes campos:

   • Nome — Um título para o distintivo.
   • Descrição — Uma descrição do que o jogador pode fazer para ganhar o distintivo.
   • Distintivo está Ativado — Se o distintivo será ativado ou não quando for criado. Distintivos desativados não são exibidos na seção Distintivos da página principal do jogo e não podem ser ganhos pelos jogadores.

5. Clique no botão Criar Distintivo. O novo distintivo é exibido na seção Engajamento ⟩ Distintivos no Painel do Criador. Se o novo distintivo estiver ativado, ele também será mostrado na seção Distintivos da página principal do jogo.

   

Reordenar distintivos

Quando um distintivo é criado pela primeira vez, ele é colocado no final da lista de distintivos. Você pode reordenar até 50 distintivos de uma vez usando a interface de arrastar e soltar.

Para reordenar distintivos:

1. Navegue até o jogo associado.

2. No painel lateral sob o cabeçalho Engajamento, navegue até a página Distintivos.

3. Selecione Reordenar para navegar até a página de reordenação.

   

4. Na página de reordenação, arraste e solte os distintivos na ordem desejada.

   

5. Selecione Salvar para salvar esta ordem. A ordem especificada agora deve aparecer na página de detalhes do jogo.

Roteiros de distintivos

Fluxos de trabalho comuns de script de distintivos incluem conceder distintivos, verificar se um jogador já ganhou um distintivo no seu jogo e obter informações sobre o distintivo.

Localizar IDs de distintivos

O ID de um distintivo é seu identificador exclusivo. Você precisará desse ID ao implementar fluxos de trabalho como conceder o distintivo a um jogador.

1. No Painel do Criador, navegue até a seção Distintivos do jogo associado sob Engajamento.

2. Passe o mouse sobre a miniatura de um distintivo, clique no botão ⋯ e selecione Copiar ID do Ativo no menu de contexto.

   

Conceder distintivos

Você pode conceder distintivos a jogadores em todo o seu jogo chamando o método BadgeService:AwardBadgeAsync() em um Script do lado do servidor. BadgeService:GetBadgeInfoAsync() retorna propriedades do distintivo, incluindo IsEnabled, que confirma se o distintivo pode ou não ser concedido a um jogador. Você pode ativar ou desativar um distintivo no formulário Configurar Distintivo no Painel do Criador.

O seguinte é um exemplo de uma função segura para conceder distintivos a jogadores.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- Buscar informações do distintivo
	local success, badgeInfo = pcall(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- Confirmar que o distintivo pode ser concedido
		if badgeInfo.IsEnabled then
			-- Conceder distintivo
			local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
			if not awarded then
				warn("Erro ao conceder distintivo:", errorMessage)
			end
		end
	else
		warn("Erro ao buscar informações do distintivo: " .. badgeInfo)
	end
end

Verificar distintivos ganhos

O seguinte script verifica quando qualquer jogador entra no jogo, em seguida, usa o método BadgeService:UserHasBadgeAsync() para verificar se esse jogador possui o distintivo com o ID correspondente definido na variável BADGE_ID. Você também pode verificar a posse do distintivo em lotes usando o método BadgeService:CheckUserBadgesAsync().

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

local BADGE_ID = 00000000  -- Altere isso para o seu ID de distintivo

local function onPlayerAdded(player)
  -- Verifique se o jogador tem o distintivo
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- Se houver um erro, emita um aviso e saia da função
	if not success then
		warn("Erro ao verificar se o jogador tem o distintivo")
		return
	end

	if hasBadge then
		-- Trate a posse do distintivo do jogador conforme necessário
	end
end

-- Conectar eventos "PlayerAdded" à função "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Obter informações sobre o distintivo

Para obter informações sobre um distintivo, como sua descrição ou ID do ativo do ícone, chame o método BadgeService:GetBadgeInfoAsync() com um ID de distintivo. Por exemplo:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Altere isso para o seu ID de distintivo

-- Buscar informações do distintivo
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Exibir as informações
if success then
	print("Distintivo:", result.Name)
	print("Ativado:", result.IsEnabled)
	print("Descrição:", result.Description)
	print("Ícone:", "rbxassetid://" .. result.IconImageId)
else
	warn("Erro ao buscar informações do distintivo:", result)
end