Minecraftプラグイン DiscordSRV

🔌 DiscordSRVについて

DiscordSRV は、Minecraft サーバーと Discord サーバーを接続する Minecraft プラグインです。ゲーム内チャットを Discord に転送し（Discord のメッセージをゲームにも転送）、Minecraft と Discord のアカウント連携をサポートし、ロール/グループやいくつかのサーバーイベントの同期フックを提供します。

🎯 目的

DiscordSRV の主な目的は、Minecraft サーバーと Discord の間に信頼性が高く、設定可能な橋渡しを提供することです。これにより、コミュニティは両方のプラットフォームでやり取りでき、スタッフに情報を共有し、設定に応じてメンバーシップ/ロール情報を同期できます。

⚙️ 機能

• Minecraft と Discord のチャンネル間で双方向チャット同期（チャンネルごとに設定可能）。
• プレイヤー向けの Minecraft <-> Discord アカウント連携。
• ロール/グループ同期のフック（LuckPerms などの権限プラグイン向けの統合ポイント）。
• Minecraft から Discord への放送メッセージとスタッフ向けメッセージ。
• 連携確認、リンク状態の確認、管理操作（reload、resync、debug）のコマンド。
• チャンネル割り当て、言語/メッセージ、同期、音声機能用の複数の設定ファイル。
• 公開 issue tracker とリリースを備えたオープンソースコード。

🧩 対象ユーザー

• Minecraft と Discord 全体でコミュニティチャットを統一したいサーバー所有者と管理者。
• Discord でサーバーイベントを把握したいモデレーションチーム。
• Discord とのロールまたはグループ同期を行いたい、権限プラグインを使うネットワーク。

🏗️ 使用例

• グローバルまたはチャンネルごとの Minecraft チャットを特定の Discord チャンネルに転送し、サーバー外のユーザーも会話を追えるようにする。
• プレイヤーアカウントを Discord ID に連携して、Discord ロールを付与したり、プラットフォーム間でユーザーを確認したりする。
• サーバーの参加/退出/コンソールログを Discord のモデレーションチャンネルに送信する。

⌨️ コマンド

プレイヤー用サブコマンド:

スタッフ用コマンド:

（旧サブスクリプションシステムに関連する廃止済みコマンドは履歴に記載されていますが、現在の動作からは削除されています。）

🔐 権限

⚙️ インストール

📥 セットアップ

• 公式配布（プロジェクトページ / カタログ / リリース）から DiscordSRV の公式 .jar をダウンロードします。
• jar を Bukkit/Spigot 対応サーバーの plugins/ フォルダに入れます。
• サーバーを再起動し、コンソールログで DiscordSRV が読み込まれたことを確認します。
• 生成された設定ファイルを使って初期設定（bot トークン、チャンネル割り当て、連携オプション）を完了します。

📦 設定ファイル

DiscordSRV は複数の設定ファイルを使用します。確認されているファイル名は次のとおりです。

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Discord の bot トークン、チャンネル割り当て、同期設定を行うために、適切なファイルを編集してください。一部の機能（ロール/グループ同期、音声連携）には追加設定が必要です。

🧠 技術メモ

• ソースコードとリリースは公開リポジトリで管理されています。
• このプロジェクトは GPL-3.0 で公開されています。
• 確認されている任意の統合先には LuckPerms（contexts/グループ同期）と PlaceholderAPI（placeholders）があります。
• コマンドと権限は公式ドキュメントに記載されています。resync や reload のような管理操作があり、オペレーター権限が必要な場合があります。

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

Minecraft サーバーと Discord コミュニティの間で、一貫した設定可能な双方向チャットとアカウント連携が必要なら、DiscordSRV はその橋渡し、統合フック、設定ファイルを提供し、一般的なサーバープラグインと連携しながらこれらの機能を運用できます。