2026.11.19広告・PRを含む記事です

マイクラのチャットをDiscordへ送る!DiscordSRVの導入方法

ノートパソコンのキーボードで文字を入力する手元の実写写真を背景にした、Discordとマイクラのテキストチャットを連携する記事の見出し。
  • マイクラサーバーのチャットをDiscordにも流したい
  • ゲームに入っていないメンバーとも話せるようにしたい
  • メンバーの参加・退出・死亡をDiscordでも把握したい

DiscordSRVの設定で詰まりやすいのは、BotトークンとチャンネルIDをどこから取得してどこに書くかがわかりにくい点です。

手順通りに進めれば、Bot作成からチャット連携の動作確認まで一度で完結する構成です。

Botの作成から、つながらないときの確認まで順に進みます。

  • Botを作ってトークンを取得する
  • DiscordSRVをサーバーに導入する
  • config.ymlにBotTokenとChannelsを設定する
  • 動作確認と動かないときの確認方法

読み終わると、マイクラのチャットとDiscordが双方向につながり、ゲーム外のメンバーともやり取りできるようになります。

管理人spaのアイコン
この記事を書いた人spa

マイクラサーバーの構築と運用を繰り返して4年。今もマイクラサーバー「spa77 Network」を運用中で、その経験をもとに記事100本以上を執筆。

DiscordSRV(ディスコードSRV)とは?

DiscordSRVの連携構造。マイクラサーバー、DiscordSRV、Discordチャンネルの間でBotToken、Channels、Bot権限をそろえてチャット連携する流れを示す図解

DiscordSRV(ディスコードSRV)は、マイクラサーバーとDiscordサーバーのチャットを双方向につなぐプラグインです。

導入すると、次のような連携が使えます。

  • ゲーム内のチャットをDiscordに表示
  • Discordのチャットをゲーム内に表示
  • プレイヤーの参加や退出、死亡通知をDiscordに送信
  • Discordからサーバーコンソールのコマンドを実行

ゲームに入っていない人にもチャットが届くため、サーバー内の交流が途切れにくいのが利点です。

▼準備物の確認は後回しでいい、手順から始めたい人は、ここから導入6ステップへ飛んでください▼

DiscordSRVを導入する前に必要なもの

DiscordSRVを入れる前に、次のものを用意しておきます。

必要なもの理由
PaperやSpigotなどのJava版プラグイン対応サーバーDiscordSRVはプラグインとして導入するため
Discordサーバーの管理権限Botをサーバーに招待するため
DiscordアカウントDeveloper PortalでBotを作るため
サーバーフォルダを編集できる環境pluginsフォルダにjarを入れるため
連携用のDiscordテキストチャンネルチャット連携先として使うため

DiscordSRVはPaperやSpigotなどのプラグインサーバー専用です。Forge、Fabric、NeoForge単体のMODサーバーには導入できません。

どれを使うか迷っているなら、Paperサーバーを選びます。

プラグイン対応で情報も多く、詰まったときに調べやすいです。

まだプラグイン対応サーバーを用意していないなら、DiscordSRVの設定に入る前にサーバー選びを先に決めます。

状況選び方
これからPaperサーバーを作るプラグイン対応のレンタルサーバーを選ぶか、Paperでプラグインサーバーを立てる
友達2〜4人の少人数で始めるConoHa for GAMEの4GB前後を候補にする
5人以上・公開サーバー寄りで運営するXServer GAMEsの8GB前後も候補にする
MODやプラグイン導入の簡単さを重視するロリポップ! for Gamersも比較する

プラグインの設置で詰まらず、今夜からDiscordとゲームの会話をつなげられます

ConoHaでプラグイン対応プランを見る

プラグインの設置で詰まらず、今夜からDiscordとゲームの会話をつなげられます

ロリポップでプラグイン対応プランを見る

プラグイン対応サーバーの違いがわからない場合は、先にサーバーソフト比較を確認しておくと迷いにくいです。

DiscordSRVを導入する6ステップ

DiscordSRVの導入は、プラグインの配置に加えてDiscord側の設定も必要です。

チャット連携を動かすところまで順に進めます。

  • プラグインのダウンロード
  • Discordボットの作成
  • DiscordサーバーにBotを追加
  • チャンネルIDの取得
  • プラグインの設定
  • DiscordSRVの動作確認をする

上から順に進めます。

プラグインのダウンロード

SpigotMCのDiscordSRVページにあるDownload Nowボタンの部分拡大。Via external siteと表示されている

画像は、配布ページ右上の「Download Now」ボタンの部分拡大です。

SpigotMCのDiscordSRVページにアクセスし、最新版の.jarファイルをダウンロードします。

対応バージョンは配布ページで確認し、基本的には最新版が推奨です。

ダウンロードしたファイルをサーバーのpluginsフォルダに入れ、一度サーバーを再起動します。

再起動すると、次のステップで使う設定ファイルがplugins/DiscordSRV/内に自動生成されます。

プラグインの入れ方そのものに不安があるなら、先にプラグインの基礎記事を読んでください。

雪が積もった斜面と針葉樹の実ゲーム映像を背景にした、サーバープラグインとMODの違いを説明する記事見出し。

マイクラサーバーのプラグインとは?MODとの違いと基本の入れ方を解説!

Discordボットの作成

続いて、Discordと連携するためのBotを作成します。

作業はDiscord Developer Portalで行います。

Discord Developer Portalにログインする

Discord Developer Portalにアクセスし、ログイン画面が出てきたら持っているDiscordアカウントでログインします。

補足

Developer Portalは、Discordと連携するサービスを作るための開発者用ダッシュボードです。

新しいアプリケーションを作成する

右上の「New Application」をクリックすると、アプリケーションの名前を決める画面が表示されます。

アプリケーションに好きな名前を付けたら「Create」を押すだけです。

名前はサーバー名などあとから見てわかるものにしておくと、Botが増えたときに迷いません。

INTENTを追加する

変更前のDiscordボット設定画面。赤枠内のSERVER MEMBERS INTENTとMESSAGE CONTENT INTENTはどちらもオフ

画像は変更前で、赤枠内の2項目はどちらもオフです。

左側のメニューから「Bot」を選び、次の2項目をオンにします。

  • 「SERVER MEMBERS INTENT」
  • 「MESSAGE CONTENT INTENT」

変更を保存したあと、Botの設定画面を開き直して両方がオンになっていることを確認してください。

この設定を忘れると、BotがDiscordの発言内容を取得できず、Discordからマイクラへのチャット連携が動きません。一番見落としやすい設定箇所です。

トークンを発行する

Discordとの認証に使うトークンを発行するため、左側のメニューから「Bot」を選択します。

DiscordのBotページにあるReset Tokenボタンの部分拡大。赤枠と矢印で示され、トークン本体は表示されていない

画像はBotページのTOKEN欄にある「Reset Token」ボタンです。

トークン本体は表示されていません。

ここでは新規作成したBotを使います。

稼働中のBotでトークンを再生成すると、古いトークンを使う連携が動かなくなることがあります。

再生成が必要な場合は、利用先の設定も新しいトークンへ更新してください。

「Reset Token」をクリックし、表示されたトークンをコピーします。

BotTokenはBotを操作するための認証キーです。絶対に公開チャンネルや知人に漏らさないでください。

もし誤って外部に公開してしまった場合は、ただちに「Reset Token」で再生成してください。

DiscordサーバーにBotを追加

作成したBotを、Discordサーバーへ追加する工程です。

  • Discord Botに権限を与える
  • Botをサーバーに追加する

Discord Botに権限を与える

Developer Portalの左側メニューから「OAuth2」をクリックします。

補足

OAuth2は、BotをDiscordサーバーに追加するための認証設定ページです。

「URL Generator」までスクロールします。

「SCOPES」の中からbotにチェックを入れます。

下の画像のようになっていればOKです。

DiscordのOAuth2設定にあるスコープ欄の部分拡大。botにチェックが入っている

下に表示される「BOT PERMISSIONS」で、Botに必要な権限を付与します。

必要な権限は、DiscordSRVで使う機能によって変わります。

下の図は、通常のテキストチャンネルで表示・送信と埋込を使う場合の確認事項です。

DiscordSRVでチャンネルの表示と送信、埋込利用時の権限を分けて確認する図

  • View Channels(チャンネルを見る)
  • Send Messages(メッセージを送る)
  • Embed Links(埋め込みを使う)

View ChannelとSend Messagesは対象チャンネルでの表示・送信に必要です。

Embed Linksは埋込メッセージを使う場合に必要になります。

ほかの機能を使う場合は追加の権限を確認し、チャンネル側の権限設定で拒否されていないかも確認してください。

Administratorを付ける代わりに、使用する機能に必要な権限を個別に指定できます。

詳しい注意点は後述します。

Botをサーバーに追加する

生成されたURLをコピーしてブラウザで開くと、Botを追加するサーバー選択画面が表示されます。

Botを追加したいサーバーを選ぶのが次の手順です。

そのまま「はい」をクリックします。

「認証」と進むと、指定したサーバーにDiscord Botが入ります。

補足

サーバーにBotを招待するには、対象Discordサーバーの「サーバー管理」権限を持つアカウントで操作する必要があります。

チャンネルIDの取得

ここから、Discord Botとマイクラサーバーを連携する作業に入ります。

チャンネルIDをコピーするには、Discordの設定で開発者モードをオンにしておく必要があります。

取得したIDはあとでconfig.ymlへ貼り付けるので、メモ帳などに控えておいてください。

開発者モードの有効化

マイクラサーバーと連携するには、対象のテキストチャンネルIDが必要です。

Discordの設定から開発者モードを有効にすることで、チャンネルIDをコピーできるようになります。

  1. Discord左下の歯車マーク(ユーザー設定)を開く
  2. 左メニュー「アプリの設定」から「詳細設定」を選ぶ
  3. 「開発者モード」のトグルをオンにする

画像のようになっていれば完了です。

Discordの詳細設定で開発者モードをオンにするトグルが表示されている

これで、チャンネルIDをコピーできる状態になります。

補足

開発者モードは固有IDを右クリックでコピーできるようにする表示機能で、有効にしてもアカウント情報は漏れません。

チャンネルIDの取得

連携させたいテキストチャンネルの上で右クリックし、IDを取得します。

出てきた「チャンネルIDをコピー」をクリックすると、クリップボードにチャンネルIDが入ります。

Discordのメニューで「チャンネルIDをコピー」が選択されている

プラグインの設定

DiscordSRVのconfig.ymlでBotTokenにボットトークンを入力する箇所を示した画面

プラグインを導入した状態でサーバーを再起動すると、プラグインフォルダ内にDiscordSRVというフォルダが自動生成されます。

その中にあるconfig.ymlをテキストエディタ(メモ帳など)で開きます。

DiscordSRVの初期設定で最低限必要なのは、BotTokenとChannelsの2つです。

以下の項目を見つけて、それぞれ編集します。

項目説明
BotTokenDiscord Developer Portalで取得したBotのトークンを貼り付けます。
Channelsglobalの値を、DiscordでコピーしたチャンネルIDに書き換えます。

Channelsは、以下のように変更します。

# 変更前
Channels: {"global": "000000000000000000"}
# 変更後(コピーしたチャンネルIDに書き換える)
Channels: {"global": "コピーしたチャンネルID"}

このglobalはDiscordのチャンネル名ではなく、DiscordSRV側のマイクラチャンネル名です。

通常はglobalの名称を触る必要はありません。

右側の"コピーしたチャンネルID"だけを書き換えます。

設定が終わったら、ファイルを上書き保存してサーバーを再起動します。

続いて、ゲーム内とDiscordの間でメッセージが送受信できるか動作確認を行いましょう。

DiscordSRVの動作確認をする

設定が反映されたら、次の2点を確認します。

  • Discordの連携チャンネルで発言した内容が、マイクラのゲーム内に届くか
  • マイクラのゲーム内でチャットした内容が、Discordの連携チャンネルに転送されるか

両方のチャットが正しく表示されれば、双方向の連携は成功です。

マイクラサーバーからDiscordサーバー

マイクラサーバーにチャットを送ると、Discordではこんなメッセージになります。

マイクラサーバーから送信したチャットメッセージがDiscordチャンネルに転送されている様子。プレイヤー名とメッセージが表示されている

隠している箇所には、マイクラのID(MCID)が表示されます。

ちゃんと、マイクラサーバーからDiscordサーバーへ、チャットが転送されました。

Discordサーバーからマイクラサーバー

逆に、Discordサーバーにメッセージを送ると、マイクラサーバー上ではこんな感じになります。

Discordサーバーから送信したメッセージがマイクラサーバーのチャットに表示されている様子。Discordユーザー名とメッセージ内容が表示されている

Discordの名前が表示されるため、誰からのメッセージかひと目でわかります。

これでマイクラサーバーとDiscordのチャット連携がすべてつながりました。

僕もマイクラに参加していない時間でも会話が続くようになって、サーバーのコミュニティが途切れにくくなったと感じています。

spa

マイクラを起動していない日も、Discordからゲーム内の友達に返事できるので、会話が止まりません。

DiscordSRVが動かないときの原因と対処法

DiscordSRVが動かないときに確認する4項目。BotToken、MESSAGE CONTENT INTENT、ChannelsのチャンネルID、Bot権限を順番に確認する図解

DiscordSRVを設定しても動かないときは、次の項目を確認します。

どこから見ればいいか迷ったら、表の上から順番に確認すればOKです。

症状確認すること
BotがオンラインにならないBotTokenが正しいか、サーバー再起動済みか、コンソールにエラーが出ていないか
Discordの発言がマイクラに出ないMESSAGE CONTENT INTENTがONか、Botにチャンネル閲覧・送信権限があるか
マイクラの発言がDiscordに出ないChannels: {"global": "チャンネルID"}のIDが正しいか
起動通知だけ出てチャットが出ないChannelsの書き方、チャット系プラグインとの連携設定を確認
コンソール連携が見えないDiscordConsoleChannelIdに別チャンネルのIDを入れているか
Webhook表示にならないExperiment_WebhookChatMessageDelivery: trueに変更後、再起動したか

特に多い原因は、Developer PortalでのMESSAGE CONTENT INTENTの入れ忘れと、チャンネルIDの貼り間違いです。

spa

BotはオンラインなのにDiscordの発言だけマイクラに流れないときは、INTENTのチェック、チャンネルID、Botのチャンネル閲覧権限の順に見ていくよ。

起動ログにConfig key ... is missing from the messages.ymlという警告が並ぶこともあります。

spa

僕が運用しているサーバーでは、起動ログにmessages.ymlの複数キー未設定の警告が出ていました。

DiscordSRVのmessages.ymlで不足キーと既定値の使用を確認し、修正時は停止と保全の後に同じ版の設定を比べる図

補足

この警告は、messages.ymlにないキーをプラグイン側の既定値で補うことを示します。

ログの続きにあるUsing the default valueを読み、表示が意図した文言になっているかを確認しましょう。

修正する場合は、サーバーを停止してmessages.ymlを退避し、使用中のDiscordSRVと同じ版の既定設定を比べます。

既存ファイルを削除せず、変更済みの文言を残して必要な項目を補います。保存して起動した後にログと表示を確認してください。

チャット系プラグインを入れている場合は、DiscordSRV側で追加設定が必要になります。

LunaChatでローマ字を日本語に変換しているなら、config.ymlのDisabledPluginHooksにLunaChatを足して、Discordへの二重送信を防ぎます。

LunaChat側の設定は、おすすめプラグインのLunaChatの項にまとめました。

DiscordSRVの追加設定

DiscordSRVには、追加で設定できる機能が4つあります。

  • コンソール連携
  • 招待リンクの設定
  • チャットの装飾(Webhook)
  • 参加・退出・死亡通知の表示と文言の変更

コンソール連携

DiscordSRVのコンソール連携で管理者専用チャンネルを用意し、停止と保全の後にDiscordConsoleChannelIdへ数字のIDを設定して起動後に確認する図

Discordからサーバーのコンソールを監視し、コマンドを実行できるようにする機能です。

チャット連携だけ使いたい場合、この設定は飛ばして大丈夫です。

先に、チャット用とは別の管理者専用チャンネルを用意し、一般メンバーが閲覧・発言できないことを確認します。

Botには連携に必要な権限を残してください。

続いてマイクラサーバーを停止し、config.ymlを退避してから編集します。

DiscordConsoleChannelIdの値には、専用チャンネルの数字のIDを指定してください。

チャンネル名ではありません。

コマンドの制限は、次の2項目も確認します。

  • DiscordConsoleChannelBlacklistedCommands:対象にするコマンドの一覧
  • DiscordConsoleChannelBlacklistActsAsWhitelist:trueなら許可リスト、falseなら禁止リスト

必要なコマンドだけを許可する設定にしておきましょう。

保存してサーバーを起動したら、指定したチャンネルにログが届くかを確認します。

コンソール連携は便利ですが、権限設定を間違えると危険です。

コンソールチャンネルへの発言は、設定で許可されたコマンドとしてサーバーのコンソール権限で実行されます。

一般メンバーにも発言を許すと、強力な操作をされるおそれがあります。Botに必要な権限を残したうえで、利用者の閲覧・発言権限は管理者だけに限定してください。

招待リンクの設定

ゲーム内で/discordコマンドを実行したときに、Discordサーバーへの招待リンクを表示する機能です。

まずDiscord側で招待リンクを作り、招待する相手に合わせて有効期限と使用回数を選んでコピーします。

マイクラサーバーを停止し、config.ymlを退避してから開いて、DiscordInviteLinkを探してください。

Discord招待リンクの期限と使用回数を選び、停止と保全の後にDiscordInviteLinkへ設定し、起動後にゲーム内の/discordコマンドで表示を確認する図

DiscordInviteLinkの値に、コピーした招待リンクを入れます。

ファイルを保存してサーバーを起動したら、ゲーム内で/discordを実行し、設定したリンクが表示されるかを確認しましょう。

期限切れや無効化で使えなくなった場合は、新しい招待リンクに差し替えます。

チャットの装飾(Webhook)

通常はBotがまとめて代理投稿する仕組みですが、Webhook(ウェブフック)を使うと、プレイヤー本人の見た目と名前でDiscordに直接投稿されるようになります。

プレイヤーごとのスキンアイコンが表示され、誰の発言か一目でわかる仕組みです。

Discord側でBotに対象チャンネルの「ウェブフックの管理」権限を与えたうえで、config.ymlの以下の項目をtrueに変更してサーバーを再起動してください。

Experiment_WebhookChatMessageDelivery: true

正常に反映されると、マイクラからの発言がアバター付きでDiscordに届きます。

Webhookを使ったチャット連携の結果。マイクラからのメッセージがDiscordでプレイヤーアバター付きで表示されている様子

参加・退出・死亡通知の表示と文言の変更

DiscordSRVは、プレイヤーの参加・初回参加・退出・死亡を、それぞれ別の通知としてDiscordに送っています。

通知の表示・非表示と文言は、config.ymlではなくplugins/DiscordSRV/messages.ymlで管理します。

該当する項目は次の4つです。

  • MinecraftPlayerJoinMessage(参加)
  • MinecraftPlayerFirstJoinMessage(初回参加)
  • MinecraftPlayerLeaveMessage(退出)
  • MinecraftPlayerDeathMessage(死亡)

たとえば退出通知だけを止めたい場合は、MinecraftPlayerLeaveMessageのEnabledをfalseに変更します。

MinecraftPlayerLeaveMessage:
Enabled: false

通知の文言を変えたい場合は、各項目のEmbedの中にあるAuthorのNameを書き換えます。

Author:
Name: "%username% joined the server"

%username%はマイクラのプレイヤー名に置き換わるプレースホルダーなので、そのまま残して前後の文言だけを変える仕組みです。

編集したらmessages.ymlを保存し、サーバーを再起動すると反映されます。

アカウント連携で荒らしの入り直しを止める

Discordのアカウントは無料ですぐに作れるため、荒らしをBANしても、別のアカウントで入り直されます。

DiscordSRVのアカウント連携を使えば、マイクラのアカウントと連携した人にだけロールを付け、そのロールを持つ人にだけチャンネルを見せられます。

Java版のマイクラのアカウントは、ゲームを購入したMicrosoftアカウントが必要です。

Discordのアカウントのように、捨てては作り直すことができません。

spa

僕のサーバーのDiscordも、BANした荒らしに別のアカウントで何度も入り直され、マイクラでの認証を条件にする形へ切り替えました。

手順1:認証済みのロールにだけチャンネルを見せる

Discordで「認証済み」のようなロールを作り、チャンネルの権限を次のように分けます。

  • 認証案内のチャンネル:@everyoneに「チャンネルを見る」を許可する
  • ほかのチャンネル:@everyoneの「チャンネルを見る」を外し、認証済みのロールに「チャンネルを見る」「メッセージを送信」とボイスチャンネルの権限を許可する

チャンネルごとの権限の分け方は、ディスラボのDiscordの権限設定の手順で確認できます。

テスト用のアカウントでDiscordに入り、認証案内のチャンネルだけが見えれば設定は完了です。

手順2:連携した人にロールを付ける

マイクラサーバーを停止し、config.ymlのMinecraftDiscordAccountLinkedRoleNameToAddUserToに、手順1で作ったロールの名前かIDを書きます。

初期値は"Linked"です。

MinecraftDiscordAccountLinkedRoleNameToAddUserTo: "認証済み"

手順3:連携していない人の参加を断る

同じフォルダのlinking.ymlで、Require linked account to playのEnabledをtrueにします。

Require linked account to play:
Enabled: true

サーバーを起動すると、連携していない人はログインしようとした時点で、連携用のコードが書かれた画面とともに切断されます。

そのコードをDiscordのBotにDMで送れば連携が済み、手順2のロールが付きます。

linking.ymlのMust be in Discord serverは初期値がtrueで、Botと同じDiscordサーバーに参加していることも条件になります。

手順4:連携せずに入れる人がいないか確かめる

linking.ymlには、連携なしで入れる例外が2つあります。

  • Whitelisted players bypass check:初期値はtrueで、ホワイトリストに登録したプレイヤーは連携せずに入れる
  • Bypass names:初期値は[Scarsz, Vankka]で、DiscordSRVの開発者のプレイヤー名が入っている

全員に連携を求めるなら、Whitelisted players bypass checkをfalseに、Bypass namesを[]にしてください。

DiscordSRVが読み込みに失敗すると、連携の確認が行われず、連携していない人も参加できます。サーバーを起動したら、毎回ログでDiscordSRVが有効になっているかを確かめてください。

DiscordSRVを安全に使うための注意点

DiscordSRVは便利ですが、Botやコンソールの権限を広くしすぎると危険です。

  • BotにAdministrator権限を与えない
  • BotTokenはパスワードと同じ扱いで保管する
  • BotTokenを漏らしたら、Developer PortalでReset Tokenする
  • コンソール連携チャンネルは管理者だけが見られる場所にする
  • チャット連携チャンネルとコンソール連携チャンネルは分ける
  • 公開サーバーでは、Discord側のロール権限も合わせて見直す

Botに必要以上の権限を与えると、トークンが漏れたときの被害が大きくなります。

マイクラサーバー側のOP権限と同じ考え方で、必要な人に必要な権限だけを渡すのが基本方針です。

公開サーバーでDiscord連携を使うなら、荒らし対策も合わせて見直しておくと事故を減らせます。

草地のアイアンゴーレムを守りのイメージとして使い、荒らし対策・予防と復旧の見出しを重ねたサムネイル

マイクラの荒らし対策!サーバー・Realms・統合版の予防と復旧

よくある質問

QDiscordSRVのBotにAdministrator権限は必要ですか?
A

基本的に不要です。チャンネル閲覧、メッセージ送信、埋め込み、Webhookなど、使う機能に必要な権限だけを付けるほうが安全です。

Qコンソール連携チャンネルはチャット連携チャンネルと同じでいいですか?
A

おすすめしません。コンソール連携チャンネルはコマンド実行やログ閲覧ができるため、管理者だけが見られる別チャンネルにします。

まとめ:DiscordSRVでマイクラと連携しよう

DiscordSRVを入れると、マイクラとDiscordのチャットが双方向につながります。

Discordの連携チャンネルへの発言がゲーム内に届き、ゲーム内のチャットがDiscordへ転送されれば設定は完了です。

届かないときは、BotToken、Channels、INTENT、Bot権限の順で確認してください。

チャット以外の機能も足したいなら、おすすめプラグインの一覧に荒らし対策や権限管理から入れる順番が載っています。

DiscordSRVはPaperやSpigotでしか動かないため、バニラで立てたサーバーはPaperへ入れ替える作業から始まります。管理画面でPaperを選べるサーバーなら、その作業はいりません。

Paperの導入が管理画面の数クリックで終わり、今夜からDiscordとつなげられます

Discord連携しやすいプラグイン対応サーバーを確認する