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 · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add quodsoler/unreal-engine-skills --skill ue-cpp-foundationsAbout this skill
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 specifiers | Reflection Macros |
TArray, TMap, TSet, TOptional, TVariant | Containers |
Delegates, events, AddDynamic, Broadcast | Delegates |
FName, FString, FText, LOCTEXT | String Types |
TObjectPtr, TWeakObjectPtr, TSharedPtr, GC roots, FGCObject | Object Lifetime and Pointers |
Class default objects, GetDefault, TNotNull parameters | CDO Access and Non-Null Parameters |
| Game instance / world / local player / engine / editor subsystems | Subsystems |
Replicated, ReplicatedUsing, GetLifetimeReplicatedProps | Replicated Properties |
UE_LOG, log categories | Logging |
WITH_EDITOR, UE_BUILD_SHIPPING guards | Conditional 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
| Specifier | Effect |
|---|---|
Blueprintable / BlueprintType | Allow Blueprint subclasses / use as a Blueprint variable type (Not… forms block them) |
Abstract | Cannot be instantiated; subclasses can |
Config=Game, DefaultConfig | UPROPERTY(Config) members load from DefaultGame.ini; DefaultConfig also saves there |
Transient | Instances are never saved |
ClassGroup=Name + meta=(BlueprintSpawnableComponent) | Component appears in the Add Component menu |
UPROPERTY
| Group | Specifiers |
|---|---|
| Editor visibility | EditAnywhere, EditDefaultsOnly, EditInstanceOnly, VisibleAnywhere, VisibleDefaultsOnly, VisibleInstanceOnly, AdvancedDisplay |
| Blueprint access | BlueprintReadWrite, BlueprintReadOnly, BlueprintGetter=Fn, BlueprintSetter=Fn, BlueprintAssignable (multicast delegates only) |
| Serialization | Transient, DuplicateTransient, SaveGame, Config, GlobalConfig, Instanced, SkipSerialization, NonTransactional |
| Replication | Replicated, ReplicatedUsing=OnRep_Fn, NotReplicated |
Frequent meta= keys | ClampMin/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
| Specifier | Effect |
|---|---|
BlueprintCallable / BlueprintPure | Node with / without execution pins; BlueprintPure must not mutate state |
BlueprintNativeEvent | Blueprint may override; the C++ default body is Name_Implementation |
BlueprintImplementableEvent | Blueprint implements; no C++ body at all |
| `Bluep |