Skip to content

FAQ

Jump to bottom
PIARIS edited this page Jun 21, 2026 · 3 revisions

FAQ / Troubleshooting

導入・運用でよくある質問とトラブルシューティングです。当てはまる症状が見つからない場合は、config.ymlのdebug: trueにしてから/discordbridgejp reloadし、コンソールログ(特に[Webhook]や[debug][NameColor])を確認してください。多くの問題はここに原因が出ます。

Botが起動しても接続されない

確認すること

  • bot-token が正しくコピーされているか(前後に余計な空白や改行が入っていないか)
  • guild-id が、Botを招待した実際のDiscordサーバーのIDと一致しているか
  • Discord Developer Portalの「Bot」ページで MESSAGE CONTENT INTENT がONになっているか(これがOFFだとチャット内容が読み取れず、チャット中継・コマンド実行が機能しません)

チャットが連携済みプレイヤーのアバター付き(Webhook)表示にならない

PIARIS6245: メッセージ のような無装飾の表示になってしまう場合の原因はだいたい次のいずれかです。

  • Botに 「ウェブフックの管理」権限 が無い。Discord Developer PortalのOAuth2 URL Generatorで権限を付け直し、再度招待URLからBotを招待し直してください(後から権限を足しても、既に参加済みのBotには自動で反映されないため、サーバー側のロール設定 or 再招待が必要です)
  • debug: true にして/discordbridgejp reload後、もう一度MCチャットを送信し、コンソールに出る[Webhook]ログを確認してください。「Webhook作成に失敗」と出ていれば権限不足、「client未準備」が出続ける場合はprepare自体が走っていない可能性があります

/discordbridgejp reload のたびにWebhookが壊れる

RejectedExecutionException: The Requester has been stopped! のようなエラーが出る場合は、古いバージョンのプラグインを使っています。reload時にBotの接続(JDA)を作り直す際、Webhookクライアントが古い接続を参照したままになる不具合が過去にありました。最新版に更新してください。

進捗達成時のMC内チャット表示が白色になる/おかしい

○○が進捗[進捗名]を達成しました のような表示が白色になったり崩れたりする場合は、古いバージョンの不具合です。過去のバージョンでは、Discord通知用の日本語翻訳処理をサーバー全体のメッセージ翻訳に誤って割り込ませてしまい、バニラの進捗ブロードキャストの色情報が失われていました。最新版では修正済みです。

入退室の通知が常に出ない/常に抑制される

LuckPermsで管理者グループに *(ワイルドカード、全権限)を付与している場合、discordbridgejp.silentjoin / silentquit も自動的にtrue扱いになり、常に通知が抑制されます。これはバグではなく、DiscordSRVも同じ仕組み(hasPermissionによる権限チェック)を採用しているため同様の挙動になります。

対処は、該当グループに個別ノードをfalseで明示的に上書きすることです。 /lp group <グループ名> permission set discordbridgejp.silentjoin false /lp group <グループ名> permission set discordbridgejp.silentquit false

これでワイルドカードを持っていても、通常時は通知が出るようになります。SuperVanishJP等でバニッシュした際は、動的に付与される一時権限がこの上書きより優先されるため、バニッシュ中だけ正しく抑制されます。

ロール色の反映が遅い

アカウント連携が完了すると、Discordからロール色を取得して即座に反映する設計になっています(通常は1秒未満)。数分かかる場合は、debug: trueでログを確認してください。[debug][NameColor]のログが出ない場合はイベント自体が発火していない可能性があるため、最新版か確認してください。タイムアウト気味な場合はDiscord API側の混雑が原因のこともあり、その場合は時間経過で自然に解消します。

連携コード(!XXXXXXXX)が読みにくい

Minecraftの標準フォントは0(ゼロ)とO(オー)、1、I、lが似て見えることがあります。現在のバージョンでは、これらの紛らわしい文字をコード生成時に除外しています。それでも判読しづらい場合は、コード部分をクリックするとクリップボードにコピーされる機能があるので、目で読み取らず直接貼り付けてください。

新規プレイヤーがサーバーに入れない

require-link-for-new-players: true の場合、初参加(過去にこのサーバーへ入ったことが一度もない)プレイヤーは、Discordアカウントと連携するまで参加できません。これは意図した仕様です。

参加しようとすると、キック画面に連携コード(!XXXXXXXX)が表示されます。このコードを、連携したいDiscordアカウントから連携用チャンネルに貼ることで連携が完了し、次回から参加できるようになります。既に一度でも参加したことのあるプレイヤーは対象外です。

/plugins コマンドで「Bukkit Plugins:」と表示される

これは正常です。PaperサーバーでもCraftBukkit由来の表示文言がそのまま使われているだけで、実際にPaperで動いているかどうかとは無関係です。/version コマンドで実際のサーバーソフトを確認できます。

WARN/ERRORのみモードでDiscordから実行したコマンドの結果が見えない

console-log-level: "WARN_ERROR" に設定している場合でも、Discordのコンソールチャンネルから実行したコマンドの結果は、実行直後の数秒間だけレベルフィルタを無視して必ず表示されるようになっています。それでも見えない場合は、コマンド自体がエラーになっていないか、Botに該当コマンドを実行する権限があるか確認してください。

それでも解決しない場合

GitHubのIssue で報告してください。debug: true 時のコンソールログを添えていただけると原因の特定が早くなります。

Clone this wiki locally