Minecraftプラグイン DeathMessages

🔌 DeathMessages について

DeathMessages は、Minecraft のゲーム内にあるデフォルトの死亡メッセージを置き換えたりカスタマイズしたりするための Minecraft プラグインです。プレイヤー、Mob、テイム可能なMob、自然死向けの設定可能なメッセージテンプレートを読み込み、バニラの文字列ではなくテキストコンポーネントのメッセージ（ホバー/クリックコンポーネント付き）を配信します。

🎯 目的

このプラグインは、サーバー管理者が死亡情報の表示方法を制御できるようにするためのものです。文言の変更、プレースホルダーの利用、色やホバー/クリック情報の追加、ワールドやリージョンごとの配信制限、他のサーバーシステム（プレースホルダー、Discord、MythicMobs）との連携ができます。

⚙️ 機能

• バニラの死亡メッセージを設定可能なテンプレートで完全置換。
• テキストコンポーネント（ホバーテキスト、クリック操作）と16進カラーコードに対応。
• ダメージタイプごとに多数のカスタマイズ可能なメッセージを持つ複数の設定ファイル。
• ワールドごとのメッセージと無効化ワールドの一覧。
• 有効時に、特定の死亡メッセージ種類（プレイヤー、Mob、自然、テイム可能）を抑制する WorldGuard のリージョンフラグ。
• PlaceholderAPI 連携: 被害者、キラー、プラグイン状態向けのプレースホルダーを公開。
• MythicMobs と DiscordSRV のオプションフック（設定ベース）。
• Bungee/Proxy によるグローバルメッセージ対応。
• API イベント（BroadcastDeathMessageEvent、BroadcastTameableDeathMessageEvent）を発行し、PlayerManager ユーティリティクラスを提供。
• 設定可能なイベント優先度と、複数Mobの倒しで使える gang-kill 検出。

🧩 対象ユーザー

• カスタムまたはテーマ性のある死亡メッセージを使いたい Survival / SMP サーバー。
• プレースホルダーや外部システム（DiscordSRV、MythicMobs）を使い、一貫したメッセージ形式が必要なサーバー。
• ワールド単位またはリージョン単位でメッセージ配信を制御したいサーバー。

🏗️ 使用例

• デフォルトの死亡メッセージを、16進カラーとホバーテキストを使ったテーマ性のあるロールプレイ風メッセージに置き換える。
• 死亡テンプレート内で PlaceholderAPI の値（被害者名、キラー名、最終位置）を使う。
• WorldGuard で保護されたリージョン内で死亡メッセージが表示されないようにする。
• DiscordSRV のフック経由で死亡イベントを Discord チャンネルへ送信する。

⌨️ コマンド

🔐 権限

⚙️ インストール

📥 セットアップ

• 公式プラグインの .jar をダウンロードし、サーバーの plugins/ フォルダに配置します。
• サーバーを再起動し、コンソールログでプラグインが読み込まれたことを確認します。
• プラグインページでは、Spigot より Paper が推奨されています。

📦 依存関係

• 作者が挙げているオプション連携: PlaceholderAPI、WorldGuard、MythicMobs、DiscordSRV。これらはオプションのフックであり、基本的なメッセージ置換には必須ではありません。

🧠 技術メモ

• このプラグインは API イベント（BroadcastDeathMessageEvent と BroadcastTameableDeathMessageEvent）を公開し、プラグイン作者向けに PlayerManager ユーティリティを提供します。
• イベント優先度は設定で変更可能で、選択した PlayerDeathEvent 優先度で動作できます。
• 複数の Minecraft メジャーバージョンに対応しており、公式リソースページでは 1.12 から 1.21 まで明示的にテストされています。

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

死亡情報の表示方法を正確に制御したい場合（カスタム文言、プレースホルダー、ワールド/リージョンごとのルール、各種連携）、DeathMessages は設定可能なテンプレートとフックを提供しつつ、さらなる拡張のためのイベントも公開します。