Skip to content

Installation

Jump to bottom
PIARIS edited this page Jul 9, 2026 · 2 revisions

Installation

DiscordBridgeJP の導入手順です。Discord Bot の作成から、サーバーへの設置・初期設定までを順番に説明します。

必要なもの

  • Paper または Purpur 1.21.8 以降(26.1.x系含む)
  • Discordサーバー(ギルド)の管理権限
  • Discord Developer Portal にログインできるDiscordアカウント

1. Discord Botを作成する

  1. Discord Developer Portal にアクセスし、「New Application」から新しいアプリケーションを作成します。名前は何でも構いません(例: ピア鯖Bot)。
  2. 左メニューの「Bot」を開き、「Reset Token」(初回は「Add Bot」)からBotを作成し、トークンをコピーしておきます。このトークンは絶対に公開しないでください。 誤って公開してしまった場合は、すぐにこの画面から再発行してください。
  3. 同じ「Bot」ページ内の「Privileged Gateway Intents」で、以下2つを必ずONにしてください。
    • MESSAGE CONTENT INTENT: OFFだとチャット中継・コマンド実行ができません。
    • SERVER MEMBERS INTENT: OFFだとDiscordサーバー離脱検知機能が動作しません(Botの接続自体が失敗することがあります)。

2. Botをサーバーに招待する

  1. 左メニューの「OAuth2」→「URL Generator」を開きます。

  2. 「SCOPES」で bot にチェックを入れます。

  3. 「BOT PERMISSIONS」で以下にチェックを入れます。

    • View Channels(チャンネルを見る)
    • Send Messages(メッセージを送信)
    • Manage Messages(コード入力メッセージの自動削除を使う場合)
    • Manage Webhooks(チャット中継のWebhook表示に必須)
    • Read Message History
    • Add Reactions(コンソールコマンド実行時の✅表示)
    • Embed Links
    • Ban Members(BAN同期を使う場合)
    • Moderate Members(Discord側タイムアウト機能との連携を使う場合)

  4. ページ下部に生成されたURLをコピーし、ブラウザで開いてBotを導入したいDiscordサーバーに招待します。

3. チャンネルIDを確認する

DiscordBridgeJPは複数のチャンネルをIDで指定します。IDをコピーするには、Discordの「ユーザー設定」→「詳細設定」で開発者モードをONにし、対象のチャンネルを右クリック→「IDをコピー」で取得します。

最低限、以下のチャンネルを用意してIDを控えておいてください。

  • チャット中継チャンネル: MinecraftとDiscordのチャットを中継するチャンネル
  • コンソールチャンネル: サーバーログの中継、Discordからのコマンド実行に使うチャンネル
  • 連携用チャンネル: アカウント連携コード(!XXXXXXXX)を貼ってもらうチャンネル
  • (任意)コマンドログ専用チャンネル: 一般プレイヤーが実行したコマンドのみを記録したい場合

guild-id(サーバー自体のID)も同様に、サーバーアイコンを右クリックして取得できます。

4. プラグインを設置する

  1. ビルドした(またはModrinthからダウンロードした)DiscordBridgeJP.jar をサーバーの plugins フォルダに置きます。
  2. 一度サーバーを起動し、plugins/DiscordBridgeJP/ フォルダに config.yml ・ bot.yml ・ messages.yml ・ lang/ が自動生成されることを確認します。
  3. サーバーを停止します。

過去のバージョン(1.0.x系)からアップデートする場合は、bot-tokenや各チャンネルIDがconfig.ymlからbot.ymlへ分離されています。同梱のupdate-guide.txt(起動後にplugins/DiscordBridgeJP/update-vX.X.X/フォルダに自動生成されます)を参照して移行してください。

5. bot.ymlを設定する

plugins/DiscordBridgeJP/bot.yml を開き、以下を入力します。

bot-token: "ここにBotトークン"
guild-id: "ここにサーバーID"
chat-channel-id: "チャット中継チャンネルID"
console-channel-id: "コンソールチャンネルID"
verify-channel-id: "連携用チャンネルID"
command-log-channel-id: "0"  # 使わない場合は 0 のまま

その他の項目(通知の文言、ロール色反映、BAN同期、Discordサーバー離脱検知など)は config.yml にあり、デフォルトのままでも動作します。詳細は Configuration と Messages を参照してください。

6. 起動・動作確認

  1. サーバーを起動します。コンソールにBotの接続成功ログが出ることを確認してください。
  2. ゲーム内で /discordbridgejp status を実行し、Botが接続済みであることを確認します。
  3. Discordの連携用チャンネルが正しく案内に使われているか確認します。
  4. ゲーム内で /discordbridgejp link を実行し、表示されたコード(!XXXXXXXX)を連携用チャンネルに貼って、アカウント連携が完了することを確認します。

正しく連携できれば、以降そのプレイヤーのチャットはDiscordでWebhook表示(アバター+名前)になり、Discordロール色がMC内に反映されます。

トラブルシューティング

うまく動かない場合は FAQ / Troubleshooting を確認してください。

Clone this wiki locally