执行命令失败

适用范围

此问题仅发生在 Bukkit 插件版本的 EasyBot 上。
如果你使用的是 Velocity 或 Mod 服务端（如 Forge、Fabric），它们原生支持命令执行，不会出现此问题，请勿按本教程操作。

遇到以下任一种情况，本教程都能帮你解决

• 控制台显示"执行命令失败" — EasyBot 无法向服务器发送指令
• 报错 Can not find runCommand method — 找不到可用的命令执行方法
• 报错 wrong number of arguments — 命令参数传递方式不兼容
• 执行什么命令都显示 执行成功 - 无法获取返回结果

问题原因

Bukkit 开源生态中存在大量服务端分支（如 Spigot、Paper、Purpur 等），不同分支对命令执行的实现方式各不相同。EasyBot 无法在所有分支上都找到统一的执行命令方法，因此需要通过 RCON 来间接执行命令。

什么是 RCON？

RCON（Remote Console）是 Minecraft 服务端内置的远程管理协议。它允许外部程序通过网络连接到你的服务器控制台，像在服务器后台一样执行命令。你可以把它理解为服务端的一个"远程管理员通道"。

操作步骤

安全提醒

RCON 密码相当于你服务器的管理员权限，请使用足够复杂的密码（包含大小写字母和数字），绝对不要使用 1234、password 这类弱密码，防止他人远程操控你的服务器。

第一步：在服务器端开启 RCON

1. 停止你的 Minecraft 服务器
2. 用文本编辑器打开服务器根目录下的 server.properties 文件
3. 修改以下两项配置（如果不存在可以手动添加）：

enable-rcon=true
rcon.password=你的密码

配置项	说明
enable-rcon	改为 true，开启 RCON 功能
rcon.password	设置一个强密码，EasyBot 将使用此密码连接

4. 保存文件并重启你的 Minecraft 服务器

第二步：修改 EasyBot 插件配置

1. 打开 EasyBot 插件目录下的 config.yml 文件
2. 找到 adapter.native_rcon 配置段，修改为如下内容：

adapter:
  native_rcon:
    use_native_rcon: true   # 改为 true 启用原生 RCON
    address: "127.0.0.1"    # 服务器地址（本机保持默认）
    port: 25575             # RCON 端口（与 server.properties 一致）
    password: "你的密码"     # 请输入你在 server.properties 中设置的密码

3. 保存文件

第三步：验证连接

重启 Minecraft 服务器和 EasyBot，观察 EasyBot 的日志输出。如果看到以下信息，说明配置成功：

【原生RCON接口】连接成功

如果仍然失败，请检查：

• 服务器是否已重启（配置需要重启才能生效）
• server.properties 中的 rcon.password 是否与 config.yml 中的密码完全一致
• 端口 25575 是否被防火墙阻止