Minecraft plugin TitleManager

🔌 About TitleManager

TitleManager is a Minecraft plugin that manages player-facing presentation elements: animated mid-screen titles and subtitles, actionbars, animated tab-list headers and footers, and a configurable sidebar scoreboard. It acts as a presentation layer for servers that want more polished join messages, announcements, and live tab/scoreboard displays.

🎯 Purpose

The plugin centralizes display features (titles, actionbars, tab-list, sidebars) so server owners can present consistent, animated, placeholder-driven information to players without custom coding. It is intended for server administrators who want to manage join/welcome messages, rotating announcements, and a dynamic TAB/scoreboard UI.

⚙️ Features

• Configurable join and first-join titles and actionbars with timing options and variants.
• Animated and gradient-capable tab-list header and footer with placeholders for online counts, world/server time, and other dynamic values.
• Configurable sidebar scoreboard with up to 15 animated lines backed by the server scoreboard system.
• Broadcasts and scheduled announcements delivered as titles or actionbars.
• Animation engine with reusable animation files and previews (animation playground available in the official docs).
• Placeholder integrations (built-in TitleManager placeholders and support for external placeholder systems when present).
• Transactional reloads: configuration reloads are applied safely and can revert if the new config is invalid.
• A small developer-facing API for optional integrations and plugin-to-plugin usage.

🧩 Who It Is For

• Survival and SMP servers that want polished join/announcement UI.
• Servers using placeholders and external integrations (for dynamic values in displays).
• Administrators who need animated tab and scoreboard displays without writing custom plugins.
• Developers who want to integrate presentation features into other plugins via the provided API.

🏗️ Example Use Cases

• Show an animated welcome title and actionbar when players join, with a different message on first join.
• Keep the tab player list lively by showing server time, online counts, and gradient headers/footers.
• Rotate animated announcement titles or actionbars on a schedule to communicate events or rules.
• Use the sidebar scoreboard to display leaderboards, stats, or dynamic server information.

⌨️ Commands

Notes: the commands above are documented by the project. Specific permission nodes were not listed in the sources used here and should be consulted in the plugin documentation for exact nodes and defaults.

⚙️ Installation

📥 Setup

• Download the plugin JAR from the project's release or the plugin resource page.
• Place the JAR in your server plugins/ directory.
• Restart the server.
• Edit the generated config files under plugins/TitleManager/ to adjust titles, animations, and player-list settings.
• Use /tm reload to apply configuration changes; the plugin performs transactional reloads to avoid applying broken configs.

📦 Dependencies

• PlaceholderAPI (optional integration for external placeholders).
• Vault (optional, used for placeholder values when present).
• BungeeCord (integration-aware behavior when used in proxy setups).

These integrations are optional and used when present; the plugin runs without them but can use their data when available.

🧠 Technical Notes

• Official runtime targets include Minecraft 1.8 through 1.21.x (project material references explicit support through 1.21.11). Behavior varies by server version: newer Minecraft versions use modern Bukkit/Paper APIs while legacy versions rely on per-version compatibility modules.
• TitleManager publishes a small Bukkit-facing API for optional integrations and provides generated API docs.
• Safe reload and diagnostics commands exist to help with configuration and runtime troubleshooting.

🤝 When This Plugin Is Useful

If you want centralized, animated, and placeholder-driven presentation controls (titles, actionbars, tab-list, and sidebars) managed from configuration rather than bespoke code, TitleManager provides a documented plugin and API to deliver those UI elements consistently across your server environment.