Repository navigation
中文摘要 / Summary
这是当前开源源码线的正式版本,面向 Unreal Engine 5.8 / Win64,版本号与 UmgMcp.uplugin 中的 1.0.12 保持一致。它包含可直接放入项目的预编译插件包,也保留 GitHub 自动生成的完整源码包。
This is the current open-source source-line release for Unreal Engine 5.8 / Win64. The release tag now follows the actual plugin descriptor version (1.0.12).
版本说明:早期 GitHub Release 使用了
v1.0–v3.0的旧营销版本线;v1.0.12是更新的实际插件版本,并取代历史v3.0成为 Latest Release。
更新内容 / What's changed
- 89 个 MCP 工具:3 个连接工具与 86 个领域工具,覆盖 UMG Widget、资产与关卡、Blueprint/BlueCode、Animation/Sequencer、Material/HLSL。
- 更安全的 UMG 编辑:支持目标资产与目标控件、聚焦子树读取、并集式布局写入、局部重排,以及需要明确确认的删除操作。
- BlueCode 工作流升级:加入语义读取、revision/source map、dry-run、稳定追加、回滚与显式编译/删除路径;底层节点命令仍作为兼容执行层保留。
- Material/HLSL 与 Animation:补全材质图、Custom HLSL 参数/输出、动画轨道与关键帧的结构化读写协议。
- 多编辑器连接:每个 Unreal Editor 实例使用系统分配端口并发布发现记录;支持会话选择与串行化的多客户端访问。
- 文档与 Agent Skills:提供双语快速入口、完整协议文档、网页手册,以及 UMG/Material authoring skills。
- 发布可靠性:修复静态测试与精简 README 的错误耦合;新增
main到Document的文档 freshness CI,仅在文档敏感路径变化时要求重新审核,并保留审核提交与日期。
已验证 / Verification
- Unreal AutomationTool
BuildPlugin: 成功(UE 5.8, Win64, Development Editor)。 - Widget、Animation、Blueprint schema/protocol、Material 静态检查:全部通过。
- MCP stdio initialize 与
tools/list握手检查:通过。 - 锁定的
uvPython 环境安装与 server import:通过。 - GitHub Pages 文档部署与源码 freshness workflow:通过。
安装 / Install
- 下载
UmgMcp-v1.0.12-UE5.8-Win64.zip。 - 解压后把其中的
UmgMcp文件夹放到<YourProject>/Plugins/。 - 启用插件并重启 Unreal Editor。
- 外部 MCP 客户端配置请参阅包内
Readme.md/Readme_zh.md或 web manual。
需要自行编译时,也可以直接使用本 Release 的 GitHub Source code archives。
已知边界 / Known boundaries
- 官方验证范围为 UE 5.8 / Win64。
- 实时工具调用需要 Unreal Editor 已启动且插件已启用。
- BlueCode 的复杂嵌套 CFG 编辑仍处于过渡阶段;详见协议文档。
完整性 / Integrity
- Release commit:
a0494ef819f03e3f75eda2a049078b2bedac4fec UmgMcp-v1.0.12-UE5.8-Win64.zip- SHA-256:
7e00490843aa053540c1aebcf19c8575e52cbd67464e254e0007cdf1b3abc7f3