Minecord - Minecord（Discord 模组）

Minecord

将你的 Minecraft 世界带入 Discord 服务器

[][ci:release]

[][releases]

[][curseforge]

[][curseforge:files]

Minecord 是一款 Minecraft 模组，能将你的 Minecraft 世界带入 Discord 服务器。

它是 仅服务端 模组，使用 [JDA][jda] 与 Discord 交互，基于 [Fabric][fabric] 模组加载器构建，适用于现代版本的 [Minecraft][minecraft] Java 版。

> 💡 你只需将单个模组 jar 文件添加到服务器，例如 minecord-2.0.3+1.20.6.jar。

集成支持

• [TextPlaceholderAPI][text-placeholder-api] by Patbox — 用于文本占位符
• [TydiumCraft Skin API][tydiumcraft-api] by Tydium — 用于嵌入头像

功能特性

💬 聊天

[聊天模块](minecord-chat/README.md) 负责在 Minecraft 与 Discord 之间桥接聊天相关事件。

• 多频道支持
• 按 Minecraft 维度筛选事件
• 转换 Unicode 表情符号，例如 😃 -> :smiley:
• 在合适位置显示玩家头像嵌入
• 转发至 Minecraft 的 Discord 事件
• 用户发送消息
• 用户回复消息
• 用户编辑最近发送的消息
• 用户对最近消息添加反应
• 用户移除对最近消息的反应
• 用户发送包含贴图的消息
• 用户发送包含附件的消息
• 转发至 Discord 的 Minecraft 事件
• 玩家发送游戏内聊天消息
• 玩家通过 /me 命令发送游戏内消息
• 管理员通过 /say 命令广播游戏内消息
• 管理员通过 /tellraw @a 命令向所有玩家广播游戏内消息
• 玩家死亡
• 命名动物/怪物（使用命名牌）死亡
• 玩家解锁进度任务
• 玩家达成进度目标
• 玩家完成进度挑战
• 玩家传送到其他维度
• 玩家加入游戏
• 玩家离开游戏
• 服务器开始启动
• 服务器启动完成并接受连接
• 服务器开始停止
• 服务器停止并离线
• 服务器意外停止且无法访问
• 可选附加可用时的崩溃报告

🪄 命令

[命令模块](minecord-cmds/README.md) 负责提供各种命令，让你能从 Discord 与 Minecraft 服务器交互。

• 开箱即用的内置命令
• /uptime — 显示服务器已运行时长
• /tps — 显示 Minecraft 服务器当前每秒刻数
• 配置自定义斜杠命令来执行 Minecraft 命令
• 例如，可通过 /whitelist 管理服务器白名单
• 可为命令设置冷却时间
• 可按用户、频道或服务器进行配置
• 检测命令中的玩家并在响应中显示其头像
• 模组开发者可注册自定义斜杠命令

😇 状态

[状态模块](minecord-presence/README.md) 负责更新 Discord 中机器人的状态，以显示更详细的信息。

• 开箱即用的内置状态类别
• starting — Minecraft 服务器启动时使用
• running — Minecraft 服务器运行时使用
• stopping — Minecraft 服务器停止时使用
• 配置自定义状态
• 活动类型，如：竞赛、收听、游玩、直播或观看
• 活动名称（支持占位符值）
• 模组开发者可注册并触发自定义状态类别

📦 API

[API 模块](minecord-api/README.md) 是进入 Minecord 模组的入口。它为开发者提供了必要的工具，以便将他们的模组与 Discord 集成。

赞助商

我们要感谢以下赞助商对 Minecord 开发的支持。

[

][bisecthosting]

贡献

感谢你考虑为 Minecord 做出贡献！请参阅 [贡献指南][contributing]。

安全漏洞

请查看 [安全政策][security] 了解如何报告安全漏洞。

许可证

Minecord 是基于 [MIT 许可证][licence] 的开源软件。

[bisecthosting]: https://bisecthosting.com/axieum

[ci:release]: https://github.com/axieum/minecord/actions/workflows/release.yml

[contributing]: https://github.com/axieum/minecord/blob/main/.github/CONTRIBUTING.md

[curseforge]: https://curseforge.com/minecraft/mc-mods/minecord-for-discord

[curseforge:files]: https://curseforge.com/minecraft/mc-mods/minecord-for-discord/files

[fabric]: https://fabricmc.net/

[jda]: https://github.com/DV8FromTheWorld/JDA

[licence]: https://opensource.org/licenses/MIT

[minecraft]: https://minecraft.net/

[releases]: https://github.com/axieum/minecord/releases

[security]: https://github.com/axieum/minecord/security/policy

[text-placeholder-api]: https://github.com/Patbox/TextPlaceholderAPI

[tydiumcraft-api]: https://www.tydiumcraft.net/docs/skinapi