在UE4或UE5中，通过C++编写自定义蓝图节点是扩展引擎功能的重要方式。这类开发常用于提升性能、封装复杂逻辑，或为设计师提供可视化接口。要实现这一点，核心方法是创建“可被蓝图调用”的C++函数，并借助虚幻元数据（UFUNCTION）暴露给蓝图系统。

1. 创建可被蓝图调用的C++类

要在蓝图中使用C++函数，必须从支持反射的基类继承，例如 UObject 或其子类（如 UActorComponent、UUserWidget 等）。

示例：创建一个工具类

// MyBlueprintFunctionLibrary.h
#pragma once

#include "CoreMinimal.h"
#include "Kismet/BlueprintFunctionLibrary.h"
#include "MyBlueprintFunctionLibrary.generated.h"

UCLASS()
class MYPROJECT_API UMyBlueprintFunctionLibrary : public UBlueprintFunctionLibrary
{
    GENERATED_BODY()

public:
    // 返回两数之和，可在蓝图中使用
    UFUNCTION(BlueprintPure, Category = "Math")
    static float AddFloats(float A, float B);

    // 带执行引脚的函数（有副作用）
    UFUNCTION(BlueprintCallable, Category = "Game")
    static void PrintToLog(const FString& Message);
};

实现文件：

// MyBlueprintFunctionLibrary.cpp
#include "MyBlueprintFunctionLibrary.h"
#include "Engine/Engine.h"

float UMyBlueprintFunctionLibrary::AddFloats(float A, float B)
{
    return A + B;
}

void UMyBlueprintFunctionLibrary::PrintToLog(const FString& Message)
{
    if (GEngine)
    {
        GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Green, Message);
    }
}

关键说明：

• UBlueprintFunctionLibrary：用于创建无状态的静态函数库，自动注册到蓝图中。
• UFUNCTION(BlueprintCallable)：允许函数在蓝图中被调用。
• BlueprintPure：表示函数无副作用，不需执行引脚。
• Category：设置蓝图节点分类，便于查找。

2. 在非函数库类中暴露方法

若你正在开发Actor、组件或其他对象，也可以直接暴露成员函数。

// MyActorComponent.h
UCLASS(ClassGroup=(Custom), meta=(BlueprintSpawnableComponent))
class AMYPROJECT_API UMyActorComponent : public UActorComponent
{
    GENERATED_BODY()

public:
    UFUNCTION(BlueprintCallable, Category = "Movement")
    void LaunchCharacter(float Power);

    UFUNCTION(BlueprintImplementableEvent, Category = "Response")
    void OnSpecialEvent();
};

BlueprintImplementableEvent 允许蓝图重写该函数，适合事件回调。

Animate AI是个一站式AI动画故事视频生成工具

3. 自定义节点外观与高级控制（进阶）

若需更复杂的节点（如带动态引脚、自定义图标），需编写插件并使用 EdGraph 扩展机制。

常见做法：

• 创建插件模块，继承 UEdGraphNode 和 UK2Node。
• 重写 CreateInputPins()、DrawNodeOnCanvas() 等函数。
• 通过 Blueprint Graph Editor 扩展点注入自定义节点。

这类开发较复杂，通常用于开发行为树节点、动画蓝图节点或专业工具链。

4. 编译与使用

完成代码后：

• 保存所有文件，用Visual Studio重新编译项目。
• 启动编辑器，在蓝图图表中右键搜索你定义的函数名（如“AddFloats”）。
• 节点将出现在对应分类下，可直接拖入图表使用。

确保 .build.cs 文件包含必要模块：

PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "AIModule", "GameplayTasks", "HeadMountedDisplay" });

基本上就这些。掌握UFUNCTION宏和反射机制是打通C++与蓝图的关键。只要类和函数正确标记，虚幻引擎会自动处理底层通信。