Plugin de Minecraft TitleManager

🔌 Acerca de TitleManager

TitleManager es un plugin de Minecraft que gestiona elementos de presentación visibles para los jugadores: títulos y subtítulos animados en el centro de la pantalla, actionbars, encabezados y pies de página animados de la lista de jugadores, y un scoreboard lateral configurable. Actúa como una capa de presentación para servidores que quieren mensajes de entrada más pulidos, anuncios y vistas en vivo de la tab/scoreboard.

🎯 Propósito

El plugin centraliza las funciones de visualización (titles, actionbars, tab-list, sidebars) para que los dueños del servidor puedan mostrar información coherente, animada y basada en placeholders a los jugadores sin programación personalizada. Está pensado para administradores que quieren gestionar mensajes de entrada/bienvenida, anuncios rotativos y una UI dinámica de TAB/scoreboard.

⚙️ Características

• Titles y actionbars configurables para la entrada y la primera entrada, con opciones de tiempo y variantes.
• Encabezado y pie de página de la lista de jugadores animados y con gradiente, con placeholders para recuentos de jugadores online, hora del mundo/servidor y otros valores dinámicos.
• Scoreboard lateral configurable con hasta 15 líneas animadas respaldadas por el sistema de scoreboard del servidor.
• Anuncios emitidos y programados entregados como titles o actionbars.
• Motor de animación con archivos de animación reutilizables y vistas previas (el playground de animación está disponible en la documentación oficial).
• Integraciones de placeholders (placeholders integrados de TitleManager y soporte para sistemas externos de placeholders cuando estén presentes).
• Recargas transaccionales: las recargas de configuración se aplican de forma segura y pueden revertirse si la nueva configuración no es válida.
• Una pequeña API orientada a desarrolladores para integraciones opcionales y uso entre plugins.

🧩 Para quién es

• Servidores Survival y SMP que quieren una UI de entrada/anuncio pulida.
• Servidores que usan placeholders e integraciones externas (para valores dinámicos en las vistas).
• Administradores que necesitan vistas animadas de la tab y del scoreboard sin escribir plugins personalizados.
• Desarrolladores que quieren integrar funciones de presentación en otros plugins mediante la API proporcionada.

🏗️ Casos de uso de ejemplo

• Mostrar un title de bienvenida animado y una actionbar cuando los jugadores se unen, con un mensaje diferente en la primera entrada.
• Mantener viva la lista de jugadores de la tab mostrando la hora del servidor, el recuento de jugadores online y encabezados/pies de página con gradiente.
• Alternar titles o actionbars de anuncios animados según un horario para comunicar eventos o reglas.
• Usar el scoreboard lateral para mostrar rankings, estadísticas o información dinámica del servidor.

⌨️ Comandos

Notas: los comandos anteriores están documentados por el proyecto. Los nodos de permiso específicos no se enumeraron en las fuentes usadas aquí y deben consultarse en la documentación del plugin para conocer los nodos exactos y los valores predeterminados.

⚙️ Instalación

📥 Configuración

• Descarga el JAR del plugin desde la release del proyecto o la página del recurso del plugin.
• Coloca el JAR en el directorio plugins/ de tu servidor.
• Reinicia el servidor.
• Edita los archivos de configuración generados en plugins/TitleManager/ para ajustar títulos, animaciones y ajustes de la lista de jugadores.
• Usa /tm reload para aplicar los cambios de configuración; el plugin realiza recargas transaccionales para evitar aplicar configuraciones dañadas.

📦 Dependencias

• PlaceholderAPI (integración opcional para placeholders externos).
• Vault (opcional, se usa para valores de placeholders cuando está presente).
• BungeeCord (comportamiento consciente de la integración cuando se usa en configuraciones de proxy).

Estas integraciones son opcionales y se usan cuando están presentes; el plugin funciona sin ellas, pero puede usar sus datos cuando están disponibles.

🧠 Notas técnicas

• Los objetivos oficiales de runtime incluyen Minecraft 1.8 hasta 1.21.x (el material del proyecto hace referencia a soporte explícito hasta 1.21.11). El comportamiento varía según la versión del servidor: las versiones más recientes de Minecraft usan las API modernas de Bukkit/Paper, mientras que las versiones heredadas dependen de módulos de compatibilidad por versión.
• TitleManager publica una pequeña API orientada a Bukkit para integraciones opcionales y proporciona documentación de API generada.
• Existen comandos de recarga segura y diagnósticos para ayudar con la configuración y la resolución de problemas en runtime.

🤝 Cuándo es útil este plugin

Si quieres controles de presentación centralizados, animados y basados en placeholders (titles, actionbars, tab-list y sidebars) gestionados desde la configuración en lugar de código a medida, TitleManager ofrece un plugin y una API documentados para entregar esos elementos de UI de forma consistente en todo tu servidor.