Minecraftプラグイン EssentialsDiscordLink

🔌 EssentialsX Discord Link について

EssentialsX Discord Link は、EssentialsX Discord 向けのアドオンモジュールで、Minecraft アカウントと Discord ロールのアカウント連携および同期を提供します。ユーザーの識別情報を紐づけたり、Vault のグループを Discord ロールへ（またはその逆へ）マッピングしたりする機能に重点を置き、EssentialsX の Discord 連携を拡張するよう設計されています。

🎯 目的

プレイヤーが Minecraft アカウントと Discord アカウントを簡単かつ保守しやすい方法で連携できるようにし、サーバーのグループ所属と Discord ロールを同期して保つことです。また、未連携のプレイヤーが連携完了まで参加や操作をできないように制限することもできます。

⚙️ 機能

• Vault グループ -> Discord ロールの同期（Vault のグループ名を Discord ロール ID にマップ）。
• Discord ロール -> Vault グループの同期（Discord ロール ID に基づいて Vault グループを割り当て）。
• 未連携のプレイヤーがサーバーに参加するのを防止。
• 未連携のプレイヤーが移動したりチャットを送信したりするのを、連携するまで防止。
• ゲーム内でのアカウント連携フローにより、Discord で使う短いコードを発行。
• 連携状態の確認、プレイヤーの連携/解除、連携データの取得を行う小さな開発者向け API。

🧩 対象ユーザー

• EssentialsX と EssentialsX Discord モジュールを使っていて、Discord アカウント連携が必要なサーバー。
• Vault グループを使っており、それらを Discord ロールとして反映させたいサーバー（またはその逆）。
• 参加確認済みの Discord メンバーシップやロール同期を必要とする Survival、SMP、コミュニティサーバー。

🏗️ 使用例

• プレイヤーが一致する Discord ロールを持っている場合に、Vault ベースの寄付者グループを自動付与する。
• 未連携プレイヤーが、ゲーム内の連携コードで Discord アカウントを確認するまで、チャットや移動をブロックする。
• 提供された API を使って、プレイヤーが連携済みかどうかをバックエンドのプラグインやスクリプトで問い合わせる。

⌨️ コマンド

⚙️ インストール

📥 セットアップ

• 公式の EssentialsX Discord Link の jar をダウンロードし、サーバーの plugins/ ディレクトリに配置します。
• サーバーを起動して、プラグインフォルダとデフォルト設定を生成します。
• plugins/EssentialsDiscordLink/config.yml のプラグイン設定を編集し、groups（Vault グループ -> Discord ロール ID）と roles（Discord ロール ID -> Vault グループ）を定義します。
• 設定を保存した後、EssentialsX コンソールの reload コマンド（例: ess reload）を実行するか、サーバーを再起動してロール同期設定を反映します。

📦 依存関係

• EssentialsX (core) — 必須（このモジュールは EssentialsX Discord のアドオンです）。
• EssentialsX Discord — 必須（このアドオンはこのモジュールを拡張します）。
• Vault — Vault グループ ↔ Discord ロール のマッピングに使用します（ロール同期機能で参照）。

🧠 技術メモ

• このプラグインは小さな開発者向け API（service）を公開しており、他のプラグインがプレイヤーの連携状態を確認したり、プログラムからプレイヤーを連携/解除したり、連携データを取得したりできます。
• 設定では plugins/EssentialsDiscordLink/config.yml を使って、Vault グループと Discord ロール ID の対応を管理します。

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

サーバーですでに EssentialsX を使っていて、プレイヤーに Discord アカウントの確認や連携をさせたい場合、または Vault グループと Discord ロールを同期したい場合に、EssentialsX Discord Link は EssentialsX モジュールのエコシステム内で動作する、直接的でドキュメント化された統合を提供します。