Discord 状态

在你的 Discord 中观看 Minecraft 服务器活起来。 当玩家加入时发送一条消息，然后保持它实时更新——玩家游玩时显示一个在线反应，死亡时显示死亡标记，进度嵌入，以及 Discord 和游戏之间的双向聊天。纯 NeoForge + JDK，零外部库。

适用于任何 NeoForge 1.21.1 服务器——以及单人游戏。

功能

• 📨 加入消息 — 通过 webhook 发布到 Discord 频道。玩家首次加入时，会打开一个持久的每位玩家专属的线程；后续加入会发布到该线程中。
• 🟢 实时在线状态 — 机器人会在玩家在线时添加一个在线反应，并在退出时移除。
• 💀 死亡标记 — 一个死亡反应，以及一个可选的丰富死亡报告嵌入（原因、分数/位置/维度/经验值，以及手持和穿着装备的图像）。
• 🏆 进度 — 已获得的进度作为彩色嵌入发布到玩家的线程中（可按命名空间过滤）。
• 💬 双向聊天 — 游戏内聊天以每位玩家的名义中继到 Discord（进入他们的线程）；Discord 的回复和线程消息中继回游戏。目标明确，不是信息洪流——只有对玩家消息的回复或在其线程中的帖子才会传递过来。
• 🕯️ 对黑暗低语 — 当 Discord 无人倾听时聊天，游戏会低语一句随机的灰色风格台词（"Steve 对着虚空低语，有人在吗？"）。一旦 Discord 回复则关闭，安静一段时间后重新激活。大约有 2,000 种组合。
• 👋 断开连接报告 （可选） — 当玩家存活时退出，发布一个统计嵌入。
• 🕓 最后在线时间 （用于捆绑模组） — 跟踪配置的 Discord 用户并查询其在线状态，例如 "Brennan 最后一次在线是在 5 分钟前。"

为什么同时需要 webhook 和 机器人？

Discord webhook 可以发布但不能反应——只有机器人可以。所以 Discord Presence 使用 webhook 发布，并使用机器人添加反应、创建每位玩家专属的线程、发布进度嵌入，以及打开一个网关连接来读取双向聊天的回复。全部零外部依赖——只需 JDK 和 NeoForge 的 Gson。

设置

所有配置都在 config/discordpresence-server.toml 中（在服务器首次启动时创建）。模组默认保持关闭，直到你设置了 webhook URL。

1. Webhook — 服务器设置 → 集成 → Webhooks → 新建 Webhook → 将 URL 复制到 webhookUrl。
2. 机器人（用于反应/线程） — 在 Discord 开发者门户创建一个应用，将机器人令牌复制到 botToken，并使用查看频道、读取消息历史、添加反应、创建公开线程、在线程中发送消息权限邀请它。
3. 双向聊天（可选） — 启用消息内容特权意图。

完整的配置参考和设置指南：GitHub README。

捆绑

Discord Presence 以空白形式发布——Jar 文件中没有密钥——因此可以安全地捆绑。另一个模组可以在运行时通过 DiscordCredentialsProvider 将其指向一个中央数据源。它被捆绑在 Dungeon Train 中。

许可

PolyForm Shield 1.0.0 — © Brennan Hatton。