Unreal Skill

通过 OpenClaw AI 利用 HTTP 端点控制与自动化虚幻编辑器任务,支持关卡、Actor、变换、组件、编辑器、调试、输入、资产、控制台等...

安装

概览

什么是Unreal Skill

Unreal Skill 是一款专为虚幻引擎(Unreal Engine)打造的自动化控制插件,通过 OpenClaw AI 提供的 HTTP 端点接口,实现对虚幻编辑器的高级操作与任务调度。该插件支持两种连接模式:一是通过 OpenClaw Gateway 进行远程通信,适用于在本地或服务器上运行网关服务的场景;二是直接嵌入 MCP(Model Context Protocol)服务,在本地启动一个 HTTP 服务器供 Claude Code 或 Cursor 等 AI 编程工具调用。两种模式可并行运行,确保灵活适配不同开发环境。插件内置图形化面板,集成于虚幻编辑器的“Window”菜单下,实时显示连接状态、MCP 服务信息及操作日志,极大提升了开发者对编辑器状态的掌控力。 该插件的核心能力覆盖虚幻引擎编辑器的多个关键领域,包括关卡管理、Actor 操作、变换控制、组件处理、编辑器状态切换、调试输出以及输入模拟等。无论是快速创建测试场景、批量修改 Actor 属性,还是执行复杂的自动化构建流程,Unreal Skill 都能通过简洁的 API 接口高效完成。例如,开发者可以通过 `actor.create` 指令一键生成立方体、球体或灯光等基础对象,再结合 `transform.setPosition` 实现精准布局。同时,插件还支持控制台命令执行、日志读取和截图功能,为调试与监控提供了全面支持。 此外,Unreal Skill 特别注重与 AI 编程工具的深度集成,旨在让大语言模型能够理解并操作虚幻编辑器中的具体对象和行为。这种设计使得开发者可以借助自然语言指令驱动编辑器完成复杂任务,如“将名为‘Enemy_01’的敌人移动到坐标 (500, 300, 200)”或“保存当前关卡并截取一张调试截图”。这不仅降低了手动操作的繁琐性,也推动了游戏开发流程向智能化、自动化方向演进。

核心功能特点

  1. 支持通过 OpenClaw Gateway 或本地 MCP 服务器两种方式连接虚幻编辑器
  2. 提供图形化插件面板,实时展示连接状态、服务信息和操作日志
  3. 支持关卡打开、保存与列表查询,便于多场景管理
  4. 可查找、创建、删除 Actor,并支持通过反射系统动态设置属性
  5. 具备完整的变换控制能力:位置、旋转、缩放的一键获取与修改
  6. 集成调试功能,包括层级结构查看、编辑器截图和日志输出

适用场景

Unreal Skill 特别适合需要频繁进行编辑器自动化操作的开发团队或个人开发者。在游戏原型快速搭建阶段,开发者可以利用 `actor.create` 和 `transform.setPosition` 等指令迅速布置大量测试对象,无需手动拖拽或编写脚本,显著提升迭代效率。对于关卡设计师而言,通过 `level.open` 和 `level.save` 可实现多版本关卡的快速切换与备份,配合 `debug.screenshot` 还能自动生成视觉预览图用于评审。 在持续集成与自动化测试场景中,Unreal Skill 可作为 CI/CD 流水线的一部分,自动执行编辑器命令。例如,在夜间构建时,系统可调用 `editor.play` 启动 PIE(Play In Editor),运行自动化测试用例,并通过 `console.getLogs` 收集运行结果,最后生成报告。这种方式避免了人工值守,实现了从代码提交到可视验证的全流程闭环。 此外,该插件尤其适合与 AI 编程工具协同工作。当使用 Claude Code 或 Cursor 进行游戏逻辑开发时,AI 模型可通过 MCP 协议理解并操作虚幻编辑器中的具体对象。比如,开发者可以用自然语言描述需求:“在玩家出生点附近放置三个敌人,类型分别为 Soldier 和 Sniper”,AI 即可解析意图并调用相应 API 完成任务。这种人机协作模式不仅提升了开发速度,也让非技术背景的内容创作者也能参与交互式内容生成,拓展了虚幻引擎的应用边界。