SuperAPI AI 工具集

level-actors

编程与开发

查看项目

更新于 11-06 16:23

技能介绍

用途

level-actors 是一份针对 Unreal Engine 编辑器自动化的技能说明,核心用途是在当前关卡中列出、查找、生成、移动、旋转和修改 Actor。资料指出,在 Unreal 5.8 的整合中,列出、查找、生成、移动、变换和选择 Actor 等基础能力已迁移到引擎原生工具集 ActorTools、SceneTools 和 EditorAppToolset(涵盖选择、相机、PIE、截图),可通过 call_tool 访问;也可以从 execute_python_code 直接驱动 unreal.EditorActorSubsystem 和 unreal.LevelEditorSubsystem。VibeUE 的 ActorService 已收缩为只保留引擎未提供的部分:变换锁定(set_actor_lock_location)、绝对变换标志、保持缩放比例、视口相机取景(get_actor_view_camera / calculate_actor_view / set_viewport_camera)以及完整属性导出(get_all_properties)。ActorService.add_actor、set_property、get_property 已不存在。

主要能力与规则

资料给出了若干关键规则:创建“Basic”等带天空和地板的关卡必须使用 new_level_from_template,而不是 new_level;unreal.EditorLevelLibrary 已弃用,应改用 unreal.get_editor_subsystem(unreal.EditorActorSubsystem);EditorActorSubsystem 没有 get_all_level_actors_of_class 方法,需用 get_all_level_actors() 加 isinstance 过滤。资料还列出 UE 5.7 Python 中已验证的 AttributeError 陷阱,例如 StaticMeshComponent 没有 get_static_mesh、Actor 没有 get_components()、Light 使用 light_component 属性、cast_shadow 实际为 cast_shadows、TextRenderActor 的枚举拼写为 HorizTextAligment 等,并建议不确定时先调用 discover_python_class 一次。

使用方式

技能以 Python 代码示例说明操作方式:获取子系统实例、从模板创建关卡(Template_Default、OpenWorld、TimeOfDay_Default、VR-Basic)、保存当前关卡(save_current_level 或 EditorLoadingAndSavingUtils.save_map)、生成内置 Actor 或加载蓝图类后生成、获取关卡 Actor 并按类型过滤、进行位置/旋转/缩放/整体变换操作、使用扫掠移动与 line_trace_single 做碰撞检查、重命名、设置大纲文件夹、附加/分离、设置标签,以及设置灯光强度与颜色、选择 Actor 等。所有示例强调使用关键字参数构造 Rotator 和 Color,避免参数顺序陷阱。

适用场景

适用于通过 Python 脚本在 Unreal Engine 编辑器中批量或精确管理关卡 Actor 的场景,包括关卡创建与保存、Actor 生成与变换、碰撞与路径检查、层级与标签整理、灯光调节和选择操作。

限制

资料中部分规则与示例基于 UE 5.7/5.8 的 Python API,版本差异可能导致行为不同;条件调用的 unreal-engine-skills-manager 外部 MCP 工具在不可用时需跳过。资料未提供该技能的安装方式、收费、价格或平台支持范围,暂未提供。