SuperAPI AI 工具集

unreal-cpp-gameplay

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:编写正确的 UE5 玩法 C++ 代码,覆盖连接 C++ 与编辑器/蓝图的反射宏、Gameplay Framework 类职责与模块依赖。适用于创建 C++ 玩法类(AActor、APawn、ACharacter、AGameModeBase、UActorComponent)、用 UPROPERTY/UFUNCTION 暴露属性与函数、在构造中设置 GameMode 默认类、在 *.Build.cs 中添加模块依赖;项目需含 Source/ 目录及使用 UCLASS 的 .h/.cpp 与 *.Build.cs。

主要能力与用法:类名前缀需匹配基类(A=Actor、U=UObject/组件、F=结构体、E=枚举、I=接口);类上方写 UCLASS(),类体内首行 GENERATED_BODY(),头文件最后一个 include 为 #include "ClassName.generated.h";用 UPROPERTY 控制编辑器/蓝图可见性与 GC 跟踪,用 UFUNCTION(BlueprintCallable 等) 暴露行为;在构造函数中用 CreateDefaultSubobject<T>(TEXT("Name")) 创建组件并设置 RootComponent;GameMode 负责规则与默认类,Pawn/Character 是可控制实体,PlayerController 代表玩家意志,ActorComponent 为可复用行为;在 *.Build.cs 的 PublicDependencyModuleNames 添加依赖(如 EnhancedInput)以免链接错误。验证方式:编译(函数体可用 Live Coding Ctrl+Alt+F11,头文件/UPROPERTY 改动需完整重编译),并在编辑器中确认类与属性出现。

限制与注意:generated.h 未放最后、漏写 GENERATED_BODY() 会引发 UHT/编译错误;裸 UObject* 未加 UPROPERTY 可能被 GC 回收(UE5 用 TObjectPtr);Live Coding 不处理头文件与 UCLASS/UPROPERTY 变更,需重启编辑器并重新构建;前缀错误会破坏 UHT;未调用 Super:: 会跳过引擎初始化。面向设计者的可视逻辑、输入绑定细节与 AI 逻辑不在本技能范围。官方文档参考 UE "CPP Quick Start" 与 "Gameplay Framework"。