Plugin Minecraft DeluxeTags

🔌 Sobre o DeluxeTags

O DeluxeTags é um plugin Spigot para Minecraft que oferece tags extras baseadas em permissões (prefixos), que os jogadores podem desbloquear e alternar entre si usando uma GUI no jogo ou comandos. As tags são tratadas como um "prefixo extra" e podem ser exibidas no chat, na tab e em outras integrações de chat através de placeholders.

🎯 Objetivo

O DeluxeTags resolve o problema de dar aos jogadores tags cosméticas opcionais e desbloqueáveis, separadas dos prefixos de rank/grupo. É útil para servidores que querem tags compráveis/desbloqueáveis ou obtidas como recompensa, e que os jogadores possam ativar ou desativar sem alterar seu grupo ou rank principal.

⚙️ Recursos

• Tags baseadas em permissões: conceda acesso com deluxetags.tag.<identifier> (exemplo mostrado na configuração como deluxetags.tag.example).
• GUI para o jogador navegar e selecionar as tags disponíveis.
• Comandos para listar, selecionar e gerenciar tags (comandos de jogador e administrador documentados pelo projeto).
• Suporte ao PlaceholderAPI e placeholders para inserir a tag ativa, identificador, descrição e contagem nos formatos de chat.
• Itens da GUI, nomes e configurações de paginação personalizáveis, mostrados no trecho de configuração do plugin.
• Opções para carregar a tag do jogador ao entrar, integração com formatação do chat e verificações de atualização.

🧩 Para quem é

• Servidores Survival / SMP que querem tags de chat cosméticas e desbloqueáveis, separadas dos prefixos de rank.
• Servidores que usam plugins de permissões para conceder recompensas cosméticas (por exemplo, via LuckPerms).
• Administradores que querem um seletor de tags simples baseado em GUI para os jogadores.

🏗️ Casos de uso de exemplo

• Conceder a um jogador a permissão de uma tag VIP como cosmético comprável e permitir que ele a alterne pela GUI de tags.
• Uma recompensa de evento concede uma permissão de tag específica, para que os vencedores possam selecionar a nova tag entre as tags disponíveis.
• Administradores criam tags personalizadas via comandos e definem quais jogadores podem usá-las por meio de permissões.

⌨️ Comandos

Observação: a documentação do projeto confirma esses comandos; os nodes de permissão específicos de comando (além do padrão por tag) não estão listados na fonte principal.

🔐 Permissões

O plugin usa nodes de permissão por tag; outros nodes específicos de comando não estão documentados explicitamente nos arquivos principais do projeto disponíveis.

⚙️ Instalação

📥 Configuração

• Baixe o arquivo JAR do plugin a partir do recurso Spigot do projeto ou dos artefatos oficiais de build.
• Coloque o JAR na pasta plugins/ do seu servidor.
• Inicie ou reinicie o servidor e verifique o console para confirmar que o plugin carregou.

📦 Dependências

• PlaceholderAPI — suportado (o plugin inclui placeholders e uma opção papi_chat), listado na configuração e nos exemplos de placeholders.

🧾 Configuração

• O DeluxeTags usa uma configuração YAML que define tags, opções da GUI e mensagens. A configuração inclui exemplos de entradas de tags, configurações dos itens da GUI, placeholders e opções de formato de chat. Chaves comuns vistas na configuração: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 Notas técnicas

• O código-fonte do projeto está disponível em um repositório público no GitHub.
• O projeto no Spigot lista versões testadas do Minecraft de 1.8 até 1.21 e inclui uma entrada específica da 1.20.6 na lista de versões testadas.
• Builds de desenvolvimento e artefatos de CI são fornecidos pelo servidor de CI do projeto.
• O repositório não mostra versões publicadas no host de origem; os artefatos de CI estão disponíveis separadamente.

🤝 Quando este plugin é útil

Se você quer que os jogadores tenham tags cosméticas opcionais, baseadas em permissões, que possam ativar por GUI ou comandos sem mudar seus grupos de rank, o DeluxeTags oferece uma solução simples e configurável, com integração ao PlaceholderAPI para exibição no chat.