兰的简易Discord:桥接+

兰的简易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> — 仅限拥有所配置警报角色的用户使用

设置

  1. 创建 Discord 机器人
  • 前往 https://discord.com/developers/applications 并创建一个新应用
  • 前往 Bot 标签页并点击 Add Bot
  • 在 Privileged Gateway Intents 下启用 Message Content Intent
  • 复制你的机器人令牌 — 配置中需要用到它
  • 使用 bot 和 applications.commands 作用域邀请机器人加入你的服务器,并授予其读取/发送消息和管理频道主题的权限(不推荐,但如果你遇到任何问题,可以给机器人授予管理员权限)
  1. 配置模组 运行服务器一次后,会在 config/discordfabric.json 生成配置文件。填入你的值:

配置字段

  • botToken — 你的 Discord 机器人令牌
  • chatChannelId — 用于聊天桥接和常规通知的频道 ID
  • whitelistChannelId — 允许使用 /whitelist 命令的频道 ID
  • alertRoleId — 用于崩溃和卡顿警报时 @ 的角色 ID。同时控制谁可以使用 /whitelist remove

获取 ID 你需要在 Discord 中启用 开发者模式 才能复制 ID。前往 设置 → 高级 → 开发者模式,然后右键点击任意频道或角色并点击 复制 ID。

自定义消息

messages 部分中的所有消息模板均可完全自定义。可用的占位符:

  • {player} — 加入、离开、死亡消息
  • {message} — 聊天桥接
  • {user} — Discord → Minecraft
  • {online} — botStatus
  • {max} — botStatus
  • {online_since} — channelTopic
  • {crashes} — channelTopic
  • {advancement} — playerAdvancement