跨平台绑定
概述
自 EasyBot 2.1.1-dev.1 起,系统引入了 多适配器(Multi-Adapter) 支持。用户在同一套 EasyBot 实例中,可以按需配置多个不同的机器人适配器(例如 Telegram、Milky 等),实现单套系统同时对接多个社交平台。
多适配器的引入带来了一个新的问题:如何将同一个玩家的多个社交平台账号关联到同一个游戏身份下? 跨平台绑定机制正是为了解决这一问题而设计的。
核心规则
跨平台绑定遵循以下约束:
- 一个玩家可以绑定多个平台的账号。 例如,玩家
Steve可以同时绑定一个 QQ 账号和一个 Telegram 账号。 - 一个玩家不能绑定同一平台的多个账号。 例如,玩家
Steve不能同时绑定两个不同的 QQ 号。 - 同一平台共享绑定约束。 Milky 协议与 OneBot 11 协议同属 QQ 平台,因此通过这两个适配器接入的账号被视为同一平台。无论玩家使用 Milky 适配器还是 OneBot 11 适配器连接到 EasyBot,系统均将其识别为同一个 QQ 账号,不可重复绑定。
上述约束为系统级硬限制。若尝试将同一平台的第二个账号绑定到已有该平台绑定的玩家,操作将被拒绝。
支持的服务端实现
跨平台绑定功能的可用性取决于服务端插件 / Mod 的实现情况:
| 实现类型 | 是否支持 |
|---|---|
| Mod 版(Fabric / Forge) | ✅ 支持 |
| 插件版(Bukkit / Spigot / Paper 等) | ✅ 支持 |
| MCDR(MCDReforged) | ❌ 即将支持 |
| Velocity | ❌ 即将支持 |
绑定流程
方式一:游戏内发起(验证码模式)
这是跨平台绑定的主要方式,由玩家在游戏内主动发起:
- 玩家在游戏中执行
/easybot bind命令。 - 系统为该玩家生成一个跨平台绑定验证码。
- 玩家在目标平台(例如 Telegram 群聊)中使用该验证码完成绑定。
- 绑定成功后,该平台账号即关联至当前玩家身份。

验证码具有时效性,过期后需重新生成。
方式二:社交平台信任模式
在已启用社交平台信任模式的群聊中,玩家可以通过以下方式触发跨平台绑定:
- 在群内发送
<绑定关键词> <玩家名>。 - 系统检测到该玩家已绑定其他平台的账号,自动启动跨平台绑定任务。
- 游戏服务器内的被绑定玩家将收到一条确认消息,可直接点击确认完成绑定。
- 玩家亦可使用其已绑定的其他平台账号,在群内 发送
确认绑定 <验证码>来完成确认。
双向验证码模式(在群内输入验证码完成绑定)暂不支持跨平台场景。跨平台绑定的群侧确认仅支持上述的信任模式 + 验证码确认方式。

绑定状态查询
跨平台绑定完成后,玩家可通过以下方式查看当前绑定状态:
- 游戏内查询:执行
/easybot status命令查看已绑定的所有平台账号。 - 群内查询:在任意已绑定群聊中发送
我的绑定关键词查询当前账号关联的玩家身份及其跨平台绑定情况。

解绑与跨平台影响
当玩家解除某个平台的绑定时:
- 仅移除该平台账号与玩家的关联,不会影响该玩家在其他平台上的绑定关系。
- 若玩家在强制绑定服务器中解绑了唯一绑定的账号,将触发强制绑定踢出机制(详见绑定功能文档)。
- 解绑操作后,该平台账号可重新绑定到其他玩家,或重新绑定回原玩家。
常见问题
为什么 Milky 和 OneBot 11 不能同时绑定?
Milky 与 OneBot 11 均为 QQ 平台的适配器协议。无论用户通过哪种适配器将 QQ 机器人接入 EasyBot,其底层对应的均为同一个 QQ 号。因此系统将其视为同一平台账号,不允许在同一玩家下重复绑定。
跨平台绑定后,命令和事件如何响应?
跨平台绑定不会改变命令和事件的响应逻辑。系统会根据消息来源的平台和群聊,正确路由命令执行结果与事件通知。 例如,绑定了 QQ 和 Telegram 的玩家,在两个平台上均能收到与其游戏账号相关的通知(具体通知范围取决于命令的作用域配置)。
为什么 MCDR / Velocity 不支持跨平台绑定?
跨平台绑定依赖服务端实现提供的特定 API 接口,用于在游戏内发送确认消息并接收玩家的确认操作。目前相关接口仅在 Mod 版和插件版中实现,MCDR 与 Velocity 暂未适配。后续版本将根据优先级逐步完善支持。

少年,买服务器吗?
持证经营专注高性价比游戏云VPS,铂金 / I7 / R9 / 物理机
💰 最低六元起、买不了吃亏买不了上当,快来看看吧~