Plugin Minecraft NametagEdit

🔌 Sobre o NametagEdit

NametagEdit é um plugin de Minecraft que permite aos administradores do servidor alterar o texto mostrado acima da cabeça dos jogadores e a forma como os jogadores aparecem na lista TAB do servidor. O plugin oferece prefixos e sufixos configuráveis (por jogador ou por grupo), suporta formatação de cores, incluindo cores hexadecimais nas versões suportadas, e pode ordenar ou aplicar tags na lista TAB.

🎯 Objetivo

NametagEdit resolve o problema de etiquetas de jogador limitadas ou estáticas, ao permitir prefixos/sufixos dinâmicos baseados em permissões e ordenação da lista TAB. Destina-se a donos de servidor e administradores que querem diferenciação cosmética de nomes, etiquetas baseadas em rank ou uma ordenação mais flexível da lista TAB sem alterar skins ou nomes de conta dos jogadores.

⚙️ Funcionalidades

• Prefixo e sufixo configuráveis para jogadores individuais ou grupos nomeados.
• Personalização do nome na lista TAB e tags de grupo/jogador ordenáveis.
• Suporte a cores hex em versões modernas do Minecraft (confirmado para 1.16+).
• Integrações com sistemas populares de permissões e grupos para que as tags sejam atualizadas automaticamente quando o grupo de um utilizador muda.
• Backends de armazenamento e ferramentas de migração: suporte a FlatFile com conversores e suporte a MySQL com connection pooling.
• Suporte a placeholders através de APIs comuns de placeholders (listadas na documentação oficial).
• API para programadores disponível para autores de plugins interagirem com as funcionalidades do NametagEdit.

🧩 Para quem é

• Administradores de servidor que precisam de tags visuais por jogador ou por grupo.
• Servidores Survival/SMP e comunidades que usam ranks ou prefixos cosméticos.
• Servidores que usam plugins externos de permissões e querem que as tags reflitam permissões/grupos.

🏗️ Exemplos de uso

• Atribuir um prefixo colorido a staff ou ranks de doadores que apareça tanto acima do jogador como na lista TAB.
• Usar placeholders para mostrar informação dinâmica no prefixo ou sufixo de um jogador.
• Migrar dados de tags existentes de ficheiros flat para MySQL para armazenamento em rede.

⌨️ Comandos e permissões

O plugin documenta os seus comandos disponíveis e nós de permissão no repositório oficial e na documentação de suporte. Os donos do servidor devem consultar a documentação do repositório do plugin para saber a sintaxe exata dos comandos e os nós de permissão antes de aplicar alterações.

⚙️ Instalação

📥 Configuração

• Descarrega o ficheiro JAR oficial do NametagEdit e coloca-o no diretório plugins/ do teu servidor compatível com Spigot.
• Reinicia o servidor e verifica a consola para confirmar que o plugin carrega.

📦 Dependências

NametagEdit oferece integrações com vários sistemas de permissões e placeholders. As integrações confirmadas incluem GroupManager, PermissionsEx, zPermissions, LuckPerms, LibsDisguises e APIs comuns de placeholders. Consulta a documentação do plugin para passos opcionais de integração.

🧠 Notas técnicas

• As versões do Minecraft confirmadas e testadas incluem 1.7 até 1.20. Diferentes versões do Minecraft impõem diferentes limites de caracteres e suporte a funcionalidades:
  • Minecraft 1.7.x–1.12.x: os limites de caracteres do prefixo/sufixo são mais curtos (os limites legados de 16 caracteres aplicam-se à placa de nome acima da cabeça).
  • Minecraft 1.13.x–1.20.x: limites maiores (capacidade da lista TAB significativamente aumentada para tags mais longas).
  • Minecraft 1.16.x+: suporte confirmado a cores hex.
• O plugin usa packets e equipas do scoreboard; isto pode entrar em conflito com outros plugins que também manipulem equipas ou criem NPCs com nomes de utilizador idênticos.
• Licença: GPL-3.0.

❓ FAQ

• Q: Isto vai alterar a skin ou o nome da conta de um jogador?
  • A: Não — NametagEdit altera nametags através de packets/equipas do scoreboard; não modifica skins nem nomes de conta Mojang.
• Q: Porque é que os clientes podem crashar quando os nametags são atualizados?
  • A: Os clientes podem crashar se vários plugins tentarem colocar o mesmo jogador em equipas diferentes do scoreboard ou se dois plugins manipularem os mesmos IDs de equipa; esta é uma limitação de como os scoreboards e as equipas funcionam.

🤝 Quando este plugin é útil

Se precisas de tags visuais configuráveis e sensíveis às permissões para jogadores e de uma melhor ordenação da lista TAB (incluindo suporte a cores e placeholders), NametagEdit oferece uma base de código mantida e integrações que te permitem alinhar as tags visíveis com o sistema de ranks e grupos do teu servidor.