原创 工具 ArkPilot - Minecraft 服务器 AI 助手插件 1.0.0

ArkPilot 是什么？
ArkPilot 是一个面向 Minecraft Java 服务器的 AI 助手插件，目标是让服务器拥有可以自然对话、理解服务器资料、记住玩家偏好，并在权限控制下调用工具的智能助手。
它不是单纯的“聊天机器人”：ArkPilot 内置多助手、长期记忆、技能文档、工具执行、NPC 对话绑定、扩展包和扩展市场机制，适合用于生存服、RPG 服、剧情服、建筑服的玩家引导、问答、活动氛围和自动化协作。
主要特性
• 多助手系统：可配置多个 AI 助手，每个助手拥有独立人格、模型、技能、工具和触发词。
• 多模型兼容：支持 Anthropic / OpenAI / Google / DeepSeek / MiniMax / 阿里百炼，以及 OpenAI/Anthropic 兼容接口。
• 长期记忆：助手可记住玩家偏好、事件、待办等信息，跨会话保留上下文。
• 技能文档系统：把服务器规则、玩法说明、经济系统、领地说明等写成 Markdown，助手可按需检索。
• 工具调用：支持读取记忆、写入记忆、查询在线玩家、发送玩家消息、广播、执行命令、调用子助手等。
• 安全确认：高风险工具可要求玩家点击确认后再执行。
• NPC 对话：可选绑定 Citizens / Adyeshach NPC，让玩家右键 NPC 与助手交流。
• 扩展系统：支持 JAR 扩展包、纯文件扩展包、外部脚本工具和插件 API。
• 可插拔存储：支持文件 / MySQL / PostgreSQL。
内置/配套扩展示例
• building：建筑蓝图生成、预览和逐层建造相关助手与工具。
• allay：基于心跳的服务器活动观察和主动互动助手。
• chemdah：将 Chemdah NPC 对话接入 AI 生成对话树（需要 Chemdah）。
环境要求
• 服务端：Paper 1.20.4+，或 Purpur 等 Paper Fork
• Java：Java 8+，推荐 Java 17+
• 模型：至少配置一个 LLM API Key
• 可选依赖：Citizens / Adyeshach / Chemdah
快速安装
1. 将 ArkPilot-1.0.0.jar 放入服务器 plugins/ 目录。
2. 启动服务器，等待生成 plugins/ArkPilot/ 配置目录。
3. 编辑 plugins/ArkPilot/models.yml，填入至少一个 API Key。
4. 编辑 plugins/ArkPilot/SERVER.md，写入服务器规则、玩法、经济、常见问题等资料。
5. 执行 /ark reload 或重启服务器。
6. 玩家在聊天栏输入 @helper 你好，即可开始对话。
推荐使用环境变量保存 API Key，避免直接写入配置文件。
常用命令
• /ark - 打开助手管理菜单
• /ark gui - 打开助手管理菜单
• /ark retry - 重试上一条消息
• /ark reload - 重载配置
• /ark market - 浏览扩展市场
• /ark market install <id> - 安装扩展包
权限说明
• arkpilot.use - 基本使用权限
• arkpilot.admin.reload - 重载配置
• arkpilot.admin.status - 查看系统状态
• arkpilot.admin.market.install - 安装/卸载市场扩展
• arkpilot.tool.execute-command - 允许助手通过工具执行命令
• arkpilot.tool.broadcast-message - 允许助手广播消息
• arkpilot.tool.send-player-message - 允许助手发送玩家消息
• arkpilot.tool.list-online-players - 允许助手查询在线玩家
安全提醒
ArkPilot 涉及 AI 工具调用，建议服主首次使用时先关闭或限制高风险工具，尤其是 execute-command。所有涉及命令执行、广播、玩家消息等能力都应通过权限节点和确认机制控制。
API Key 请优先使用环境变量，不建议直接公开写在配置文件里。
问题反馈
如在使用中遇到问题，欢迎加入 QQ 群 1026156463 反馈。
当前版本
当前发布版本：1.0.0
这是首个公开发布版本，建议先在测试服中配置模型和权限后再部署到正式服。