DiscordLink v2 (新版本 ✨)
通过账号绑定、角色管理、多语言支持以及基于 Discord Components V2 构建的完整管理面板,将你的 Minecraft 服务器与 Discord 连接起来
✨ v2 更新内容
- ? 语言系统 — 整个插件和机器人现在都支持翻译(已内置法语和英语,你也可以添加自己的语言)
- ?️ 管理面板 (Components V2) — 直接从 Discord 管理机器人和所有已绑定的玩家,不再需要控制台命令
- ? 已绑定玩家浏览器 — 分页列表、搜索、玩家详情、一键强制解绑
- ⚙️ 实时机器人设置 — 从面板切换功能、编辑角色和频道、重载配置
- ?️ 按玩家的语言设置 — 每个玩家都可以在游戏内和 Discord 上选择自己的语言
- ? 游戏内 GUI — 无需离开 Minecraft 即可管理机器人和已绑定玩家,具备细粒度的权限控制(默认 op 权限)
功能特性
? 语言系统
- 内置语言:默认自带
fr_FR和en_US - 语言文件:每条消息都位于
plugins/DiscordLink/languages/<locale>.yml中 - 自定义语言:放入新文件(例如
es_ES.yml),系统将自动加载 - 按玩家设置区域设置:玩家可通过
/lang选择语言,或根据 Minecraft 客户端自动检测 - Discord 区域设置检测:当可用时,机器人回复会跟随用户的 Discord 语言
- 本地化斜杠命令:命令描述会跟随每个 Discord 客户端的语言
- MiniMessage 支持:游戏内每条消息都支持渐变、悬停和点击事件
- 回退系统:缺失的键值会自动回退到默认语言,不会出现乱码或错误信息
?️ 管理面板 (Discord Components V2)

输入单个 /panel 命令即可打开一个交互式、临时性的控制面板,该面板由 Components V2(容器、分区、分隔线、按钮、选择菜单和模态框)构建而成。
仪表盘
- 机器人状态、运行时间、延迟、Minecraft 服务器状态
- 已绑定账户数量、在线玩家数、待处理代码数
- 快捷操作:重载、清除过期代码、刷新
已绑定玩家
- 所有已绑定账户的分页列表(显示 Minecraft 名称、Discord 用户、绑定日期、在线状态)
- ? 按 Minecraft 名称、UUID 或 Discord 用户搜索(通过模态框)
- 玩家详情视图,带有皮肤头像缩略图
- 操作:强制解绑、同步角色、添加/移除豁免、更改语言
- 任何破坏性操作前都需要确认步骤
机器人设置
- 切换强制绑定、角色同步、在线角色、各类日志类型
- 使用角色选择菜单选择绑定/在线角色
- 使用频道选择菜单选择日志频道
- 选择允许使用面板的角色
- 通过模态框编辑代码长度和过期时间
- 更改默认语言
- 更改即时保存至
config.yml—— 无需重启
安全
- 面板访问权限限制为可配置的 Discord 角色或具有
Administrator权限的用户 - 每次面板操作都会记录在日志频道中(谁、做了什么、何时做的)
? 游戏内 GUI
Discord 面板中的所有功能也可以通过库存菜单在游戏内获得,由 SmartInvs 提供支持(已阴影打包,无需额外安装)。
使用 /discordlink gui(别名 /dl gui)打开主菜单。
主菜单
- 机器人状态(在线、延迟、公会)、已绑定账户数量、待处理代码数
- 通往各个子菜单的快捷方式、重载按钮、清除过期代码
已绑定玩家菜单
- 分页显示带有皮肤头像的已绑定玩家列表
- 物品说明(Lore):Discord 用户、绑定日期、语言、在线状态
- 过滤器:全部 / 在线 / 离线,通过聊天输入进行搜索
- 点击头像打开玩家菜单:强制解绑、同步角色、切换豁免、更改语言
- 任何破坏性操作前都有确认菜单
机器人设置菜单
- 切换强制绑定、角色同步、在线角色和各类日志类型
- 更改代码长度和过期时间(左/右键点击,Shift 键用于 ×10)
- 更改默认语言
- 更改即时保存至
config.yml
语言菜单
- 玩家可以使用
/lang选择语言(不带参数打开 GUI)
权限
- 每个菜单和操作都有独立的权限,默认授予 op
- 仅给予工作人员他们所需的权限(例如:查看玩家但不允许解绑)
- 菜单标题、物品、材质和物品说明(Lore)均可在语言文件中完全翻译
? 账号关联系统
- 自动代码生成:玩家在尝试连接时会收到一个唯一的验证码
- Discord 斜杠命令:使用简单的
/link命令即可完成关联 - 安全验证:验证码在 5 分钟后过期(可配置)
- 强制关联:要求玩家在加入服务器前必须完成 Discord 关联
- 绕过系统:玩家、UUID 或权限可以跳过关联流程
? Discord 机器人集成
- 自动角色管理:关联时分配相应角色
- 在线状态角色:为当前连接的在线玩家分配角色
- 昵称同步(可选):将成员名称更改为其 Minecraft 用户名
- 活动状态:显示
{online}/{max}名玩家作为机器人的活动状态 - 斜杠命令与 Components V2 界面
- 完全自定义:可通过配置文件或直接通过面板进行设置

? 高级日志记录
- 连接 / 断开连接日志:包含 IP、UUID、用户名和时间戳
- 关联 / 取消关联事件
- 面板操作:记录从面板执行的所有管理员操作
- GUI 操作:记录从游戏内菜单执行的所有管理员操作
- 翻译日志:日志遵循服务器的默认语言
- Components V2 容器:每种事件的配色均可配置

? 玩家管理
- 游戏内命令:
/link、/unlink、/linkinfo、/lang - 管理员命令:
/forceunlink、/discordlink reload - SQLite 存储:支持从 v1 版本自动迁移数据
- 自动清理:清除过期的验证码
命令与权限
Minecraft — 玩家命令
| 命令 | 描述 | 权限 |
|---|---|---|
/link |
生成关联验证码 | discordlink.link (默认) |
/unlink |
取消你的 Discord 账号关联 | discordlink.unlink (默认) |
/linkinfo |
查看你的关联信息 | discordlink.info (默认) |
/linkinfo <player> |
查看其他玩家的信息 | discordlink.info.others (op) |
/lang [locale] |
更改你的语言(无参数时打开 GUI) | discordlink.lang (默认) |
Minecraft — 管理员命令
| 命令 | 描述 | 权限 |
|---|---|---|
/forceunlink <player> |
强制解除玩家的账号关联 | discordlink.admin |
/discordlink reload |
重新加载配置文件和语言文件 | discordlink.admin |
/discordlink gui |
打开管理员 GUI | discordlink.gui |
/discordlink version |
显示插件版本 | — |
GUI 权限 (默认: op)
| 权限 | 描述 |
|---|---|
discordlink.gui |
打开主管理员菜单 |
discordlink.gui.players |
查看已关联的玩家列表 |
discordlink.gui.players.unlink |
从 GUI 强制解除关联 |
discordlink.gui.players.resync |
重新同步玩家的 Discord 角色 |
discordlink.gui.players.bypass |
切换玩家的绕过关联状态 |
discordlink.gui.players.lang |
更改玩家的语言 |
discordlink.gui.settings |
打开并编辑机器人设置 |
discordlink.gui.reload |
从 GUI 重新加载配置 |
discordlink.gui.* |
所有 GUI 权限 |
discordlink.bypass |
绕过强制关联 (默认: false) |
Discord — 斜杠命令
| 命令 | 描述 | 访问权限 |
|---|---|---|
/link code:<code> |
关联你的 Minecraft 账号 | 所有人 |
/unlink |
取消你的账号关联 | 已关联用户 |
/linkinfo [user] |
查看关联信息 | 所有人 |
/lang |
选择你的机器人语言 | 所有人 |
/panel |
打开管理员面板 | 面板角色 / 管理员 |
别名
/dl→/discordlink
工作原理
对于新玩家
- 玩家尝试连接到服务器
- 如果未关联,他们会被踢出并收到一个唯一验证码(以其语言显示)
- 玩家加入你的 Discord 服务器
- 玩家使用
/link code:XXXXXX - 账号关联成功,玩家现在可以加入服务器
- 配置的角色会自动分配
对于已关联的玩家
- 玩家正常连接
- "Online" 角色被添加到 Discord
- 断开连接时移除 "Online" 角色
- "Linked" 角色永久保留
对于管理员
- 在 Discord 上运行
/panel - 浏览已关联的玩家,搜索、解除关联、重新同步角色
- 从选择菜单和模态框中实时调整机器人设置
- 所有操作都会自动记录日志
配置
config.yml
- 机器人令牌、服务器 ID、启用/禁用功能、活动状态
- 已关联和在线角色的 ID、角色同步选项
- 日志频道和按事件启用的开关
- 强制关联、绕过列表及权限
- 验证码长度和过期时间
- 面板访问角色
- 游戏内 GUI 选项(行数、音效、填充物)
- 默认语言和自动检测
languages/<locale>.yml
meta: 语言名称、旗帜、GUI 图标、Minecraft 和 Discord 区域设置别名minecraft: 所有游戏内、踢出提示和 GUI 消息 (MiniMessage)discord: 所有机器人、面板和日志消息 (Discord markdown)console: 控制台消息- 占位符:
{player}、{code}、{discord}、{minutes}…
大多数设置也可以从面板的 Bot Settings 部分实时编辑。
安装指南
前置条件
- 一个 Discord 机器人
- 机器人令牌、服务器 ID、角色 ID、日志频道 ID
Discord 机器人设置
- 在 Discord 开发者门户创建一个机器人
- 启用 服务器成员意图
- 使用以下权限邀请该机器人:
- 管理角色
- 管理昵称(仅用于昵称同步)
- 发送消息
- 嵌入链接
- 使用应用程序命令
- 将机器人的角色放置在 高于 已链接/在线角色的位置
- 复制你的机器人令牌
插件安装
- 将 DiscordLink 放入
plugins/文件夹中 - 启动服务器以生成
config.yml和languages/目录 - 停止服务器,填入令牌、公会 ID、角色和频道信息
- 选择默认语言
- 启动服务器,然后通过
/panel完成配置
机器人运行在一个嵌入式 Node.js 运行时环境中,首次启动时会自动下载到
plugins/DiscordLink/runtime/。
从 v1 升级
- 替换 jar 文件,启动服务器
- 旧的
config.yml会被转换(备份保留为config-v1.yml) links.db会自动迁移- 旧版
config.yml中的自定义消息会移至languages/fr_FR.yml
获取 ID
- 公会 ID:启用开发者模式 → 右键点击服务器 → 复制服务器 ID
- 角色 ID:右键点击一个角色 → 复制角色 ID
- 频道 ID:右键点击一个频道 → 复制频道 ID
数据库
DiscordLink 使用 SQLite:
- 无需外部数据库
- 自动创建和迁移
- 存储 UUID、用户名、Discord ID、链接时间戳、玩家语言和绕过状态
- 位置:
plugins/DiscordLink/links.db
构建
./gradlew build
需要 Java 21 和 pnpm(bot/ 中的机器人被打包进 jar 文件中)。输出结果为 build/libs/DiscordLink-<version>-all.jar。
要求
- Minecraft: 1.21 → 26.x (Paper/Purpur)
- Java: 21+
- 依赖项: 无(SmartInvs 和机器人已包含在内)
支持
发现 Bug?想要添加一种语言?
- 在 GitHub 上提交 Issue 或 PR
- 加入我们的 Discord 社区
- 如果觉得有用,请给项目点个 Star
致谢
assets/ 中的徽章来自 intergrav 的 Devin's Badges,采用 MIT 许可证 — 详见 assets/LICENSE。
专为 Minecraft 社区打造
连接跨平台与多语言的玩家
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。

评论 0
登录后参与评分
还没有评论,来抢沙发吧