Insígnias

Uma insígnia ruim é um prêmio especial que você pode presentear aos jogadores quando eles atingirem uma meta dentro de sua experiência, como completar um objetivo difícil ou jogar por um determinado período de tempo.Assim que um jogador recebe uma emblema, ela é exibida na categoria Insígnias do seu inventário.

Criar insígnias

Você pode criar até 5 insígnias gratuitamente em um período de 24 horas (GMT) para cada experiência que possuir.Se você quiser criar mais dentro do período de 24 horas, cada insígnia adicional custa 100 Robux.

Para criar uma emblema:

1. Navegue até o Painel do Criador.

2. Passe o mouse sobre uma miniatura de experiência, clique no botão ⋯ e selecione Criar Emblema .

   

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

   • Use um modelo de 512×512 pixels .

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

     

     

4. Complete os seguintes campos:

   • Nome — Um título para a emblema.
   • Descrição — Uma descrição do que o jogador pode fazer para ganhar a emblema.
   • A insígnia está ativada — Se a insígnia será ativada ou não quando criada.Insígnias desativadas não são mostradas na seção Insígnias da página principal da experiência e não podem ser ganhas por jogadores.

5. Clique no botão Criar Emblema .A nova insígnia é exibida na seção Engajamento ⟩ Insígnias na seção Painel do Criador.Se a nova insígnia estiver habilitada, também será mostrada na seção Insígnias da página principal da experiência.

   

Reorganizar insígnias

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

Para reorganizar insígnias:

1. Navegue até a experiência associada.

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

3. Selecione Reorganizar para navegar para a página de reorganização.

   

4. Na página de reorganização, arraste e solte insígnias na ordem preferida deles.

   

5. Selecione Salvar para salvar essa ordem. A ordem especificada agora deve aparecer na página de detalhes da experiência.

Insígnias de script

Fluxos de trabalho de script de insígnias comuns incluem conceder insígnias, verificar se um jogador já ganhou anteriormente uma insígnia em sua experiência e obter informações de insígnias.

Localizar IDs de insígnia

O ID de um emblemaé 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 Insígnias da experiência associada sob Engajamento .

2. Passe o mouse sobre uma miniatura de um emblema, clique no botão ⋯ e selecione Copiar ID de Recurso no menu de contexto.

   

Insígnias de premiação

Você pode conceder insígnias a jogadores durante toda a sua experiência chamando o método BadgeService:AwardBadge() na parte do servidor Script.BadgeService:GetBadgeInfoAsync() retorna propriedades da emblema, incluindo IsEnabled que confirma se a insígnia pode ou não ser concedida a um jogador.Você pode ativar ou desativar uma insígnia da forma Configurar Insígnia no Painel do Criador.

O seguinte é um exemplo de uma função segura para conceder insígnias aos jogadores.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
  -- Obter informações de insígnia ruim
  local success, badgeInfo = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, badgeId)
  if success then
    -- Confirme que a insígnia pode ser concedida
    if badgeInfo.IsEnabled then
      -- emblemade prêmio
      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

Verifique os emblemas ganhos

O seguinte script verifica quando qualquer jogador entra na experiência, então usa o método para verificar se esse jogador possui o distintivo com o ID correspondente definido na variável .Você também pode verificar a propriedade 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 insígnia

local function onPlayerAdded(player)
  -- Verifique se o jogador tem a emblema
	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("Error while checking if player has badge")
		return
	end

	if hasBadge then
		-- Gerencie a propriedade do emblema do jogador conforme necessário
	end
end

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

Obter informações sobre a insígnia

Para obter informações sobre uma emblema, como sua descrição ou ID de recurso de ícone, chame o método com um ID de insígnia . Por exemplo:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Altere isso para o seu ID de insígnia

-- Obter informações de insígnia ruim
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Exibir a informação
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