SuperAPI AI 工具集

verse-uefn

编程与开发

查看项目

更新于 11-14 16:14

技能介绍

用途

verse-uefn 是一个面向 AI 智能体的技能,用于支持 Epic Games Verse 语言和 UEFN(Unreal Editor for Fortnite)的开发工作流。当需要编写、审查或调试 .verse 文件,或创建 UEFN 设备、NPC 行为时,可以使用该技能。

主要能力

  • 以 Epic 的 VS Code Verse 扩展和 UEFN 编译器诊断作为事实来源,确保代码验证通过真实工具链。
  • 通过 MCP 服务器桥接项目上下文、安全文件操作、编辑器状态和日志,辅助智能体进行开发。
  • 提供智能体工作流指导:编辑前确认项目上下文、读取现有模式、进行窄范围编辑、通过诊断验证并迭代。
  • 区分 Verse(运行时游戏逻辑)与 Python(UEFN 编辑器自动化)的用途,并说明 MCP 如何协调两者。
  • 提供最小设备模板、核心语言概念速查表、UEFN 工作流(自定义设备、NPC 行为、多人游戏处理、持久化)以及关键模式(可失败表达式、推测执行、结构化并发、事件驱动)。
  • 列出可用的 MCP 工具映射,并强调安全使用编辑器工具。

使用方式

  1. 建立项目上下文:如果 MCP 工具可用,首先调用 uefn_get_project_context,确认 Verse 工作区根目录与打开的 UEFN 项目匹配;如果 UEFN 正在运行,调用 validate_project_state。
  2. 读取现有项目模式:使用 verse_list_files 和 verse_read_file 检查附近的 Verse 文件,复用现有导入、模块风格、命名和设备模式。
  3. 进行窄范围 Verse 编辑:优先使用 verse_write_file 或 verse_create_device 在检测到的项目根目录下操作,不要写入项目根目录之外。
  4. 通过真实工具链验证:使用 VS Code/Epic Verse 扩展诊断,或使用 verse_get_diagnostics 和编辑器日志获取 MCP 可见的错误;根据诊断迭代,而不是猜测 API。
  5. 遵循最佳实践:优先使用不可变变量、正确处理可失败表达式、标记正确的效果、验证玩家引用、保持 OnBegin 轻量、每次编辑后重新运行诊断、优先使用 Epic 模板。

适用场景

  • 编写或修改 UEFN 中的 Verse 游戏逻辑代码。
  • 创建自定义 UEFN 设备或 NPC 行为。
  • 调试 .verse 文件中的编译或运行时问题。
  • 处理多人游戏中的玩家加入/离开事件。
  • 使用持久化数据模式。
  • 通过 MCP 工具进行安全的编辑器状态检查和文件操作。

限制

  • 该技能依赖 MCP 服务器提供项目上下文和工具;如果 MCP 工具不可用,部分工作流可能无法执行。
  • 危险编辑器工具(如 execute_python、资产删除、actor 删除、关闭)仅在用户明确要求且 MCP 服务器要求确认时使用。
  • 文档中未提供具体的收费、价格、平台要求或效果保证信息。
  • 文档中提到的参考链接和外部资源(如 REFERENCE.md、EXAMPLES.md、Epic 文档等)需用户自行访问。