Minecraftプラグイン TitleManager

🔌 TitleManager について

TitleManager は、Minecraft のプレイヤー向け表示要素を管理するプラグインです。アニメーション付きの中央タイトルとサブタイトル、actionbar、アニメーション対応の tab-list のヘッダーとフッター、そして設定可能なサイドバー scoreboard を扱えます。より洗練された参加メッセージ、アナウンス、ライブの tab/scoreboard 表示を行いたいサーバー向けのプレゼンテーション層として動作します。

🎯 目的

このプラグインは表示機能（titles、actionbars、tab-list、sidebars）を一元化し、サーバー運営者が独自開発なしで、一貫性のあるアニメーション付きの placeholder ベース情報をプレイヤーに提示できるようにします。参加/ウェルカムメッセージ、ローテーションするお知らせ、動的な TAB/scoreboard UI を管理したいサーバー管理者向けです。

⚙️ 特徴

• 参加時と初参加時の title と actionbar を、表示タイミングやバリエーション付きで設定可能。
• オンライン人数、ワールド/サーバー時間、その他の動的な値に対応する placeholder 付きの、アニメーション可能でグラデーション対応の tab-list ヘッダーとフッター。
• サーバーの scoreboard システムに支えられた、最大 15 行のアニメーション行を持つ設定可能なサイドバー scoreboard。
• title または actionbar として配信される broadcast と予約アナウンス。
• 再利用可能なアニメーションファイルとプレビューを備えたアニメーションエンジン（公式ドキュメントで animation playground が利用可能）。
• placeholder 連携（TitleManager 内蔵の placeholders と、存在する場合は外部 placeholder システムのサポート）。
• トランザクション方式の再読み込み: 設定の再読み込みは安全に適用され、新しい設定が無効な場合は元に戻せます。
• オプション連携やプラグイン間利用のための、小さな開発者向け API。

🧩 対象ユーザー

• 洗練された参加/アナウンス UI を求める Survival と SMP サーバー。
• 表示に動的な値を出すために placeholders や外部連携を使うサーバー。
• カスタムプラグインを書かずに、アニメーション付きの tab と scoreboard 表示が必要な管理者。
• 提供される API を使って他のプラグインに表示機能を組み込みたい開発者。

🏗️ 使用例

• プレイヤー参加時にアニメーション付きのウェルカム title と actionbar を表示し、初参加時は別メッセージにする。
• サーバー時間、オンライン人数、グラデーションのヘッダー/フッターを表示して tab のプレイヤー一覧を活気づける。
• イベントやルールを伝えるために、スケジュールに従ってアニメーション付きのお知らせ title や actionbar を切り替える。
• サイドバー scoreboard を使って、ランキング、統計、または動的なサーバー情報を表示する。

⌨️ コマンド

注: 上記のコマンドはプロジェクトでドキュメント化されています。ここで使用したソースには具体的な権限ノードは記載されていないため、正確なノードとデフォルト値はプラグインのドキュメントを参照してください。

⚙️ インストール

📥 セットアップ

• プロジェクトのリリース、またはプラグインのリソースページからプラグインの JAR をダウンロードします。
• JAR をサーバーの plugins/ ディレクトリに配置します。
• サーバーを再起動します。
• plugins/TitleManager/ に生成された設定ファイルを編集して、titles、アニメーション、player-list の設定を調整します。
• 設定変更の適用には /tm reload を使います。プラグインは壊れた設定を適用しないようトランザクション方式の再読み込みを行います。

📦 依存関係

• PlaceholderAPI（外部 placeholders のためのオプション連携）。
• Vault（オプション、存在する場合は placeholder 値に使用）。
• BungeeCord（プロキシ構成で使用した場合の連携対応動作）。

これらの連携は任意で、存在する場合にのみ使われます。プラグインはこれらがなくても動作しますが、利用可能な場合はそのデータを使用できます。

🧠 技術メモ

• 公式の実行対象は Minecraft 1.8 から 1.21.x までです（プロジェクト資料では 1.21.11 までの明示的なサポートが記載されています）。動作はサーバーのバージョンによって異なり、新しい Minecraft バージョンでは最新の Bukkit/Paper API を使用し、旧バージョンではバージョン別の互換モジュールに依存します。
• TitleManager はオプション連携向けに小さな Bukkit 向け API を公開し、生成された API ドキュメントも提供します。
• 設定や実行時のトラブルシュートを助けるために、安全な再読み込みと診断コマンドが用意されています。

🤝 このプラグインが役立つ場面

独自実装ではなく設定から管理できる、集中化されたアニメーション付き placeholder ベースの表示制御（titles、actionbars、tab-list、sidebars）を求めるなら、TitleManager はこれらの UI 要素をサーバー環境全体で一貫して提供するための、ドキュメント付きプラグインと API を備えています。