Home
  • English

    • 快速开始

    1、本地服务端文件下载

    ⚠️重要说明：

    因为UE5商城对于第三方应用的文件下载限制，UECopilot的本地服务端在运行前还需要额外下载修复文件覆盖。

    1、下载链接：百度云盘

    2、打开你引擎下插件Marketplace目录，将压缩包解压的server文件夹解压到下方路径粘贴并且覆盖 [YourEngineInstallPath]\UE_5.7\Engine\Plugins\Marketplace\UECopilo_xxxxxxx_V1\Source\ThirdParty

    有时候，商城下载的插件目录类似UECopiloa5c1efbc4ab4V1，中间可能有随机字符串，请仔细比对一下。 如果是项目插件目录则上述插件起始位置为[YourEngineProjectPath]\Plugins\UECopilot\Source\ThirdParty ![[Pasted image 20260528212227.png]]

    2、Nodejs环境安装

    插件自动配置环境

    首次下载插件后，需要在项目运行后检查是否安装 Node.js 环境，因为本插件的前端服务需要使用Node.js 的第三方程序支持。 ![[Pasted image 20260429103041.png]]

    Node.js 是一个基于 Chrome V8 引擎的JavaScript 运行时环境。简单说：让 JavaScript 脱离浏览器，能在电脑 / 服务器端直接运行。

    你会看见下载提示如下图 ![[Pasted image 20260429103332.png|300]]

    接着是解压环境 ![[Pasted image 20260429103343.png|300]]

    最后提示环境安装完毕 ![[Pasted image 20260429103428.png|300]]

    手动配置环境

    如果自动下载等待时间过长，也可以尝试手动配置环境：

    • 1.前往 Nodejs 官网：https://nodejs.org/en/download
    • 2.下载v22版本的独立安装包node-v22.22.2-win-x64.zip ![[Pasted image 20260501095407.png]]
    • 3.打开你引擎下面目录位置[YourEngineInstallPath]\UE_5.7\Engine\Plugins\UECopilot\Source\ThirdParty，解压node-v22.22.2-win-x64.zip 并且改名目录为node (如下图所示) ![[Pasted image 20260501100241.png]]

    在UE5顶部菜单栏->UECopilot-> Open UECopilot ,找到并打开它 ![[Pasted image 20260429103719.png]]

    也可以在ToolBar 找到它的快捷启动按钮 ![[Pasted image 20260429103943.png]]

    3、大模型APIKey配置

    点击设置按钮 ![[Pasted image 20260429104227.png|500]]

      1. 选择模型服务商
      1. 输入 API Key
      1. 设置默认对话模型（请选择正确对话模型） ![[Pasted image 20260518083802.png|500]]

    注意，如果对话选择了没有授权的APIKey的模型，会提示API授权错误。

    本插件完全本地服务，不提供模型服务，也不会泄露个人APIKey，用户需要额外为自己调用模型服务付费，申请各个厂商APIKey，请参考各个厂商官网流程介绍获取。

    4、本地大模型配置

    如果你有本地大模型服务也是可以接入的，下面一Ollama本地模型接入作为参考 首先确保你的ollama服务在本地运行启动后，查看ollama 目前已有模型清单

    ollamma list

    ![[Pasted image 20260429105340.png]]

    1。然后选择 OpenAI 服务商， 2。EndPoint 下填写 http://localhost:11434 3。OpenAI API Key : 随便添加不为空即可 4。Custom Models ： 填写 ollamma list 指令下能查找到的模型名称，使用","分割 ![[Pasted image 20260429105600.png]]

    5。最后你就可以在对话时选择本地模型对话聊天了 ![[Pasted image 20260429105920.png]]

    5、MCP工具查询

    UECompilot是基于大模型分析能力+蓝图MCP工具，实现对项目资源的分析和生成任务。 ![[Pasted image 20260429125156.png|500]]

    查看 当前插件现有的MCP工具方便你了解UECompilot边界

    插件任然在持续开发中，后期会拓展更多工具拓展其能力边界，敬请期待。 ![[Pasted image 20260429125259.png|500]] 详细介绍可以具体参看UECompilot Documentation文档

    6、Chat 功能介绍

    所有的操作均使用对话模式实现。 对话栏功能按钮功能介绍（由左往右）：

    1. Prompts : 收录了一些快捷提示词指令，可以快速填充一些标准查询提示词实现快速的工具调用或者项目分析（用户也可以在设置里可以添加自定义提示词）。
    2. Clear Context: 添加上下文清除符号，可以确保在较长的的对话框内，隔断对话记录减少大模型的上下文记忆长度。
    3. Chat Models：切换和选择当前对话需要调用的大模型。
    4. 快捷键示例图。
    5. 主题样式切换。
    6. Settings:当前对话的一些参数设置

    ![[Pasted image 20260429125736.png]]

    常见问题与故障排除

    1. 启动问题

    服务启动失败，无法打开插件页面 关闭插件UI后，在UE5菜单栏：UECopilot->RestartServer 尝试重新启动服务器。再尝试打开插件页面。 如果还是没有反应可以尝试重启UE5编辑器 ![[Pasted image 20260429103719.png]]

    2. 聊天中断或者停止

    在对话过程中，如果偶遇对话非正常中断或者停止，可以在输入框填入 “继续” 来恢复当前对话（每个会话都有历史记忆，如果有新任务请重新创建对话任务）。 ![[Pasted image 20260508114158.png|300]]

    3. 操作问题

    Q: 操作蓝图后没有生效

    1. 检查操作返回的 JSON 中 saved 字段是否为 true
    2. 在编辑器中手动保存资产（Ctrl+S）
    3. 重新打开蓝图图查看变更

    Q: 蓝图编译出现错误 4. 使用 validate_blueprint 工具查看具体错误信息 5. 如果有快照，使用 restore_graph 恢复 6. 或在编辑器中使用 Ctrl+Z 撤销

    Q: AI 无法找到指定的蓝图 7. 确保蓝图名称正确（区分大小写） 8. 使用 list_blueprints 工具查看所有可用蓝图 9. Level Blueprint 需要通过地图名引用

    4. 已知限制

    类别限制说明影响程度
    多用户服务为单用户设计，不支持多人同时操作⚠️ 中
    版本兼容基于 UE5.4+ API，未在 UE4 测试⚠️ 高
    平台SEH 保护仅限 Windows；材质系 SEH 有专用实现⚠️ 中
    热重载插件模块热重载后需要重新连接⚠️ 低
    大项目上万个蓝图的超大项目首次扫描可能耗时数秒⚠️ 中
    编译安全蓝图编译触发完整编译链，复杂蓝图可能耗时⚠️ 中
    AI 理解AI 模型对 UE 图结构、引脚类型的理解有其局限性⚠️ 需注意

    5. 不支持的场景

    1. C++ 代码操作：只能操作蓝图和资产，不能创建或修改 C++ 代码文件
    2. 运行时调试：不支持断点、单步执行等调试功能
    3. 多用户协作：无并发控制机制，不适合多人同时操作同一蓝图
    4. 内容迁移：不支持跨项目的内容迁移
    5. 源码控制集成：不直接与 Perforce/Git/SVN 交互
    6. 打包构建：不支持打包、烘焙等构建流程
    7. 关卡编辑：不直接支持关卡中的 Actor 放置和编辑（计划中）
    8. 数据表操作：暂时不支持 DataTable/CurveTable 的编辑
    9. Niagara 系统：不支持 Niagara 粒子系统的操作
    10. UI/UW 编辑：不支持 Widget Blueprint 的编辑

    6. 安全边界

    
✅ 可以做的：
   · 读取/创建/修改蓝图资产
   · 读取/创建/修改材质资产
   · 读取/创建/修改动画蓝图
   · 创建结构体和枚举
   · 进行安全快照和恢复
   · 在编辑器中使用 Ctrl+Z 撤销
  
❌ 不应做的：
   · 在无版本控制的情况下批量修改
   · 依赖 AI 完全理解复杂图结构的语义
   · 跳过测试在关键节点上直接使用

⚠️ 需要谨慎的：
   · 修改已有蓝图的父类（可能导致大量断连）
   · 批量重命名/删除资产
   · 修改变量类型（可能断开现有连接）
   · 在动画蓝图状态机中大规模修改

    能力统计总表

    概览数据

    统计项数值
    MCP 工具总数80+
    能力域9 大类
    支持的资产类型Blueprint, Material, MaterialInstance, MaterialFunction, AnimBlueprint, UserDefinedStruct, UserDefinedEnum, BlendSpace

    类型支持覆盖

    蓝图引脚类型支持状态
    boolean, byte, int, int64, float, double, name, string, text✅ 完整
    object, softobject, class, softclass, interface✅ 完整
    struct (Vector, Transform, Rotator, Color 等)✅ 完整
    enum✅ 完整
    array, set, map✅ 基础支持
    delegate, mcdelegate✅ 基础支持

    结语

    UECopilot 的目标是让 AI 成为 UE5 开发者的得力副驾——不是替代你的判断力，而是帮助你更快地完成重复性工作、减少人为失误、并在大型项目中保持操作的准确性和可追溯性。

    给用户的建议：

    • 从小处开始：先在简单的蓝图上试用
    • 善用快照：任何重大操作前先做快照
    • 渐进式使用：从读取 → 简单修改 → 复杂创建，逐步深入
    • 保持反馈：遇到问题请提供详细日志，帮助插件持续改进

    UECopilot - 让 Unreal Engine 开发插上 AI 的翅膀