Minecraft Servers HQ

Minecraftプラグイン EssentialsDiscord

EssentialsDiscord と確認されたサーバーの情報

SocialPaperAdmin ToolsModerationPermissionsUtilityChatIntegrationManagementDeveloper API

🔌 EssentialsX Discord について

EssentialsX Discord（EssentialsDiscord モジュールとして配布）は、Minecraft サーバーと Discord サーバーを連携させる EssentialsX の公式モジュールです。コアの EssentialsX モジュールと並んでプラグイン JAR として動作し、設定済みの bot トークンを使って Discord に接続し、チャットやイベントを中継しつつ、小さな API を通じた Discord 側のやり取りを提供します。

🎯 目的

このモジュールの主な目的は 2 つです。選択した Minecraft のチャット/イベントを Discord チャンネルへ中継し、選択した Discord のメッセージ/コマンドを Minecraft サーバーへ中継します。Discord と EssentialsX ベースの Minecraft サーバーの間で、直接的で設定可能な通信と、限定的なリモート操作を求めるサーバー管理者向けです。

⚙️ 機能

  • メッセージ種別ごとに設定できるチャンネル割り当て（チャット、参加/退出、スタッフなど）。
  • Minecraft のチャットを Discord へ中継し、必要に応じて Discord のメッセージを Minecraft チャットへ中継。
  • Discord 側のスラッシュコマンドで、コンソールコマンドの実行、プレイヤーへのメッセージ送信、プレイヤー一覧の表示が可能（設定可能で、ロールによる制限あり）。
  • 細かく分かれたメッセージ種別システムと、プラグイン設定で定義される種別ごとの書式設定。
  • 提供される DiscordService API を通じて、カスタムメッセージ種別や Discord インタラクションコマンドを登録できる開発者向け API。

🧩 対象ユーザー

  • Discord ↔ Minecraft のチャット同期をしたい EssentialsX を使っているサーバーオーナー。
  • ゲーム内スタッフとプライベートなスタッフチャンネルをつなげたい運営チーム。
  • Discord へのシンプルなやり取りや独自メッセージフックを公開したいプラグイン開発者。

🏗️ 利用例

  • グローバルチャットを専用の Discord チャンネルへ送信しつつ、スタッフ専用の Discord メッセージをゲーム内スタッフへ送る。
  • 確認済みの Discord ロールに、公開せずに設定済みのサーバー問い合わせやコマンドをスラッシュコマンドで実行させる。
  • 別のプラグインが EssentialsX Discord API にカスタムメッセージ種別を登録し、構造化された通知を Discord へ送る。

⌨️ コマンド

EssentialsX Discord は、通常の Minecraft チャットコマンドではなく、設定可能な Discord 側のスラッシュコマンド（Discord に登録されるもの）を提供します。これらのコマンド（公式ドキュメントに例あり）は Discord から実行され、コンソールコマンドの実行、プレイヤーへのメッセージ送信、プレイヤー一覧の表示ができます。コマンドの利用可否や上位機能は、プラグイン設定内のロール/ID 設定で制御されます。

🔐 権限

権限説明既定
essentials.discord.receive.<channel>指定した Discord チャンネルから中継されたメッセージをプレイヤーが受信できるようにします。未指定
essentials.discord.markdownMarkdown フィルターを回避し、Minecraft のメッセージが Discord に送られる際に書式を保持できるようにします。未指定
essentials.discord.pingping フィルターを回避し、Minecraft から @everyone/@here/ロールをメッセージでメンションできるようにします。未指定

⚙️ インストール

📥 セットアップ

  • EssentialsX Discord モジュールの JAR をダウンロードし、コアの EssentialsX JAR と一緒にサーバーの plugins/ ディレクトリへ配置します。
  • サーバーを起動してモジュールの設定を生成し、その後サーバーを停止します。
  • plugins/EssentialsDiscord/config.yml に bot トークン、チャンネル ID、メッセージ種別、コマンドロール設定をドキュメント通りに設定し、再起動します。

📦 依存関係

  • EssentialsX (core) — モジュールは EssentialsX プラグイン群のアドオンとして動作します。

🧠 技術メモ

  • このモジュールは、他のプラグインがカスタムメッセージ種別を登録し、設定済みの Discord チャンネルへメッセージを送信するためのサービス API（DiscordService）を提供します。
  • Discord 側のコマンドは、標準の Minecraft 権限ノードではなく、プラグイン設定で指定されたロール/ID によって制御されます。
  • bot トークン、チャンネル ID、メッセージ書式、コマンドのロール ID などの管理者向け設定は、初回起動時に作成されるモジュール設定ファイルで行います。

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

Discord コミュニティと EssentialsX ベースの Minecraft サーバーの間で、ロール制限付きの Discord コマンドや開発者向けフックを含む、管理された設定可能な双方向通信が必要な場合、EssentialsX Discord はメッセージの割り当てと連携用の小さな API を扱う特化モジュールを提供します。

プラグイン EssentialsDiscord のサーバー

プラグイン EssentialsDiscord のページには、モニタリングがこのプラグインを確認したサーバー、使用されているプラットフォームとバージョンが表示されます。

プラグインはコマンド、経済、保護、アクセス権、ミニゲーム、連携、その他のメカニクスを追加できます。EssentialsDiscord の実際の役割はサーバーごとの設定によります。

データはサーバーの技術応答から自動生成されます。サーバーがプラグイン一覧を非公開にしている場合、EssentialsDiscord を使用していてもこのセクションに表示されないことがあります。

EssentialsDiscord を使用するサーバーの一覧を使って、プロジェクトを比較したり、対応バージョンを確認したり、公開サーバーでのプラグイン使用例を見つけたりできます。