القائمة
CppSkillApiSubsystem 蓝图原语 - 创建、编译、保存蓝图，设置 CDO/组件属性，管理组件
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | cpp_blueprint_api |
| description | CppSkillApiSubsystem 蓝图原语 - 创建、编译、保存蓝图，设置 CDO/组件属性，管理组件 |
| tags | ["cpp","blueprint","api"] |
本 skill 文档描述 UCppSkillApiSubsystem 的蓝图相关原语。
从 UE Python 中获取子系统：
import unreal
api = unreal.get_editor_subsystem(unreal.CppSkillApiSubsystem)
| 方法 | C++ 签名 | Python 返回值 |
|---|---|---|
create_blueprint | bool CreateBlueprint(ParentClassPath, PackagePath, BlueprintName, OutBlueprintPath, OutError) | (success: bool, bp_path: str, error: str) |
compile_blueprint | bool CompileBlueprint(BlueprintPath, OutError) | (success: bool, error: str) |
save_blueprint | bool SaveBlueprint(BlueprintPath, OutError) | (success: bool, error: str) |
set_blueprint_cdo_property_by_string | bool SetBlueprintCDOPropertyByString(BlueprintPath, PropertyName, ValueAsString, OutError) | (success: bool, error: str) |
add_blueprint_component | bool AddBlueprintComponent(BlueprintPath, ComponentClassPath, ComponentName, OutError) | (success: bool, error: str) |
remove_blueprint_component | bool RemoveBlueprintComponent(BlueprintPath, ComponentName, OutError) | (success: bool, error: str) |
list_blueprint_components | FString ListBlueprintComponents(BlueprintPath) | str (JSON) |
get_blueprint_component_template | UActorComponent* GetBlueprintComponentTemplate(BlueprintPath, ComponentName, OutError) | (template: UActorComponent, error: str) |
set_blueprint_component_property_by_string | bool SetBlueprintComponentPropertyByString(BlueprintPath, ComponentName, PropertyName, ValueAsString, OutError) | (success: bool, error: str) |
get_blueprint_component_property_by_string | bool GetBlueprintComponentPropertyByString(BlueprintPath, ComponentName, PropertyName, OutValue, OutError) | (value: str, error: str) |
详细接口和示例见 docs/overview.md。
import unreal
api = unreal.get_editor_subsystem(unreal.CppSkillApiSubsystem)
# 创建蓝图 - 返回 (success, bp_path, error)
success, bp_path, error = api.create_blueprint(
parent_class_path="/Script/Engine.Actor",
package_path="/Game/Blueprints",
blueprint_name="BP_MyActor"
)
if success:
# 添加组件
success, error = api.add_blueprint_component(
blueprint_path=bp_path,
component_class_path="/Script/Engine.StaticMeshComponent",
component_name="Mesh"
)
# 设置默认值
success, error = api.set_blueprint_cdo_property_by_string(
blueprint_path=bp_path,
property_name="MyProperty",
value_as_string="100"
)
# 编译并保存
success, error = api.compile_blueprint(blueprint_path=bp_path)
success, error = api.save_blueprint(blueprint_path=bp_path)
else:
unreal.log_error(f"创建蓝图失败: {error}")
| 类型 | 路径 |
|---|---|
| Actor | /Script/Engine.Actor |
| Pawn | /Script/Engine.Pawn |
| Character | /Script/Engine.Character |
| ActorComponent | /Script/Engine.ActorComponent |
| SceneComponent | /Script/Engine.SceneComponent |
| GameModeBase | /Script/Engine.GameModeBase |
| PlayerController | /Script/Engine.PlayerController |
CppSkillApiSubsystem 蓝图写入原语 - 变量/图/节点增删改与批处理事务
CppSkillApiSubsystem 资产原语 - 重命名、复制、删除、保存资产
CppSkillApiSubsystem 编辑器原语 - 列出/保存未保存包、撤销/重做事务
CppSkillApiSubsystem 验证原语 - 编译所有蓝图并返回错误/警告摘要
CppSkillApiSubsystem 世界原语 - 加载关卡、生成/查找/销毁 Actor、设置属性和 Transform
最小脚本示例，展示 main(args) + stdout + result