扩展模块
ArkPilot 通过扩展包(Expansion)系统提供可插拔的功能模块。扩展包可以注册工具、技能、助手和命令,为服务器增添丰富的 AI 能力。
内置扩展包
ArkPilot 自带两个内置扩展包,开箱即用:
| 扩展包 | ID | 功能 |
|---|---|---|
| 建筑系统 | building | AI 生成建筑蓝图,逐层动画建造,蓝图分享 |
| 活动追踪 | allay | 心跳驱动的服务器活动追踪与自动互动 |
| NPC 对话 | chemdah | 将 Chemdah NPC 对话替换为 AI 自由对话,支持任务发放 |
第三方扩展包
除内置扩展包外,你还可以安装来自扩展市场的第三方扩展包,或自行开发扩展包。
安装方式
- 扩展市场安装:在游戏内执行
/ark market,浏览并一键安装 - 手动安装:将扩展包 JAR 放入
plugins/ArkPilot/expansions/目录,重启服务器或执行/ark reload
扩展包形式
扩展包分两种形式,加载后完全等价:
| 形式 | 位置 | 特点 |
|---|---|---|
| JAR 扩展包 | expansions/*.jar | 含代码逻辑 + 配置文件 |
| 纯文件扩展包 | expansions/*/ 目录 | 仅配置文件,无代码 |
JAR 扩展包首次加载时会将 assistants/ 和 skills/ 释放到磁盘目录,已存在的文件不覆盖,服主可自由编辑。
管理扩展包
yaml
# tools.yml
expansions:
enabled: true # 总开关执行 /ark reload 可热重载所有扩展包。
开发自己的扩展包
如果你想开发自定义扩展包,请参阅扩展开发指南。