| 中文名: | Kilacraft-AI |
|---|---|
| 外语名: | Kilacraft-AI |
| 支持版本: | 1.16.x 1.17.x 1.18.x 1.19.x 1.20.x 1.21.x 26.x |
| 适用服务端: | CraftBukkit Spigot Paper |
| 插件属性: | 本体插件 |
| 插件类型: | 聊天 娱乐 信息 其他 |
| 前置插件: | 无前置 |
| 来源: | 原创 |
| 原帖地址: | - |
| 下载地址: | https://gitee.com/zm_mmm/kilacraft-ai/releases |
| 最后更新: | 2026-04-07 |
|
本帖最后由 Zm_Mmm 于 2026-4-12 02:11 编辑 Kilacraft-AI - 专为 Minecraft 服务器打造的轻量级 AI Agent 【v1.4.3 正式发布】零依赖 · 低内存 · 高性能 · 易扩展 · 完全开源 ================================================== 💎 核心优势 ==================================================
================================================== 🌐 项目地址与联系方式 ==================================================
💡 欢迎 Star ⭐、Fork 🔀 和提交 Issue/Pull Request！ ================================================== 📦 依赖要求与兼容性 ================================================== ✅ 版本兼容性 最低兼容版本：Minecraft 1.16.5 + Java 17 Kilacraft-AI 基于 Spigot 1.16.5 API 开发，一套 JAR 包兼容所有后续版本。
🎁 可选依赖 以下插件未安装时对应功能自动禁用，不影响核心对话功能：
================================================== 🌟 功能展示 ================================================== 1️⃣ 智能对话系统 三种交互模式，满足所有场景： 命令模式（适合偶尔询问）
连续对话模式（适合深度交流）
关键词触发（适合公共频道）
-------------------------------------------------- 2️⃣ 知识库增强（RAG 检索） 让 AI 了解你的服务器规则、玩法、FAQ！ 使用方法：
示例文件 (server_rules.md)：
智能检索效果：
技术优势：
自定义词典配置（config.yml）：
💡 提示：将服务器特有的游戏术语添加到自定义词典中，可以显著提升 AI 对玩家问题的理解准确度。 -------------------------------------------------- 3️⃣ LLM 智能意图识别 + 多步骤任务编排 Kilacraft-AI 不是简单地"回答问题"，而是理解你的真实意图并自动调用对应功能！ 工作流程： 用户输入 → LLM 意图识别 → 判断任务类型 → 执行技能/任务 → 分析结果 → 生成回复 两种任务模式：
配置灵活可控：
失败回退机制： 如果意图识别失败或技能执行出错，系统会自动回退到普通 AI 对话，返回有意义的错误消息而非技术性报错。 -------------------------------------------------- 4️⃣ 插件命令模式 + 人格系统（高级功能） 插件命令模式是 Kilacraft-AI 为第三方插件集成设计的专用接口，允许其他插件通过控制台以指定的人格调用 AI。 基本用法：
典型应用场景（NPC 智能对话）： 让 MythicMobs NPC 拥有不同性格，与玩家自然交流。
💡 提示：如果你是第三方插件开发者，建议先阅读 [插件命令模式详解](./插件命令模式详解) 文档，了解完整的集成流程和最佳实践。 -------------------------------------------------- 5️⃣ 经济系统集成（GlobalMarketPlus） 让你的市场插件“会说话”！通过自然语言查询市场信息。 特色功能：自然语言理解、多物品联合查询、最优价格计算、库存不足提示。 安全说明：只读操作，不会消耗物品或金钱。 -------------------------------------------------- 6️⃣ Bukkit API 动态调用（37 个内置 API） 无需写代码，AI 直接调用原版 API 查询玩家状态、世界信息、服务器信息！ 支持的 API 类别：
权限精细控制：
================================================== ⚙️ 快速开始（5 分钟上手） ================================================== 第一步：安装插件
第二步：配置 API 密钥 编辑 plugins/Kilacraft-AI/config.yml：
获取 API Key：
第三步：重载配置 /kilacraft reload # 重载主配置和语言配置 第四步：测试对话 /kila 你好 如果看到 AI 回复，恭喜！配置成功！🎉 ================================================== 📊 性能与资源占用 ================================================== 内存占用对比：
结论：即使千人在线，对话历史占用也不到 10 MB！ 性能优化措施：
================================================== 🎮 完整命令列表 ==================================================
================================================== 🔧 高级配置详解 ================================================== 1. Agent 能力配置
2. 知识库分段配置
3. 语言自定义 所有系统提示文本都可以在 language.yml 中自定义，支持颜色代码（§）和变量占位符（{player}, {seconds}）。 4. 人格系统配置
================================================== ⚠️ 安全与权限管理 ================================================== 内置 Skill 安全性： Kilacraft-AI 内置的所有 Skill 都遵循安全第一原则：
第三方 Skill 风险提示： 如果你安装了第三方插件开发的 Skill，请注意审查来源，并在测试环境验证功能是否正常、安全。 ================================================== ❓ 常见问题 FAQ ================================================== Q1: API 费用高吗？ A: 取决于使用频率。以 DeepSeek 为例，单次对话约消耗 500-1000 Token（约 0.001-0.002 元）。建议设置合理的冷却时间防止滥用。 Q2: 支持哪些 LLM 厂商？ A: 支持所有遵循 OpenAI 标准 API 格式的厂商（DeepSeek, 智谱 AI, Moonshot 等）。只需修改 config.yml 中的 api_url 和 model 即可切换。 Q3: 会不会卡顿服务器？ A: 不会。插件采用异步非阻塞执行，HTTP 连接池复用，且内存占用极低（8-50 MB）。 Q4: 如何保证数据安全？ A: API Key 存储在本地配置文件，对话历史仅保存在内存中（重启清空），支持世界限制和精细的权限控制。 Q5: 支持离线玩家对话吗？ A: 普通对话模式不支持。但插件命令模式支持！控制台可以通过 /kilacraft plugins 命令代为调用，即使玩家离线也可以生成 AI 回复。 ================================================== 🐛 故障排除 ================================================== AI 不回复：
知识库检索不准确：
================================================== 🤝 支持与贡献 ================================================== 如果 Kilacraft-AI 帮助到了你，可以考虑支持项目的持续发展：
我们欢迎社区贡献！如果你有任何建议或发现问题：
================================================== 🔗 相关链接 ==================================================
最后更新: 2026-04-07 |
提升卡
观察者