Configuration

Configuration

plugins/DiscordBridgeJP/config.yml の全設定項目です。アップデートで新しい項目が増えた場合は、サーバー起動時に既存ファイルへ自動で補完されます(既存の値は上書きされません)。

通知文言・Embed色・チャット表示形式などは config.yml ではなく Messages (messages.yml)で設定します。

Discord接続(必須)

キー	説明
bot-token	Discord Developer Portal で取得したBotトークン。他人に公開しないこと
guild-id	Botを動かすDiscordサーバー(ギルド)自体のID
chat-channel-id	MC↔Discordチャット中継チャンネルID
console-channel-id	コンソールログ中継 / Discordからのコマンド実行チャンネルID
verify-channel-id	アカウント連携コード(!XXXXXXXX)を入力するチャンネルID
command-log-channel-id	プレイヤーコマンドログ専用チャンネルID。0で無効

いずれも導入手順は Installation を参照してください。

console-command

Discordのコンソールチャンネルでの発言を、サーバーコマンドとして実行する機能の設定です。

キー	デフォルト	説明
console-command.enabled	false	trueにすると console-channel での発言をMCコマンドとして実行する(強い権限のため要注意)
console-command.role-id	"0"	上記を許可するDiscordロールID

console-log-level

キー	デフォルト	説明
console-log-level	"ALL"	コンソールチャンネルに中継するログの範囲。ALL=全ログ / WARN_ERROR=WARN・ERRORのみ。Discordチャンネル内でコマンドを実行した場合、その実行結果はこの設定に関わらず常に表示されます

language

キー	デフォルト	説明
language	"ja"	表示言語。lang/フォルダにあるYAMLファイルの言語コードを指定(ja、enなど)

name-color(ロール色反映)

連携済みプレイヤーのDiscordロール色をMC側へ反映する設定です。

キー	デフォルト	説明
name-color.chat	true	チャット欄のプレイヤー名にロール色(フルカラー)を反映し、<名前>形式にする
name-color.nametag	true	頭上のネームタグに反映(バニラ16色へ自動近似)
name-color.tablist	true	タブリスト(プレイヤー一覧)に反映(フルカラー)
name-color.cache-seconds	300	Discordロール色をREST取得してからキャッシュする秒数

個別プレイヤー単位でON/OFFしたい場合は /discordbridgejp namecolor <on|off> <player> コマンドを使います。

chat-command / sticky-message

キー	デフォルト	説明
chat-command.enabled	true	Discord側のテキストコマンド(!list等)を有効にするか
chat-command.prefix	"!"	テキストコマンドの接頭辞
sticky-message.enabled	true	チャットチャンネル下部に案内メッセージを固定表示する機能

link(アカウント連携)

キー	デフォルト	説明
link.code-expiry-seconds	600	連携コードの有効期限(秒)
link.delete-code-message	false	連携用チャンネルに貼られた本人のコードメッセージを、処理後にBotが削除するか
link.unlink-mode	"block"	require-link-for-new-players: true 中の unlink 動作。block=一般プレイヤーのunlinkコマンドを拒否 / kick=unlink自体は許可し解除後に即KICK
link.multi-account.enabled	false	1つのDiscordアカウントに複数のMinecraftアカウントを紐づけられるようにするか
link.multi-account.max-per-discord	2	1つのDiscordアカウントに紐づけられるMinecraftアカウントの上限(multi-account.enabled時のみ有効)

require-link-for-new-players

キー	デフォルト	説明
require-link-for-new-players	false	trueにすると、初参加(過去にこのサーバーへ入ったことのない)プレイヤーに、Discordアカウント連携を必須化する。未連携の場合は接続時にキック画面でコードが表示される。既にプレイ済みのプレイヤーは対象外

maintenance(メンテナンスモード)

/discordbridgejp maintenance on [理由] で即時切替・保存されます。手動でconfig.ymlを編集することもできます。

キー	デフォルト	説明
maintenance-mode	false	メンテナンスモードのON/OFF
maintenance.bypass-permission	""	メンテ中でも参加できるバイパス権限ノード。空ならOPのみ参加可能(LuckPerms等の権限プラグイン導入時のみ有効)
maintenance.reason	""	直近のメンテナンス理由。コマンドから自動保存されるが手動編集も可

ban-sync(BAN同期)

AdvancedBanと連携してBANを双方向に同期します。

キー	デフォルト	説明
ban-sync.mc-to-discord	true	MinecraftでのBANをDiscordへ反映するか
ban-sync.discord-to-mc	true	DiscordでのBANをMinecraftへ反映するか
ban-sync.unban-sync	true	BAN解除も同様に同期するか

複数アカウント連携時は、紐づく全Minecraftアカウントに対してBAN/解除が反映されます。

recognize-legacy-discordsrv-permissions

キー	デフォルト	説明
recognize-legacy-discordsrv-permissions	true	discordsrv.silentjoin / discordsrv.silentquit 権限(SuperVanishJP等が付与)も discordbridgejp.* と同等に扱うか。SuperVanishJPとの互換性のための設定

debug

キー	デフォルト	説明
debug	false	trueにすると、Webhook送信やロール色反映などの詳細ログをコンソールに出力する。動作確認・トラブルシューティング時に使用

設定変更後は /discordbridgejp reload で反映できます(Botの再接続を伴います)。