Plugin Minecraft TitleManager

🔌 Sobre o TitleManager

TitleManager é um plugin de Minecraft que gere elementos de apresentação visíveis aos jogadores: títulos e subtítulos animados ao centro do ecrã, actionbars, cabeçalhos e rodapés animados da lista de jogadores e um scoreboard lateral configurável. Funciona como uma camada de apresentação para servidores que querem mensagens de entrada mais polidas, anúncios e exibições em tempo real da tab/scoreboard.

🎯 Objetivo

O plugin centraliza as funcionalidades de exibição (titles, actionbars, tab-list, sidebars) para que os proprietários do servidor possam apresentar informação consistente, animada e baseada em placeholders aos jogadores sem programação personalizada. Destina-se a administradores de servidores que querem gerir mensagens de entrada/boas-vindas, anúncios rotativos e uma UI dinâmica de TAB/scoreboard.

⚙️ Funcionalidades

• Titles e actionbars configuráveis para entrada e primeira entrada, com opções de tempo e variantes.
• Cabeçalho e rodapé da lista de jogadores animados e com gradiente, com placeholders para contagem de jogadores online, hora do mundo/servidor e outros valores dinâmicos.
• Scoreboard lateral configurável com até 15 linhas animadas suportadas pelo sistema de scoreboard do servidor.
• Anúncios em broadcast e agendados entregues como titles ou actionbars.
• Motor de animação com ficheiros de animação reutilizáveis e pré-visualizações (o playground de animação está disponível na documentação oficial).
• Integrações de placeholders (placeholders incorporados do TitleManager e suporte para sistemas externos de placeholders quando presentes).
• Recargas transacionais: as recargas de configuração são aplicadas em segurança e podem ser revertidas se a nova configuração for inválida.
• Uma pequena API voltada para programadores para integrações opcionais e uso plugin-a-plugin.

🧩 Para quem é

• Servidores Survival e SMP que querem uma UI de entrada/anúncio polida.
• Servidores que usam placeholders e integrações externas (para valores dinâmicos nas exibições).
• Administradores que precisam de exibições animadas da tab e da scoreboard sem escrever plugins personalizados.
• Programadores que querem integrar funcionalidades de apresentação noutros plugins através da API fornecida.

🏗️ Exemplos de uso

• Mostrar um title de boas-vindas animado e uma actionbar quando os jogadores entram, com uma mensagem diferente na primeira entrada.
• Manter a lista de jogadores da tab viva, mostrando a hora do servidor, a contagem de jogadores online e cabeçalhos/rodapés com gradiente.
• Alternar titles ou actionbars de anúncios animados num horário definido para comunicar eventos ou regras.
• Usar o scoreboard lateral para exibir rankings, estatísticas ou informação dinâmica do servidor.

⌨️ Comandos

Notas: os comandos acima estão documentados pelo projeto. Os nós de permissão específicos não foram listados nas fontes usadas aqui e devem ser consultados na documentação do plugin para obter os nós exatos e os valores predefinidos.

⚙️ Instalação

📥 Configuração

• Descarrega o JAR do plugin a partir da release do projeto ou da página do recurso do plugin.
• Coloca o JAR no diretório plugins/ do teu servidor.
• Reinicia o servidor.
• Edita os ficheiros de configuração gerados em plugins/TitleManager/ para ajustar títulos, animações e definições da lista de jogadores.
• Usa /tm reload para aplicar alterações de configuração; o plugin faz recargas transacionais para evitar aplicar configurações corrompidas.

📦 Dependências

• PlaceholderAPI (integração opcional para placeholders externos).
• Vault (opcional, usado para valores de placeholders quando presente).
• BungeeCord (comportamento ciente da integração quando usado em setups de proxy).

Estas integrações são opcionais e usadas quando estão presentes; o plugin funciona sem elas, mas pode usar os respetivos dados quando disponíveis.

🧠 Notas técnicas

• Os alvos oficiais de runtime incluem Minecraft 1.8 até 1.21.x (o material do projeto refere suporte explícito até 1.21.11). O comportamento varia consoante a versão do servidor: as versões mais recentes do Minecraft usam as APIs modernas do Bukkit/Paper, enquanto as versões legadas dependem de módulos de compatibilidade por versão.
• TitleManager disponibiliza uma pequena API para Bukkit para integrações opcionais e fornece documentação de API gerada.
• Existem comandos de recarga segura e diagnósticos para ajudar na configuração e na resolução de problemas em runtime.

🤝 Quando este plugin é útil

Se queres controlos de apresentação centralizados, animados e baseados em placeholders (titles, actionbars, tab-list e sidebars) geridos a partir da configuração em vez de código personalizado, o TitleManager fornece um plugin e uma API documentados para entregar esses elementos de UI de forma consistente em todo o ambiente do teu servidor.