【教程】教你如何用机器人搭建高级命令系统！

Melibertan

今天手把手教大家如何用机器人框架搭建一个聊天触发命令系统： 第0步：下载DolphinBot（mc开源高级机器人框架） DolphinBot：https://github.com/NeonAngelThreads/DolphinBot DolphinBot下载：https://github.com/NeonAngelThreads/DolphinBot/releases 插件文档：https://github.com/NeonAngelThreads/DolphinBot/blob/master/PluginDocs.md 然后在你的项目中添加下载好的jar包添加为依赖： 为了开发的便利，后续计划将DolphinBot框架jar类库发布于Maven和Gradle的仓库，可以期待一下~ 搭建教程： 1.聊天命令： 第一步： 编写一个插件模板，你可以参照DolphinBot插件制作的详细教程和实例模板. 例如： package org.angellock.impl.extensions; import org.angellock.impl.AbstractRobot; import org.angellock.impl.events.handlers.LoginHandler; import org.angellock.impl.providers.AbstractPlugin; public class ExamplePlugin extends AbstractPlugin {   @Override   public String getPluginName() {     return "My First Plugin";   }   @Override   public String getVersion() {     return "1.0.0";   }   @Override   public String getDescription() {     return "Hello DolphinBot";   }   @Override   public void onDisable() {     getLogger().info("Disabling {} - {}", this.getName(), getVersion());     //Disable Message   }   @Override   public void onLoad() {     getLogger().info("Loading {} - {}", this.getName(), getVersion());     // Loading Plugin Message   }   @Override   public void onEnable(RobotPlayer entityBot) {   } } 复制代码 第二步： 在onEnable方法中添加命令绑定语句，在原文档中的代码： Command command = new CommandBuilder().withName('cmdtest').build((response) -> {}); 复制代码 这一行代码仅仅做了一个名为“cmdtest”的命令绑定，但没有具体操作。 @Override   public void onEnable(RobotPlayer entityBot) {     getCommands().register(new CommandBuilder().withName("test").allowedUsers("玩家1","玩家2").build((response) -> {       String[] subCommand = response.getCommandList(); // get command list contains main-command and sub-  command.                 getLogger().info(Arrays.toString(subCommand));    }));    } 复制代码 这个代码实现了当玩家输入了“!test”,就会在DolphinBot终端显示这个命令的信息，如发送者，参数列表。 你可以用.allowedUsers()方法来设置那些玩家可以使用这个命令，如果为空，默认允许全部玩家。 第三步： 然后为你的插件创建plugin.json plugin.json需要放在插件入口类的同目录： MyPlugin.jar     ├─plugin.json     └─org       └─me         └─plugin           └─MyPlugin.java</code></pre> 复制代码 plugin.json 用于指定插件的入口类、插件名称和版本。以下是配置 plugin.json 的示例： {        "entry": "org.me.plugin.MyPlugin",     "name": "MyPlugin",     "version": "1.0.0" } 第四步： 编译，打包为jar包，在你的项目添加一个Artifact配置，点击“+”，然后在右边添加“plugin.json”(非常重要) 和“complie output”这两个项： 将jar放入到/plugins文件夹下，由于DolphinBot是支持一次性启动多个机器人的，所以/plugins文件夹中有/bot#1 或/bot#2等等，这些文件夹是为了将插件单独给一个机器人加载的，比如我想把插件单独给bot#1加载，那就把插件放入 /plugins/bot#1/ 中，如果放入 /plugins/ 文件夹，代表这个插件将适用于全部机器人（全局插件）。 第四步： 启动DolphinBot，无需复杂配置，(配置文件会自动生成)，直接运行： java -jar "DolphinBot-[version]-full.jar" 复制代码 原作者开发也不易，喜欢的话，记得点个star哦！也方便研究代码

Melibertan

SuYuZe 发表于 2026-2-12 21:02
什么时候会出啊。。

目前基本逻辑已经实现，但原有的框架需要Tick同步，测试中考虑到二次开发API的易用性，目前已考虑在DolphinBot框架中集成Baritone的逻辑，而非使用多余插件。将会尽快实现此功能。

Melibertan

DolphinBot 1.4.1已发布！更新内容：
【+】添加了文件日志记录功能！并且支持归档功能，所有日志保存在botlogs文件夹中，默认保留7天。
【+】现在DolphinBot支持跨服通信，以下是利用此功能实现的登录服人数查询功能：


【!】修复了一个关键bug，在插件加载时，发现入口类的依赖类有概率加载失败，经过调试，发现原来是ClassLoader过早关闭，导致其他类都来不及加载。为了修复，已为每一个插件类都保存了一个ClassLoader对象，并在插件被禁用时才将ClassLoader关闭：
以下是代码变更：
PluginManager.java (插件管理器)

PluginLoader.java (插件加载器)

【+】更多更新日志，请看Release v1.4.1 · NeonAngelThreads/DolphinBot

Melibertan

1.4.2 即将发布，全面支持MySQL数据库连接，可以期待一下

SuYuZe

能出个珍珠bot插件吗

Melibertan

SuYuZe 发表于 2026-2-7 17:28
能出个珍珠bot插件吗

可以实现的，后续将会开源Dolphin PearlW插件，可以关注作者NeonAngelThreads以获得社区实时信息。

SuYuZe

Melibertan 发表于 2026-2-8 15:57
可以实现的，后续将会开源Dolphin PearlW插件，可以关注作者NeonAngelThreads以获得社区实时信息。 ...

什么时候会出啊。。

dishao

SuYuZe 发表于 2026-2-12 21:02
什么时候会出啊。。

目前这个需求可以考虑xinbot 已经有开发好的BackToTheBase插件 其他地形或移动需求也可以通过MovementSync二次开发

Melibertan

beta 1.4.0 网页管理器更新已发布