Skip to content

扩展模块

ArkPilot 通过扩展包(Expansion)系统提供可插拔的功能模块。扩展包可以注册工具、技能、助手和命令,为服务器增添丰富的 AI 能力。

内置扩展包

ArkPilot 自带两个内置扩展包,开箱即用:

扩展包ID功能
建筑系统buildingAI 生成建筑蓝图,逐层动画建造,蓝图分享
活动追踪allay心跳驱动的服务器活动追踪与自动互动
NPC 对话chemdah将 Chemdah NPC 对话替换为 AI 自由对话,支持任务发放

第三方扩展包

除内置扩展包外,你还可以安装来自扩展市场的第三方扩展包,或自行开发扩展包。

安装方式

  1. 扩展市场安装:在游戏内执行 /ark market,浏览并一键安装
  2. 手动安装:将扩展包 JAR 放入 plugins/ArkPilot/expansions/ 目录,重启服务器或执行 /ark reload

扩展包形式

扩展包分两种形式,加载后完全等价:

形式位置特点
JAR 扩展包expansions/*.jar含代码逻辑 + 配置文件
纯文件扩展包expansions/*/ 目录仅配置文件,无代码

JAR 扩展包首次加载时会将 assistants/skills/ 释放到磁盘目录,已存在的文件不覆盖,服主可自由编辑。

管理扩展包

yaml
# tools.yml
expansions:
  enabled: true   # 总开关

执行 /ark reload 可热重载所有扩展包。

开发自己的扩展包

如果你想开发自定义扩展包,请参阅扩展开发指南。

ArkPilot — Minecraft AI Assistant Plugin