DiscordBridgeJP
这是一个基于 JDA(Discord 机器人)的桥接插件,将你的 Minecraft 服务器与 Discord 连接起来——支持聊天中继、账号绑定、角色颜色同步、控制台集成、封禁同步、Discord 退出检测等功能。
⭐ 主要功能
- 聊天桥接:实时双向聊天中继。已绑定玩家的通过 Webhook 发送消息,并显示其 Discord 头像和名称。
- 账号绑定:通过在游戏内生成的代码粘贴到 Discord 进行绑定。支持一个 Discord 账号绑定多个 Minecraft 账号。
- 角色颜色同步:在聊天栏、姓名标签和玩家列表中反映已绑定玩家的 Discord 角色颜色(各项均可单独开关)。
- 通知:向 Discord 发送加入/离开/首次加入/进度达成/死亡通知,可通过
messages.yml 完全自定义。
- 控制台集成:将服务器日志中继到 Discord;拥有允许角色的用户可以从 Discord 执行服务器命令。
- 封禁同步:Minecraft 或 Discord 中的封禁会自动同步到另一方。
- Discord 退出检测:检测已绑定玩家离开 Discord 服务器的情况,并在其重新加入/重新验证之前阻止其下次登录。
- 维护模式:可设置自定义理由踢人、权限绕过以及按通知类型屏蔽通知。
- 多语言:内置日语和英语;可通过
lang/ 目录添加更多语言。
⚡ 命令
| 命令 |
权限 |
描述 |
/discordbridgejp reload |
admin |
重载 config/lang/messages.yml 并重启 Bot |
/discordbridgejp status |
admin |
检查 Bot 连接状态 |
/discordbridgejp language <code> |
admin |
切换显示语言 |
/discordbridgejp namecolor <on|off> <player> |
admin |
针对每个玩家的角色颜色同步总开关 |
/discordbridgejp silentlogin <add|remove|list> [player] |
admin |
管理完全静默的加入/离开列表 |
/discordbridgejp maintenance <on|off> [reason] |
admin |
切换维护模式 |
/discordbridgejp timeout <player> |
admin |
手动阻止玩家登录 |
/discordbridgejp removetimeout <player> |
admin |
解除手动登录阻止 |
/discordbridgejp unlink <player> |
admin |
强制解除其他玩家的账号绑定 |
/discordbridgejp link |
link |
生成 Discord 账号绑定码 |
/discordbridgejp unlink |
unlink |
解除自己的 Discord 账号绑定 |
也支持 Discord 文本命令。在验证频道中:输入 !XXXXXXXX 完成绑定,!list 显示已绑定的账号(仅限管理员),!auth <player> <DiscordID> 强制绑定账号(管理员或配置好的特定角色)。在聊天频道中:!list 显示在线玩家。
? 权限
| 节点 |
默认值 |
描述 |
discordbridgejp.admin |
op |
一次性授予所有管理员命令(高级快捷方式;无需单独授予每个命令) |
discordbridgejp.command.reload |
op |
/discordbridgejp reload |
discordbridgejp.command.status |
op |
/discordbridgejp status |
discordbridgejp.command.language |
op |
/discordbridgejp language |
discordbridgejp.command.namecolor |
op |
/discordbridgejp namecolor |
discordbridgejp.command.silentlogin |
op |
/discordbridgejp silentlogin |
discordbridgejp.command.maintenance |
op |
/discordbridgejp maintenance |
discordbridgejp.command.timeout |
op |
/discordbridgejp timeout, removetimeout |
discordbridgejp.command.forceunlink |
op |
/discordbridgejp unlink <player>(强制解除其他玩家的绑定) |
discordbridgejp.link |
true |
生成账号绑定码 |
discordbridgejp.unlink |
true |
解除自己的账号绑定 |
discordbridgejp.silentjoin |
false |
仅屏蔽 Discord 加入通知 |
discordbridgejp.silentquit |
false |
仅屏蔽 Discord 离开通知 |
每个管理员命令都可以通过 LuckPerms 单独授予——你不再需要为了允许某位管理员使用某个特定命令而授予完整的 discordbridgejp.admin 权限。
⚙️ 技术细节
- 支持平台:Paper 1.21.8+(包括 Purpur, 26.1.x 系列)
- 要求:基于 JDK 21 构建,需要一个启用了 MESSAGE CONTENT INTENT 和 SERVER MEMBERS INTENT 的 Discord Bot
- 数据存储:SQLite (
data.db)
- 可选集成:AdvancedBan(封禁同步)、LuckPerms(权限组检查)、SuperVanishJP(静默加入/离开)
? 设置步骤
- 在 Discord Developer Portal 创建 Discord Bot,启用 MESSAGE CONTENT INTENT 和 SERVER MEMBERS INTENT,并获取 Token
- 邀请 Bot 到你的服务器并给予所需权限
- 在
bot.yml 中设置 Token 和频道 ID
- 运行
/discordbridgejp reload 完成设置
查看 config.yml、bot.yml 和 messages.yml 中的注释以获取完整设置列表。
? 更多详情,请参阅 GitHub Wiki(仅日语)。
DiscordBridgeJP(日本語)
这是一个基于 JDA(Discord Bot)的桥接插件,用于连接 Minecraft 服务器与 Discord。具备聊天中继、账号绑定、角色颜色同步、控制台集成、BAN 同步、Discord 服务器离开检测等全套功能。
⭐ 主要功能
- 聊天桥接:MC ↔ Discord 的实时双向中继。已绑定玩家的消息会通过 Webhook 显示其 Discord 头像和名称。
- 账号绑定:只需在游戏内生成代码并粘贴到 Discord 即可完成绑定。支持将一个 Discord 账号绑定多个 Minecraft 账号。
- 角色颜色同步:在聊天栏、姓名标签和玩家列表中反映已绑定玩家的 Discord 角色颜色(各选项可单独开启/关闭)。
- 通知功能:向 Discord 发送加入/离开/首次加入/进度达成/死亡通知。可在
messages.yml 中自由自定义文本和颜色。
- 控制台集成:将服务器日志中继到 Discord;指定角色可从 Discord 执行服务器命令。
- BAN 同步:与 AdvancedBan 联动,Minecraft/Discord 两端的 BAN 自动双向同步。
- Discord 服务器离开检测:检测已绑定玩家离开 Discord 服务器的行为,并在其重新加入/重新认证前阻止其下次登录。
- 维护模式:支持附带理由踢人、权限绕过以及按通知类型单独屏蔽。
- 多语言支持:内置日语和英语,只需添加到
lang/ 文件夹即可扩展语言。
⚡ 命令一览
| 命令 |
权限 |
说明 |
/discordbridgejp reload |
admin |
重新加载 config/语言/messages.yml 并重启 Bot |
/discordbridgejp status |
admin |
检查 Bot 连接状态 |
/discordbridgejp language <code> |
admin |
切换显示语言 |
/discordbridgejp namecolor <on|off> <player> |
admin |
角色颜色反映的单个主开关 |
/discordbridgejp silentlogin <add|remove|list> [player] |
admin |
对特定玩家完全静音入退室通知 |
/discordbridgejp maintenance <on|off> [理由] |
admin |
切换维护模式 |
/discordbridgejp timeout <player> |
admin |
手动阻止玩家登录 |
/discordbridgejp removetimeout <player> |
admin |
解除手动阻止 |
/discordbridgejp unlink <player> |
admin |
强制解除其他玩家的关联 |
/discordbridgejp link |
link |
生成 Discord 账号关联码 |
/discordbridgejp unlink |
unlink |
解除自己的 Discord 账号关联 |
也支持 Discord 端的文本命令。在认证频道发送 !XXXXXXXX 完成关联,!list 查看已关联账号列表(仅限管理员),!auth <player> <DiscordID> 进行强制关联(管理员或指定角色)。在聊天频道发送 !list 将显示在线玩家列表。
? 权限列表
| 权限节点 |
默认值 |
说明 |
discordbridgejp.admin |
op |
允许所有管理命令的上位兼容权限(无需单独授予) |
discordbridgejp.command.reload |
op |
/discordbridgejp reload |
discordbridgejp.command.status |
op |
/discordbridgejp status |
discordbridgejp.command.language |
op |
/discordbridgejp language |
discordbridgejp.command.namecolor |
op |
/discordbridgejp namecolor |
discordbridgejp.command.silentlogin |
op |
/discordbridgejp silentlogin |
discordbridgejp.command.maintenance |
op |
/discordbridgejp maintenance |
discordbridgejp.command.timeout |
op |
/discordbridgejp timeout, removetimeout |
discordbridgejp.command.forceunlink |
op |
/discordbridgejp unlink <player>(强制解除其他玩家关联) |
discordbridgejp.link |
true |
生成账号关联码 |
discordbridgejp.unlink |
true |
解除自己的关联 |
discordbridgejp.silentjoin |
false |
仅抑制加入时的 Discord 通知 |
discordbridgejp.silentquit |
false |
仅抑制退出时的 Discord 通知 |
每个管理命令都可以通过 LuckPerms 单独授予。如果您只想让特定的版主使用某个命令,则无需授予完整的 discordbridgejp.admin 权限。~~~~
⚙️ 技术细节
- 支持平台: Paper 1.21.8 及以上(包括 Purpur,支持 26.1.x 系列)
- 必要要求: JDK21 构建,Discord Bot(必须启用 MESSAGE CONTENT INTENT 和 SERVER MEMBERS INTENT)
- 数据存储: SQLite (
data.db)
- 可选集成: AdvancedBan(BAN 同步)、LuckPerms(权限组判定)、SuperVanishJP(入退室静音联动)
? 设置步骤
- 在 Discord Developer Portal 创建 Bot,启用 MESSAGE CONTENT INTENT 和 SERVER MEMBERS INTENT 并获取令牌
- 邀请 Bot 到服务器
- 在
bot.yml 中设置令牌和各频道 ID
- 执行
/discordbridgejp reload 启动完成
详细配置项请参考 config.yml、bot.yml 和 messages.yml 中的注释。
如果想更深入了解此插件的内容,请查看 GitHub Wiki(日语)。
DiscordBridgeJP
A JDA (Discord Bot) based bridge plugin connecting your Minecraft server with Discord — chat relay, account linking, role color sync, console integration, ban sync, Discord-leave detection, and more.
⭐ Key Features
- Chat Bridge: Real-time two-way chat relay. Linked players' messages appear via Webhook with their Discord avatar and name.
- Account Linking: Link via an in-game code pasted into Discord. Supports multiple Minecraft accounts per Discord account.
- Role Color Sync: Reflects a linked player's Discord role color in chat, nametag, and tab list (each toggleable).
- Notifications: Join/leave/first-join/advancement/death notifications to Discord, fully customizable via
messages.yml.
- Console Integration: Relays console logs to Discord; allowed roles can run server commands from Discord.
- Ban Sync: Bans on Minecraft or Discord automatically sync to the other side.
- Discord-Leave Detection: Detects when a linked player leaves the Discord server and blocks their next login until they rejoin/re-verify.
- Maintenance Mode: Kick with a custom reason, bypass permission, and per-notification-type suppression.
- Multi-language: Japanese and English included; more languages can be added via
lang/.
⚡ Commands
| Command |
Permission |
Description |
/discordbridgejp reload |
admin |
Reloads config/lang/messages.yml and restarts the Bot |
/discordbridgejp status |
admin |
Checks Bot connection status |
/discordbridgejp language <code> |
admin |
Switches display language |
/discordbridgejp namecolor <on|off> <player> |
admin |
Master toggle for role color sync per player |
/discordbridgejp silentlogin <add|remove|list> [player] |
admin |
Manages the fully-silent join/leave list |
/discordbridgejp maintenance <on|off> [reason] |
admin |
Toggles maintenance mode |
/discordbridgejp timeout <player> |
admin |
Manually blocks a player from logging in |
/discordbridgejp removetimeout <player> |
admin |
Lifts a manual login block |
/discordbridgejp unlink <player> |
admin |
Forcibly unlinks another player's account |
/discordbridgejp link |
link |
Issues a Discord account link code |
/discordbridgejp unlink |
unlink |
Unlinks your own Discord account |
Discord text commands are also supported. In the verification channel: !XXXXXXXX completes linking, !list shows linked accounts (admin only), !auth <player> <DiscordID> force-links an account (admin, or a configured role). In the chat channel: !list shows online players.
? Permissions
| Node |
Default |
Description |
discordbridgejp.admin |
op |
Grants all admin commands at once (upper-level shortcut; you don't need to grant each command individually) |
discordbridgejp.command.reload |
op |
/discordbridgejp reload |
discordbridgejp.command.status |
op |
/discordbridgejp status |
discordbridgejp.command.language |
op |
/discordbridgejp language |
discordbridgejp.command.namecolor |
op |
/discordbridgejp namecolor |
discordbridgejp.command.silentlogin |
op |
/discordbridgejp silentlogin |
discordbridgejp.command.maintenance |
op |
/discordbridgejp maintenance |
discordbridgejp.command.timeout |
op |
/discordbridgejp timeout, removetimeout |
discordbridgejp.command.forceunlink |
op |
/discordbridgejp unlink <player> (forcibly unlink another player) |
discordbridgejp.link |
true |
Issue an account link code |
discordbridgejp.unlink |
true |
Unlink your own account |
discordbridgejp.silentjoin |
false |
Suppresses only the Discord join notification |
discordbridgejp.silentquit |
false |
Suppresses only the Discord leave notification |
Each admin command can be granted individually via LuckPerms — you no longer need to grant full discordbridgejp.admin access just to allow a moderator to use one specific command.
⚙️ Technical Details
- Supported platforms: Paper 1.21.8+ (including Purpur, 26.1.x series)
- Requirements: Built with JDK 21, a Discord Bot with MESSAGE CONTENT INTENT and SERVER MEMBERS INTENT enabled
- Data storage: SQLite (
data.db)
- Optional integrations: AdvancedBan (ban sync), LuckPerms (permission group checks), SuperVanishJP (silent join/leave)
? Setup
- Create a Discord Bot in the Discord Developer Portal, enable MESSAGE CONTENT INTENT and SERVER MEMBERS INTENT, and get the token
- Invite the Bot to your server with the needed permissions
- Set the token and channel IDs in
bot.yml
- Run
/discordbridgejp reload to finish setup
See the comments in config.yml, bot.yml, and messages.yml for the full list of settings.
? For more details, see the GitHub Wiki (Japanese only).
DiscordBridgeJP(日本語)
Minecraft ServerとDiscordをつなぐ、JDA(Discord Bot)ベースの連携プラグインです。チャット中継、アカウント連携、ロール色反映、コンソール連携、BAN同期、Discordサーバー離脱検知など一通り揃っています。
⭐ 主な機能
- チャット連携: MC↔Discordのリアルタイム双方向中継。連携済みプレイヤーはWebhookでDiscordのアバターと名前が表示されます。
- アカウント連携: ゲーム内で発行したコードをDiscordに貼るだけで連携完了。1つのDiscord垢に複数のMinecraft垢を紐づけ可能。
- ロール色反映: 連携済みプレイヤーのDiscordロール色をチャット欄・ネームタグ・タブリストに反映(各項目を個別にON/OFF可能)。
- 通知機能: 参加/退出/初参加/進捗達成/死亡をDiscordへ通知。
messages.ymlで文言・色を自由にカスタマイズ可能。
- コンソール連携: サーバーログをDiscordへ中継し、指定ロールはDiscordからサーバーコマンドを実行可能。
- BAN同期: AdvancedBanと連携し、Minecraft/Discordどちらでのバンも自動で双方向に同期。
- Discordサーバー離脱検知: 連携済みプレイヤーがDiscordサーバーを抜けたことを検知し、再参加/再認証するまで次回ログインをブロック。
- メンテナンスモード: 理由付きキック、バイパス権限、通知種別ごとの個別抑制に対応。
- 多言語対応: 日本語・英語を同梱、
lang/フォルダに追加するだけで言語を拡張可能。
⚡ コマンド一覧
| コマンド |
権限 |
説明 |
/discordbridgejp reload |
admin |
config/言語/messages.ymlを再読込し、Botを再起動 |
/discordbridgejp status |
admin |
Bot接続状態を確認 |
/discordbridgejp language <code> |
admin |
表示言語を切替 |
/discordbridgejp namecolor <on|off> <player> |
admin |
ロール色反映の個別マスタースイッチ |
/discordbridgejp silentlogin <add|remove|list> [player] |
admin |
入退室を完全サイレント化する個別指定 |
/discordbridgejp maintenance <on|off> [理由] |
admin |
メンテナンスモードの切替 |
/discordbridgejp timeout <player> |
admin |
プレイヤーのログインを手動でブロック |
/discordbridgejp removetimeout <player> |
admin |
手動ブロックを解除 |
/discordbridgejp unlink <player> |
admin |
他プレイヤーの連携を強制解除 |
/discordbridgejp link |
link |
Discordアカウント連携コードを発行 |
/discordbridgejp unlink |
unlink |
自分のDiscordアカウント連携を解除 |
Discord側のテキストコマンドにも対応。認証チャンネルで!XXXXXXXXを送信すると連携完了、!listで連携済みアカウント一覧(管理者のみ)、!auth <player> <DiscordID>で強制連携(管理者、または指定ロール)。チャットチャンネルで!listを送信するとオンラインプレイヤー一覧を表示します。
? 権限一覧
| 権限ノード |
デフォルト |
説明 |
discordbridgejp.admin |
op |
管理コマンド全てをまとめて許可する上位互換権限(個別付与不要) |
discordbridgejp.command.reload |
op |
/discordbridgejp reload |
discordbridgejp.command.status |
op |
/discordbridgejp status |
discordbridgejp.command.language |
op |
/discordbridgejp language |
discordbridgejp.command.namecolor |
op |
/discordbridgejp namecolor |
discordbridgejp.command.silentlogin |
op |
/discordbridgejp silentlogin |
discordbridgejp.command.maintenance |
op |
/discordbridgejp maintenance |
discordbridgejp.command.timeout |
op |
/discordbridgejp timeout, removetimeout |
discordbridgejp.command.forceunlink |
op |
/discordbridgejp unlink <player>(他プレイヤーの強制解除) |
discordbridgejp.link |
true |
アカウント連携コードの発行 |
discordbridgejp.unlink |
true |
自分の連携の解除 |
discordbridgejp.silentjoin |
false |
参加時のDiscord通知のみ抑制 |
discordbridgejp.silentquit |
false |
退出時のDiscord通知のみ抑制 |
各管理コマンドはLuckPermsで個別に付与できます。特定のコマンド1つだけを使わせたいモデレーターに、discordbridgejp.adminを丸ごと与える必要はありません。~~~~
⚙️ 技術詳細
- 対応プラットフォーム: Paper 1.21.8以降(Purpur含む、26.1.x系対応)
- 必須要件: JDK21でビルド、Discord Bot(MESSAGE CONTENT INTENT・SERVER MEMBERS INTENT必須)
- データ保存: SQLite(
data.db)
- 任意連携先: AdvancedBan(BAN同期)、LuckPerms(権限グループ判定)、SuperVanishJP(入退室サイレント連携)
? セットアップ
- Discord Developer PortalでBotを作成し、MESSAGE CONTENT INTENT・SERVER MEMBERS INTENTを有効化してトークンを取得
- サーバーにBotを招待
bot.ymlにトークンと各チャンネルIDを設定
/discordbridgejp reloadで起動完了
詳細な設定項目はconfig.yml・bot.yml・messages.yml内のコメントを参照してください。
より詳しくこのプラグインの中身を知りたい場合は、GitHubのWikiをご覧ください(日本語)。
评论 0
登录后参与评分
还没有评论,来抢沙发吧