跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

ue-cpp-foundations

Use when writing Unreal Engine C++ that touches the reflection system or core types: UCLASS, UPROPERTY, UFUNCTION, USTRUCT, UENUM, GENERATED_BODY, TObjectPtr, TWeakObjectPtr, TSharedPtr, FGCObject, TArray, TMap, TSet, TOptional, TVariant, DECLARE_DYNAMIC_MULTICAST_DELEGATE, AddDynamic, FName, FString, FText, UGameInstanceSubsystem, UWorldSubsystem, GetDefault, TNotNull. Also use when the user mentions 'UE C++', 'garbage collection', 'CDO', 'smart pointers' or 'specifiers'. For Actor and component lifecycle, see ue-actor-component-architecture; for Build.cs and modules, see ue-module-build-system; for Blueprint-facing functions and latent actions, see ue-blueprint-cpp-interop.

quodsoler · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add quodsoler/unreal-engine-skills --skill ue-cpp-foundations

技能说明


name: ue-cpp-foundations description: "Use when writing Unreal Engine C++ that touches the reflection system or core types: UCLASS, UPROPERTY, UFUNCTION, USTRUCT, UENUM, GENERATED_BODY, TObjectPtr, TWeakObjectPtr, TSharedPtr, FGCObject, TArray, TMap, TSet, TOptional, TVariant, DECLARE_DYNAMIC_MULTICAST_DELEGATE, AddDynamic, FName, FString, FText, UGameInstanceSubsystem, UWorldSubsystem, GetDefault, TNotNull. Also use when the user mentions 'UE C++', 'garbage collection', 'CDO', 'smart pointers' or 'specifiers'. For Actor and component lifecycle, see ue-actor-component-architecture; for Build.cs and modules, see ue-module-build-system; for Blueprint-facing functions and latent actions, see ue-blueprint-cpp-interop." metadata: version: "2.0.0" engine: "5.8"

UE C++ Foundations

Target engine: UE 5.8. APIs below are verified against the 5.8 headers; older forms are listed under "Deprecated — do not use".

This skill covers the C++ layer every Unreal module is built on: reflection macros (UCLASS, UPROPERTY, UFUNCTION, USTRUCT, UENUM, UINTERFACE), containers, delegates, string types, object lifetime and garbage collection, CDO access, and the subsystem family. All of it lives in the Core, CoreUObject and Engine modules (PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine" });). Editor subsystems additionally need EditorSubsystem and UnrealEd in an editor-only module.

Context

Read .agents/ue-project-context.md if it exists (module names, conventions, enabled plugins, GAS/networking setup). Do not stop if it is missing.

Identify the area from the request and the codebase. Ask only when two plausible readings would produce different code.

Request is about…Go to
UCLASS, UPROPERTY, UFUNCTION, USTRUCT, UENUM specifiersReflection Macros
TArray, TMap, TSet, TOptional, TVariantContainers
Delegates, events, AddDynamic, BroadcastDelegates
FName, FString, FText, LOCTEXTString Types
TObjectPtr, TWeakObjectPtr, TSharedPtr, GC roots, FGCObjectObject Lifetime and Pointers
Class default objects, GetDefault, TNotNull parametersCDO Access and Non-Null Parameters
Game instance / world / local player / engine / editor subsystemsSubsystems
Replicated, ReplicatedUsing, GetLifetimeReplicatedPropsReplicated Properties
UE_LOG, log categoriesLogging
WITH_EDITOR, UE_BUILD_SHIPPING guardsConditional Compilation Guards

Reflection Macros

Every reflected type has GENERATED_BODY() as the first line of its body and #include "TypeName.generated.h" as the last include of its header. Every UCLASS in a game module carries the module API macro (MYGAME_API). Specifier parsing is case-insensitive (engine headers use both config=Game and Config=Game). Complete specifier and meta= tables: references/property-specifiers.md.

UCLASS

SpecifierEffect
Blueprintable / BlueprintTypeAllow Blueprint subclasses / use as a Blueprint variable type (Not… forms block them)
AbstractCannot be instantiated; subclasses can
Config=Game, DefaultConfigUPROPERTY(Config) members load from DefaultGame.ini; DefaultConfig also saves there
TransientInstances are never saved
ClassGroup=Name + meta=(BlueprintSpawnableComponent)Component appears in the Add Component menu

UPROPERTY

GroupSpecifiers
Editor visibilityEditAnywhere, EditDefaultsOnly, EditInstanceOnly, VisibleAnywhere, VisibleDefaultsOnly, VisibleInstanceOnly, AdvancedDisplay
Blueprint accessBlueprintReadWrite, BlueprintReadOnly, BlueprintGetter=Fn, BlueprintSetter=Fn, BlueprintAssignable (multicast delegates only)
SerializationTransient, DuplicateTransient, SaveGame, Config, GlobalConfig, Instanced, SkipSerialization, NonTransactional
ReplicationReplicated, ReplicatedUsing=OnRep_Fn, NotReplicated
Frequent meta= keysClampMin/ClampMax, UIMin/UIMax, EditCondition, EditConditionHides, AllowPrivateAccess, DisplayName, ToolTip, Units, AllowedClasses, MustImplement, ExposeOnSpawn, TitleProperty
// MyCharacter.h
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "MyCharacter.generated.h"

class UStaticMeshComponent;
class UStaticMesh;

UCLASS(Blueprintable)
class MYGAME_API AMyCharacter : public ACharacter
{
    GENERATED_BODY()
public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Stats", meta=(ClampMin="1.0"))
    float MaxHealth = 100.f;

    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category="Stats")
    float CurrentHealth = 100.f;

    UPROPERTY(Transient)
    TObjectPtr<UStaticMeshComponent> CachedMesh;     // not serialized, still GC-tracked

    UPROPERTY(EditDefaultsOnly, Category="Config")
    TSubclassOf<AActor> ProjectileClass;             // class reference restricted to AActor subclasses
    UPROPERTY(EditDefaultsOnly, Category="Config")
    TSoftObjectPtr<UStaticMesh> LazyMesh;            // path reference; load on demand

    UFUNCTION(BlueprintNativeEvent, Category="Combat")
    void OnDamageTaken(float Amount);
    virtual void OnDamageTaken_Implementation(float Amount);
};

UFUNCTION

SpecifierEffect
BlueprintCallable / BlueprintPureNode with / without execution pins; BlueprintPure must not mutate state
BlueprintNativeEventBlueprint may override; the C++ default body is Name_Implementation
BlueprintImplementableEventBlueprint implements; no C++ body at all
`Bluep
阅读完整来源 ↗