Discord Link
DiscordLink 是一個專為 Paper (Minecraft 1.21.x) 伺服器設計的 Discord 帳號綁定驗證插件。本插件透過本地 SQLite 資料庫紀錄玩家 UUID 與 Discord 帳號的連結關係,並支援強制驗證與自由綁定兩種運作模式,以便伺服器管理員管理玩家社群。
功能特性
- 雙重驗證機制:
- 強制驗證模式:未綁定的玩家在登入時會被拒絕連線,並顯示隨機生成的 5 位數驗證碼,玩家需於 Discord 指定頻道輸入驗證碼方可進服。
- 自由綁定模式:玩家可直接進入伺服器,系統會在登入時提示玩家使用
/discordlink link 指令獲取驗證碼自行綁定。
- 自訂 Discord Embeds:支援在設定檔中自訂所有發送至 Discord 的卡片訊息(標題、描述、Hex 顏色與頁尾文字)。
- 玩家頭像渲染:自動整合
mc-heads.net API,於 Discord 訊息卡片中顯示綁定玩家的 3D 遊戲頭像,支援正版與離線版 UUID。
- Geyser/Floodgate 相容:針對基岩版(Bedrock)玩家的介面與字數限制進行優化,防範踢出訊息版面錯亂。
- 設定檔自動升級:更新插件時,自動補齊新版設定項目,並完整保留原有的自訂值。
- 管理員日誌與通知:綁定成功時可選擇是否向玩家發送私訊通知,以及在特定的管理員頻道輸出日誌。
- 優雅關閉設計:插件停用時會阻塞主執行緒等待 Discord 連線執行緒完全釋放,避免關機時產生
zip file closed 警告。
指令與權限
本插件主指令為 /discordlink,別名為 /dclink。
| 指令 |
說明 |
權限節點 |
預設權限 |
/dclink link |
獲取 5 位數綁定驗證碼 |
discordlink.use |
所有人 (true) |
/dclink help |
顯示指令說明清單 |
discordlink.use |
所有人 (true) |
/dclink reload |
重新載入設定檔 |
discordlink.admin |
管理員 (op) |
/dclink bypass add <玩家> |
將玩家加入免驗證白名單 |
discordlink.admin |
管理員 (op) |
/dclink bypass remove <玩家> |
將玩家移出免驗證白名單 |
discordlink.admin |
管理員 (op) |
/dclink admin query <玩家|DiscordID> |
查詢特定帳號的綁定關係 |
discordlink.admin |
管理員 (op) |
/dclink admin unbind <玩家|DiscordID> |
解除特定帳號的綁定關係 |
discordlink.admin |
管理員 (op) |
/dclink admin list [頁碼] |
分頁檢視所有已綁定的玩家清單 |
discordlink.admin |
管理員 (op) |
Discord Link
DiscordLink 是一款專為 Paper (Minecraft 1.21.x) 伺服器打造的 Discord 帳號綁定與驗證插件。基於本地 SQLite 資料庫運行,持久記錄玩家 UUID 與 Discord 帳號之間的綁定關係,提供強制驗證與自主綁定兩種模式,助力伺服器管理員簡化社群管理工作。
功能特性
-
双重验证模式:
-
强制模式:未绑定的玩家在登录时将被拒绝访问,并显示一个随机生成的 5 位验证码。玩家必须在该指定的 Discord 频道中提交此代码,才能加入服务器。
-
可选模式:玩家可以自由加入服务器,并在登录时被提示使用 /discordlink link 生成验证码并自愿绑定账号。
-
自定义 Discord Embed:全面支持所有出站 Discord embed 的配置,包括可自定义的标题、描述、十六进制颜色以及页脚文本。
-
玩家头像渲染:集成 mc-heads.net API,在 Discord embed 消息中展示 3D 玩家头部渲染图,支持在线和离线 UUID。
-
Geyser/Floodgate 兼容性:针对基岩版玩家优化了布局和字符限制,防止出现格式错误或踢出屏幕错位的情况。
-
自动配置迁移:在更新期间自动添加新的配置键,同时严格保留现有的自定义值。
-
管理员日志与通知:可选择在成功绑定后向玩家发送直接消息确认,并将详细的审计日志分发到专用的管理员频道。
-
优雅关闭例程:在插件禁用期间安全地阻塞主线程,直到所有 Discord 连接线程干净终止,从而防止在关闭时出现 zip file closed 警告。
命令与权限
该插件的主要命令为 /discordlink,别名为 /dclink。
| 命令 |
描述 |
权限节点 |
默认值 |
/dclink link |
生成一个 5 位数的链接验证码 |
discordlink.use |
所有人 (true) |
/dclink help |
显示命令帮助菜单 |
discordlink.use |
所有人 (true) |
/dclink reload |
重新加载配置文件 |
discordlink.admin |
OP (op) |
/dclink bypass add <player> |
将玩家添加到验证白名单 |
discordlink.admin |
OP (op) |
/dclink bypass remove <player> |
从验证白名单中移除玩家 |
discordlink.admin |
OP (op) |
| `/dclink admin query <player |
DiscordID>` |
查询账号链接状态 |
discordlink.admin |
| `/dclink admin unbind <player |
DiscordID>` |
解绑指定账号 |
discordlink.admin |
/dclink admin list [page] |
显示所有已链接账号的分页列表 |
discordlink.admin |
OP (op) |
Discord Link
DiscordLink 是一個專為 Paper (Minecraft 1.21.x) 伺服器設計的 Discord 帳號綁定驗證插件。本插件透過本地 SQLite 資料庫紀錄玩家 UUID 與 Discord 帳號的連結關係,並支援強制驗證與自由綁定兩種運作模式,以便伺服器管理員管理玩家社群。
功能特性
- 雙重驗證機制:
- 強制驗證模式:未綁定的玩家在登入時會被拒絕連線,並顯示隨機生成的 5 位數驗證碼,玩家需於 Discord 指定頻道輸入驗證碼方可進服。
- 自由綁定模式:玩家可直接進入伺服器,系統會在登入時提示玩家使用
/discordlink link 指令獲取驗證碼自行綁定。
- 自訂 Discord Embeds:支援在設定檔中自訂所有發送至 Discord 的卡片訊息(標題、描述、Hex 顏色與頁尾文字)。
- 玩家頭像渲染:自動整合
mc-heads.net API,於 Discord 訊息卡片中顯示綁定玩家的 3D 遊戲頭像,支援正版與離線版 UUID。
- Geyser/Floodgate 相容:針對基岩版(Bedrock)玩家的介面與字數限制進行優化,防範踢出訊息版面錯亂。
- 設定檔自動升級:更新插件時,自動補齊新版設定項目,並完整保留原有的自訂值。
- 管理員日誌與通知:綁定成功時可選擇是否向玩家發送私訊通知,以及在特定的管理員頻道輸出日誌。
- 優雅關閉設計:插件停用時會阻塞主執行緒等待 Discord 連線執行緒完全釋放,避免關機時產生
zip file closed 警告。
指令與權限
本插件主指令為 /discordlink,別名為 /dclink。
| 指令 |
說明 |
權限節點 |
預設權限 |
/dclink link |
獲取 5 位數綁定驗證碼 |
discordlink.use |
所有人 (true) |
/dclink help |
顯示指令說明清單 |
discordlink.use |
所有人 (true) |
/dclink reload |
重新載入設定檔 |
discordlink.admin |
管理員 (op) |
/dclink bypass add <玩家> |
將玩家加入免驗證白名單 |
discordlink.admin |
管理員 (op) |
/dclink bypass remove <玩家> |
將玩家移出免驗證白名單 |
discordlink.admin |
管理員 (op) |
/dclink admin query <玩家|DiscordID> |
查詢特定帳號的綁定關係 |
discordlink.admin |
管理員 (op) |
/dclink admin unbind <玩家|DiscordID> |
解除特定帳號的綁定關係 |
discordlink.admin |
管理員 (op) |
/dclink admin list [頁碼] |
分頁檢視所有已綁定的玩家清單 |
discordlink.admin |
管理員 (op) |
Discord Link
DiscordLink is a Discord account linking and verification plugin tailored for Paper (Minecraft 1.21.x) servers. Powered by a local SQLite database, it persistently tracks the linking relationships between player UUIDs and Discord accounts, offering both mandatory verification and optional self-linking modes to streamline community management for server administrators.
Features
-
Dual Verification Modes:
-
Mandatory Mode: Unlinked players are denied access upon login and presented with a randomly generated 5-digit verification code. Players must submit this code in a designated Discord channel before they can join the server.
-
Optional Mode: Players can join the server freely and are prompted on login to use /discordlink link to generate a verification code and link their accounts voluntarily.
-
Custom Discord Embeds: Full configuration support for all outbound Discord embeds, including customizable titles, descriptions, hex colors, and footer texts.
-
Player Avatar Rendering: Integrates mc-heads.net API to display 3D player head renders within Discord embed messages, with support for both online and offline UUIDs.
-
Geyser/Floodgate Compatibility: Optimized layout and character constraints for Bedrock players, preventing formatting glitches or misaligned kick screens.
-
Automatic Config Migration: Automatically appends new configuration keys during updates while strictly preserving existing custom values.
-
Admin Logging & Notifications: Optional direct message confirmations to players upon successful linking, along with detailed audit logs dispatched to dedicated admin channels.
-
Graceful Shutdown Routine: Safely blocks the main thread during plugin disablement until all Discord connection threads terminate cleanly, preventing zip file closed warnings on shutdown.
Commands & Permissions
The primary command for this plugin is /discordlink, aliased as /dclink.
| Command |
Description |
Permission Node |
Default |
/dclink link |
Generates a 5-digit linking verification code |
discordlink.use |
Everyone (true) |
/dclink help |
Displays the command help menu |
discordlink.use |
Everyone (true) |
/dclink reload |
Reloads configuration files |
discordlink.admin |
OP (op) |
/dclink bypass add <player> |
Adds a player to the verification whitelist |
discordlink.admin |
OP (op) |
/dclink bypass remove <player> |
Removes a player from the verification whitelist |
discordlink.admin |
OP (op) |
| `/dclink admin query <player |
DiscordID>` |
Queries account linking status |
discordlink.admin |
| `/dclink admin unbind <player |
DiscordID>` |
Unlinks a specified account |
discordlink.admin |
/dclink admin list [page] |
Displays a paginated list of all linked accounts |
discordlink.admin |
OP (op) |
评论 0
登录后参与评分
还没有评论,来抢沙发吧