Plugin Minecraft TitleManager

🔌 Sobre o TitleManager

TitleManager é um plugin de Minecraft que gerencia elementos de apresentação visíveis aos jogadores: títulos e subtítulos animados no centro da tela, actionbars, cabeçalhos e rodapés animados da lista de jogadores e um scoreboard lateral configurável. Ele 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 os recursos de exibição (titles, actionbars, tab-list, sidebars) para que os donos do servidor possam apresentar informações consistentes, animadas e baseadas em placeholders aos jogadores sem programação personalizada. Ele foi pensado para administradores que querem gerenciar 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, usando o sistema de scoreboard do servidor.
• Anúncios em broadcast e agendados entregues como titles ou actionbars.
• Motor de animação com arquivos de animação reutilizáveis e prévias (o playground de animação está disponível na documentação oficial).
• Integrações de placeholders (placeholders nativos do TitleManager e suporte a sistemas externos de placeholders quando presentes).
• Recargas transacionais: as recargas de configuração são aplicadas com segurança e podem ser revertidas se a nova configuração for inválida.
• Uma pequena API voltada para desenvolvedores para integrações opcionais e uso de plugin com plugin.

🧩 Para quem é

• Servidores Survival e SMP que querem uma UI de entrada/anúncio mais 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 do scoreboard sem escrever plugins personalizados.
• Desenvolvedores que querem integrar recursos de apresentação em outros plugins via a 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 player list da tab mais viva exibindo a hora do servidor, a contagem de jogadores online e cabeçalhos/rodapés com gradiente.
• Alternar titles ou actionbars de anúncios animados em um cronograma para comunicar eventos ou regras.
• Usar o scoreboard lateral para exibir rankings, estatísticas ou informações dinâmicas do servidor.

⌨️ Comandos

Notas: os comandos acima sã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 ver os nós exatos e os padrões.

⚙️ Instalação

📥 Configuração

• Baixe o JAR do plugin na release do projeto ou na página do recurso do plugin.
• Coloque o JAR no diretório plugins/ do seu servidor.
• Reinicie o servidor.
• Edite os arquivos de configuração gerados em plugins/TitleManager/ para ajustar títulos, animações e configurações da player list.
• Use /tm reload para aplicar as mudanças de configuração; o plugin faz recargas transacionais para evitar aplicar configs quebradas.

📦 Dependências

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

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

🧠 Notas técnicas

• Os alvos oficiais de runtime incluem Minecraft 1.8 até 1.21.x (o material do projeto cita suporte explícito até 1.21.11). O comportamento varia conforme a versão do servidor: as versões mais novas do Minecraft usam as APIs modernas do Bukkit/Paper, enquanto as versões legadas dependem de módulos de compatibilidade por versão.
• TitleManager publica 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 solução de problemas em runtime.

🤝 Quando este plugin é útil

Se você quer controles de apresentação centralizados, animados e baseados em placeholders (titles, actionbars, tab-list e sidebars) gerenciados pela configuração em vez de código feito sob medida, o TitleManager oferece um plugin e uma API documentados para entregar esses elementos de UI de forma consistente em todo o ambiente do seu servidor.