Skip to content

Commit 8ecf859

Browse files
author
ZCode Marketplace Bot
committed
feat(unreal-engine): publish MCP integration, official skills and icon
Source-Commit: c3a91875051c5aacdec3ed089e5e09721035c220
1 parent 4b335bf commit 8ecf859

16 files changed

Lines changed: 908 additions & 0 deletions

File tree

‎assets/icon-sources.json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1962,6 +1962,15 @@
19621962
"mimeType": "image/png",
19631963
"sha256": "a8384578a86e4e7ae1fe273572ffff566d748c98b7eb6eff1321294005bd8b2b"
19641964
},
1965+
{
1966+
"name": "unreal-engine",
1967+
"icon": "unreal-engine/icon.png",
1968+
"source": "https://raw.githubusercontent.com/simple-icons/simple-icons/4d29a35c954699b389a834aacc97dd6e7e74143c/icons/unrealengine.svg",
1969+
"matchedBy": "brand-vector-mirror-solid-black-background",
1970+
"homepage": "https://www.unrealengine.com/en-US/branding",
1971+
"mimeType": "image/png",
1972+
"sha256": "8f384cbb86e11b04a0ad257319efcb58a9cad2fac21362c883e4cb7e9bc65d53"
1973+
},
19651974
{
19661975
"name": "unreal-engine-skills-for-claude-code",
19671976
"icon": "unreal-engine-skills-for-claude-code/icon.png",

‎assets/unreal-engine/icon.png‎

7.33 KB
Loading

‎marketplace.json‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1239,6 +1239,28 @@
12391239
"author": {
12401240
"name": "ZCode"
12411241
}
1242+
},
1243+
{
1244+
"name": "unreal-engine",
1245+
"source": "./plugins/unreal-engine",
1246+
"displayName": "Unreal Engine",
1247+
"description": "Control a separately installed Unreal Editor through Epic Unreal MCP and adapted official skills. Requires UE with ModelContextProtocol and AllToolsets enabled.",
1248+
"description_i18n": {
1249+
"zh-CN": "通过 Epic 官方 MCP 和 Skills 操作独立安装的 UE 编辑器。需启用 ModelContextProtocol 和 AllToolsets。",
1250+
"en": "Control a separately installed Unreal Editor through Epic Unreal MCP and adapted official skills. Requires UE with ModelContextProtocol and AllToolsets enabled."
1251+
},
1252+
"version": "0.1.0",
1253+
"author": {
1254+
"name": "Z.ai"
1255+
},
1256+
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/unreal-engine/icon.png",
1257+
"category": "developer-tools",
1258+
"keywords": [
1259+
"unreal-engine",
1260+
"ue",
1261+
"mcp",
1262+
"game-development"
1263+
]
12421264
}
12431265
]
12441266
}

‎plugins/unreal-engine/.mcp.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"mcpServers": {
3+
"unreal-mcp": {
4+
"type": "http",
5+
"url": "${user_config.endpoint}"
6+
}
7+
}
8+
}
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
{
2+
"name": "unreal-engine",
3+
"version": "0.1.0",
4+
"description": "Control a separately installed Unreal Editor through Epic Unreal MCP and adapted official skills. Requires UE with ModelContextProtocol and AllToolsets enabled.",
5+
"description_i18n": {
6+
"zh-CN": "通过 Epic 官方 MCP 和 Skills 操作独立安装的 UE 编辑器。需启用 ModelContextProtocol 和 AllToolsets。",
7+
"en": "Control a separately installed Unreal Editor through Epic Unreal MCP and adapted official skills. Requires UE with ModelContextProtocol and AllToolsets enabled."
8+
},
9+
"author": {
10+
"name": "Z.ai"
11+
},
12+
"license": "MIT",
13+
"skills": "skills",
14+
"mcpServers": {
15+
"unreal-mcp": {
16+
"type": "http",
17+
"url": "${user_config.endpoint}"
18+
}
19+
},
20+
"userConfig": {
21+
"endpoint": {
22+
"type": "string",
23+
"default": "http://127.0.0.1:8000/mcp",
24+
"description": "Unreal MCP endpoint on the machine running the ZCode agent. Keep the unauthenticated UE server on loopback."
25+
}
26+
}
27+
}

‎plugins/unreal-engine/README.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Unreal Engine
2+
3+
[中文](README_CN.md)
4+
5+
A non-UI ZCode plugin connecting to a separately installed Unreal Editor through Epic's experimental Unreal MCP. Includes the official `unreal-mcp`, `create-toolset`, and `unreal-skill` skills, adapted for ZCode. No engine binaries, native proxy, or UI panel are bundled.
6+
7+
## Setup
8+
9+
1. Install a UE build that includes `ModelContextProtocol` and `AllToolsets` (documented for UE 5.8), then enable both in the intended project.
10+
2. Open the project in Unreal Editor and run `ModelContextProtocol.StartServer` in the editor console.
11+
3. Install and enable **Unreal Engine** in the ZCode plugin marketplace. The `endpoint` plugin setting defaults to `http://127.0.0.1:8000/mcp`; change it if your editor uses a different port. Do not add a duplicate project MCP connection.
12+
4. Ask ZCode: “Use Unreal MCP to identify the connected project and list the scene actors without changing anything.” A successful read-only tool call verifies live access; a configured endpoint alone does not.
13+
14+
Use `unreal-mcp` for editor operations, `create-toolset` to expose new UE tools, and `unreal-skill` for UE project Agent Skills. See [setup](skills/unreal-mcp/references/setup.md) and [troubleshooting](skills/unreal-mcp/references/operations.md).
15+
16+
## Connection and safety
17+
18+
The endpoint is resolved on the machine running the ZCode agent. In SSH/WSL/Docker workspaces, loopback points to that environment, not your desktop. UE MCP has no authentication by default: keep it on loopback or use an explicitly protected connection. Verify the project identity before edits when several editors are running. Save before bulk changes; not all MCP changes are undoable. The editor must be running and tool availability depends on enabled UE toolsets.
19+
20+
## Provenance
21+
22+
Skills originate from [EpicGames/unreal-engine-skills-for-claude-code-plugin](https://github.com/EpicGames/unreal-engine-skills-for-claude-code-plugin), pinned in [upstream.json](skills/upstream.json). MIT notices are retained in each skill directory. ZCode adapts connection/setup guidance; this package is maintained by Z.ai and does not imply Epic endorsement. Unreal Engine licensing remains separate. The marketplace icon is served from the plugin assets CDN.

‎plugins/unreal-engine/README_CN.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Unreal Engine
2+
3+
[English](README.md)
4+
5+
非 UI 的 ZCode 插件,通过 Epic 实验性 Unreal MCP 连接独立安装的 Unreal Editor。包含适配 ZCode 的官方 `unreal-mcp`、`create-toolset`、`unreal-skill` 三个 Skills,不打包引擎、原生代理或 UI 面板。
6+
7+
## 配置
8+
9+
1. 安装包含 `ModelContextProtocol` 和 `AllToolsets` 的 UE 版本(官方文档对应 UE 5.8),在目标项目中启用两者。
10+
2. 用 Unreal Editor 打开项目,在编辑器控制台运行 `ModelContextProtocol.StartServer`。
11+
3. 在 ZCode 插件市场安装并启用 **Unreal Engine**。插件设置 `endpoint` 默认 `http://127.0.0.1:8000/mcp`,端口不同时修改此设置;不要重复添加项目级 MCP 连接。
12+
4. 对 ZCode 说:“使用 Unreal MCP 确认连接的项目,列出场景中的对象,不做修改。”成功的只读调用才证明已连通;仅配置好地址不代表编辑器可用。
13+
14+
`unreal-mcp` 用于操作编辑器,`create-toolset` 用于扩展 UE 工具,`unreal-skill` 用于编写 UE 项目 Agent Skills。详见[配置](skills/unreal-mcp/references/setup.md)与[排障](skills/unreal-mcp/references/operations.md)。
15+
16+
## 连接与安全
17+
18+
地址由运行 ZCode Agent 的机器解析。SSH、WSL、Docker 工作区里的回环地址指向对应环境,不是桌面。UE MCP 默认无鉴权,应保持回环监听,跨机器时显式使用受保护连接。多个编辑器同时运行时,先确认项目身份再修改。批量修改前保存,不是所有 MCP 操作都支持撤销。编辑器必须运行,可用工具取决于启用的 UE 工具集。
19+
20+
## 来源
21+
22+
Skills 来自 [EpicGames/unreal-engine-skills-for-claude-code-plugin](https://github.com/EpicGames/unreal-engine-skills-for-claude-code-plugin),版本固定在 [upstream.json](skills/upstream.json),各 Skill 目录保留 MIT 许可。ZCode 适配连接和配置说明;本插件由 Z.ai 维护,不表示 Epic 背书。Unreal Engine 本身遵循独立授权。市场图标由插件资源 CDN 提供。
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Epic Games, Inc.
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

0 commit comments

Comments
 (0)