RPGs Discord集成

Discord 集成

Discord 集成 通过一个真实的 Discord 机器人（基于 JDA）将你的 Minecraft 1.12.2 服务器连接到 Discord 服务器——提供双向聊天桥接、使用斜杠命令的账户关联、游戏内物品展示以及自动更新的排行榜嵌入消息。除了可选的物品展示图标渲染外，客户端无需安装本模组即可使用所有功能。

功能特性

聊天桥接

• 在配置好的 Minecraft 聊天频道与游戏内聊天之间进行双向转发
• Minecraft → Discord 的消息通过 webhook 以玩家身份 发布，使用其真实用户名、当前皮肤头像作为头像，并且（可选）包含其 LuckPerms 权限组前缀
• Discord → Minecraft 的消息在游戏内显示时带有 [Discord] <名字>: <消息> 标签，并包含附件链接
• 忽略机器人/webhook 流量以防止回声循环

账户关联

• 游戏内使用 /discord link 生成一个短期有效的代码；在 Discord 中使用 /link code:<代码> 完成关联
• 游戏内使用 /discord unlink 或 Discord 中使用 /unlink 解除关联
• 首次成功关联后会发放一个可配置的一次性奖励（一个带有可选 NBT 的物品，或一条控制台命令）——如果玩家在线则立即发放，如果不在线则排队等待下次登录时发放

物品展示

• 在 Minecraft 聊天中分享物品（通过 Quark 的 Display Item 及类似模组所使用的原版悬停物品机制）会自动将其图标和提示文本发布到 Discord

斜杠命令 (Discord 端)

• /link、/unlink — 账户关联
• /profile [玩家名] - 发布已关联或指定玩家的统计信息富嵌入消息
• /leaderboard [类别] - 为任何统计类别发布前 10 名排行榜嵌入消息

自动更新排行榜

• 在配置好的频道中，为每个统计类别保持一条置顶、自动刷新的排行榜嵌入消息，刷新间隔可配置——通过将置顶消息与类别进行匹配来跨重启持久化

加入/离开公告

• 可选的 Discord 公告，在玩家加入或离开时发送，如果可用则包含权限组前缀

可选集成

• Stat Profiles - /profile、/leaderboard 和排行榜嵌入消息的必需前置模组；没有它时机器人和聊天桥接仍可正常运行，只是这些功能会显示为不可用
• LuckPerms - 存在时为聊天桥接和加入/离开消息添加权限组前缀

配置

所有设置都位于 config/discordintegration/config.json 中：机器人令牌、服务器（Guild）ID、聊天和排行榜频道 ID、各功能开关（聊天桥接、物品展示、加入/离开消息、权限组前缀）、关联代码有效期、排行榜刷新间隔以及关联奖励。

要求

• Minecraft 1.12.2
• Minecraft Forge
• 一个 Discord 机器人令牌（可通过 Discord 开发者门户创建）
• Stat Profiles（可选，用于 /profile 和 /leaderboard）
• LuckPerms（可选，用于权限组前缀）

📦 命令

命令	用途	权限
/discord status	检查 Discord 机器人是否已连接	0
/discord link	生成一个代码以关联你的 Discord 账户	0
/discord unlink	解除你的 Discord 账户关联	0