
兰的简易Discord:桥接+
通过 Discord 连接你的 Minecraft 世界与社区——一个轻量级的 Discord 集成插件/模组。只需放入、配置,即可使用。
前置要求
- Fabric Loader 0.15.0+
- Fabric API
计划功能
- 统计追踪器 — 直接从 Discord 查询玩家的游戏内统计数据(挖掘方块数、击杀生物数、死亡次数、游戏时长等)
- 进度排行榜 — 通过 Discord 查看并比较任意玩家已完成的进度
- 玩家检查器 — 无需打开 Minecraft 即可查看服务器上当前在线的玩家
- 更多平台支持 — 计划在未来版本中移植到 Spigot/Paper 以及其他模组加载器,例如 Forge 和 NeoForge
当前功能
聊天桥接
- 在 Minecraft 中发送的消息会显示在 Discord 中,在 Discord 中发送的消息会显示在 Minecraft 中
玩家事件
- 加入与离开通知
- 死亡消息:普通死亡显示 🪦,PvP 击杀显示 ⚔️
- 进度通知
机器人状态
- 机器人状态显示实时玩家数量(例如
3/20 players online) - 频道主题显示服务器在线状态与运行时长(例如
🟢 Server Online | Online since: 2026-04-19 03:46 UTC | Crashes: 2) - 服务器停止时,频道主题切换为
🔴 Server is offline | Crashes: X
崩溃与卡顿警报
- 服务器崩溃时 @ 一个可配置的角色 — 即使是被看门狗(watchdog)终止也能生效
- 当服务器日志出现
Can't keep up!时 @ 一个可配置的角色,带有 60 秒冷却时间以防止刷屏 - 崩溃计数器在重启后仍会保留
白名单命令
/whitelist add <username>— 白名单频道中的任何人都可以添加自己/whitelist remove <username>— 仅限拥有所配置警报角色的用户使用
设置
- 创建 Discord 机器人
- 前往 https://discord.com/developers/applications 并创建一个新应用
- 前往 Bot 标签页并点击 Add Bot
- 在 Privileged Gateway Intents 下启用 Message Content Intent
- 复制你的机器人令牌 — 配置中需要用到它
- 使用
bot和applications.commands作用域邀请机器人加入你的服务器,并授予其读取/发送消息和管理频道主题的权限(不推荐,但如果你遇到任何问题,可以给机器人授予管理员权限)
- 配置模组
运行服务器一次后,会在
config/discordfabric.json生成配置文件。填入你的值:
配置字段
botToken— 你的 Discord 机器人令牌chatChannelId— 用于聊天桥接和常规通知的频道 IDwhitelistChannelId— 允许使用/whitelist命令的频道 IDalertRoleId— 用于崩溃和卡顿警报时 @ 的角色 ID。同时控制谁可以使用/whitelist remove
获取 ID 你需要在 Discord 中启用 开发者模式 才能复制 ID。前往 设置 → 高级 → 开发者模式,然后右键点击任意频道或角色并点击 复制 ID。
自定义消息
messages 部分中的所有消息模板均可完全自定义。可用的占位符:
{player}— 加入、离开、死亡消息{message}— 聊天桥接{user}— Discord → Minecraft{online}— botStatus{max}— botStatus{online_since}— channelTopic{crashes}— channelTopic{advancement}— playerAdvancement
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。