Minecord
将你的 Minecraft 世界带入 Discord 服务器
[
[
[
][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
