在模组服上使用

介绍

警告

模组目前只有RC版本,这表示这是一个测试版本,可能会有一些bug

反馈

如果您在使用Mod时遇到了任何异常、错误或问题,请及时反馈给我们。您可以通过以下方式联系我们

• 提交Issue(推荐)
• 加群反馈

信息

EasyBot现在发布模组版、支持Fabric、NeoForge、Forge。

加载器	MC版本
Fabric	1.20.1 - 1.21.11
NeoForge	1.20.4 - 1.21.11
Forge	仅1.20.1

关于Forge为什么只支持1.20.1

• Forge的构建工具(FG6)不支持Gradle9.0+但本模组依赖的多模组加载器工具需要Gradle9.0+故无法使用
• 但是考虑到1.20.1经典模组比较多本模组使用了NeoForge提供的LegacyForge构建1.20.1版本

会有高版本的Forge模组吗?

• 目前ForgeGradle的开发者正在开发支持Gradle9.0+的全新版本构建工具FG7
• 该构建工具目前处于早期开发阶段、经本模组作者考虑后决定等FG7正式版发布后再进行对Forge高版本的支持

会有低版本模组吗?

• 不会有

支持PlaceholderAPI吗?

• 是的,我们内置了一个全Loader可用的基础占位符解析器,它允许你在不安装任何额外模组的情况下使用与Bukkit版占位符插件的部分功能
• 目前已内置 数学表达式 变量和 玩家状态变量 详见: 占位符数学运算、玩家状态变量

下载模组

警告

请根据您的加载器选择对应的模组依赖，确保在加载之前安装正确的依赖!!

---

Fabric 模组下载

点我下载Fabric版本模组

模组依赖

模组	版本	必须	描述
FabricApi	任意	✅ 必须安装	Fabric版模组利用FabricApi来监听各种事件，你必须安装此模组
TextPlaceholderApi	任意	❌	这是一个Fabric版的占位符解析器，安装此模组后可以扩展变量功能
GeyserFabric	任意	❌	支持基岩版玩家相关设置
FloodgateFabric	任意	❌	支持基岩版玩家相关设置

---

NeoForge 模组下载

点我下载NeoForge版本模组

模组依赖

模组	版本	必须	描述
GeyserNeoForge	任意	❌	支持基岩版玩家相关设置
FloodgateNeoForge	任意	❌	支持基岩版玩家相关设置

---

Forge 模组下载

点我下载Forge版本模组

模组依赖

有个蛋

---

安装模组

注意

安装教程全版本通用

1.下载并且安装

将下载好的模组放入mods文件夹后启动服务端、等待模组加载完毕

乱码问题

如果你启动服务器发现EasyBot日志输出乱码,请在你的启动脚本中将控制台编码设置为UTF-8,在服务器启动脚本前面添加下面的内容

CMD

chcp 65001

POWER SHELL

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

在安装好mod后启动服务器,你会看到如下日志:

打开日志中提到的配置文件,你需要配置token

2.1.在软件添加服务器

回到主程序的服务器列表，点击 +添加 添加服务器。

2.2.在插件配置token

将Token复制到配置文件中并保存，此时服务器会自动重载配置文件

---

恭喜 你已经成功安装并配置了EasyBot插件

配置介绍

{
  // 插件 Token
  "token": "YOUR_TOKEN_HERE",
  // 插件与软件通信的 WebSocket 地址，一般不需要修改
  "ws": "ws://127.0.0.1:26990/bridge",
  // 是否开启调试模式，开启后会输出更多日志，反馈 Bug 必须开启
  "debug": false,
  // 是否忽略错误，开启后在插件未连接到主程序时也允许玩家进入服务器，而不是提示“内部错误”
  "ignoreError": false,
  // 消息配置
  "message": {
    // 开始绑定时的提示消息
    "bindStart": "§f[§a!§f] 开始绑定,请在群 §e123456 §f输入 '绑定 #code' 进行绑定! \n§f[§c!§f] 请在§a #time §f前完成验证,到时将自动取消绑定!",
    // 绑定成功时的通知消息
    "bindSuccess": "§f[§a!§f] 绑定§f §a#account §f(§a#name§f) 成功!",
    // 绑定失败时的通知消息
    "bindFail": "§f[§c!§f] §c绑定失败 #why"
  },
  // 命令配置
  "command": {
    // 是否允许使用命令绑定 (暂时无法禁用)
    "allowBind": true,
    // 执行异步命令的等待时间，超过此时间未收到结果将强制返回空信息 (单位：秒)
    "waitTime": 3
  },
  // 同步跳过选项
  "skipOptions": {
    // 是否跳过玩家加入事件
    "skipJoin": false,
    // 是否跳过玩家退出事件
    "skipQuit": false,
    // 是否跳过消息同步
    "skipChat": false,
    // 是否跳过玩家死亡事件
    "skipDeath": false
  },
  // Geyser 适配配置
  "geyser": {
    // 是否忽略基岩版玩家的命令前缀
    "ignorePrefix": false,
    // 是否使用基岩版玩家的真实 UUID (需要 Floodgate 模组)
    "useRealUuid": false
  },
  // 事件触发配置
  "event": {
    // 启用后，绑定成功会执行下面的指令
    "enableSuccessEvent": false,
    // 绑定成功时执行的指令列表，支持变量：$player(玩家名) $account(账号) $name(昵称)
    "bindSuccess": [
      "say 玩家$player绑定成功,Id=$account,账号名字=$name"
    ]
  }
}

命令列表

指令	权限	说明
/easybot status	管理员	查看插件状态
/easybot reload	管理员	重载插件配置
/easybot bind	所有人	开始绑定
/easybot say <消息内容>	所有人	手动触发消息同步(会受到主程序设置影响)

差异

得益于Minecraft开源社区的框架Stonecutter提供的能力，EasyBot才能够实现多个加载器的兼容，在此表示感谢。

模组版可以说是一个EasyBotBridge客户端的完整实现，他几乎可以做到和Bukkit版本一样的功能，只是在执行上有一些差异，如果你感兴趣可以查看下面的表格。

功能	描述	支持	区别
命令执行	执行Minecraft命令	是	与Bukkit版本不同的是，模组的命令执行无需任何额外配置, 你不需要配置RCON等相关内容 他"生来就会"
PlaceholderApi	替换变量	⚠不完全	其实大家常说的Papi都是指Bukkit的PlaceholderApi,他真的是一个非常重要的前置,可惜的是这个插件是专门为Bukkit开发的这意味着他将无法在模组端上工作, 不过EasyBot模组端现在内置了一个轻量化的Papi，能够实现和Bukkit版本相同的功能，内置了两个Bukkit版本中非常重要的变量,也算是补全了空缺: 玩家状态变量 数学计算变量
强制绑定	账号与游戏角色关联	是	针对 1.20.4+ 版本，利用麻将加入的新版握手协议（Handshake）实现异步验证，避免了旧版本（Bukkit/Mod）中因阻塞主线程导致的登录卡顿。