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。

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.