Discord-Link

插件

· 作者 RedSavant

最完整的 Discord 链接插件。 将玩家的 Minecraft 账号与他们的 Discord 账号关联。 插件内托管一个机器人。 完全可自定义,你可以强制玩家进行链接才能加入服务器。 在 Discord 频道中记录自定义的链接日志。

0 本站下载 0 关注 更新于 4 周前

最新 2.0.0 · 26.3 · Paper / Purpur

一键开服(送7天)

First


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

输入单个 /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 或权限可以跳过关联流程

Kick

? Discord 机器人集成

  • 自动角色管理:关联时分配相应角色
  • 在线状态角色:为当前连接的在线玩家分配角色
  • 昵称同步(可选):将成员名称更改为其 Minecraft 用户名
  • 活动状态:显示 {online}/{max} 名玩家作为机器人的活动状态
  • 斜杠命令与 Components V2 界面
  • 完全自定义:可通过配置文件或直接通过面板进行设置

Link ExampleBot

? 高级日志记录

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

Logs

? 玩家管理

  • 游戏内命令:/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

工作原理

对于新玩家

  1. 玩家尝试连接到服务器
  2. 如果未关联,他们会被踢出并收到一个唯一验证码(以其语言显示)
  3. 玩家加入你的 Discord 服务器
  4. 玩家使用 /link code:XXXXXX
  5. 账号关联成功,玩家现在可以加入服务器
  6. 配置的角色会自动分配

对于已关联的玩家

  1. 玩家正常连接
  2. "Online" 角色被添加到 Discord
  3. 断开连接时移除 "Online" 角色
  4. "Linked" 角色永久保留

对于管理员

  1. 在 Discord 上运行 /panel
  2. 浏览已关联的玩家,搜索、解除关联、重新同步角色
  3. 从选择菜单和模态框中实时调整机器人设置
  4. 所有操作都会自动记录日志

配置

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 机器人设置

  1. 在 Discord 开发者门户创建一个机器人
  2. 启用 服务器成员意图
  3. 使用以下权限邀请该机器人:
    • 管理角色
    • 管理昵称(仅用于昵称同步)
    • 发送消息
    • 嵌入链接
    • 使用应用程序命令
  4. 将机器人的角色放置在 高于 已链接/在线角色的位置
  5. 复制你的机器人令牌

插件安装

  1. 将 DiscordLink 放入 plugins/ 文件夹中
  2. 启动服务器以生成 config.yml 和 languages/ 目录
  3. 停止服务器,填入令牌、公会 ID、角色和频道信息
  4. 选择默认语言
  5. 启动服务器,然后通过 /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 社区打造

连接跨平台与多语言的玩家

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源