Menu
CppSkillApiSubsystem 蓝图原语 - 创建、编译、保存蓝图，设置 CDO/组件属性，管理组件
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
CppSkillApiSubsystem 蓝图写入原语 - 变量/图/节点增删改与批处理事务
CppSkillApiSubsystem 资产原语 - 重命名、复制、删除、保存资产
CppSkillApiSubsystem 编辑器原语 - 列出/保存未保存包、撤销/重做事务
CppSkillApiSubsystem 验证原语 - 编译所有蓝图并返回错误/警告摘要
CppSkillApiSubsystem 世界原语 - 加载关卡、生成/查找/销毁 Actor、设置属性和 Transform
最小脚本示例，展示 main(args) + stdout + result
| 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 |