UE5 C++中如何基于多个组件创建复合组件？

问题根源分析 #

你遇到的两个问题本质是组件根节点设置错误，以及属性声明不符合Unreal组件的编辑规范：

1. 蓝图中组件属性需手动选择：因为你用EditAnywhere声明子组件指针，编辑器会将其视为外部对象引用，而非内部子组件；
2. 网格停留在原点：原代码未将碰撞盒设为组件的根节点，导致CubeBlockComponent的变换无法传递给子组件。

正确的CubeBlockComponent实现代码 #

头文件（CubeBlockComponent.h）

#pragma once

#include "CoreMinimal.h"
#include "Components/SceneComponent.h"
#include "CubeBlockComponent.generated.h"

UCLASS(ClassGroup=(Custom), meta=(BlueprintSpawnableComponent))
class YOURPROJECT_API UCubeBlockComponent : public USceneComponent
{
	GENERATED_BODY()

public:	
	UCubeBlockComponent();

	// 用VisibleAnywhere让子组件在编辑器中直接展开编辑，BlueprintReadOnly允许蓝图读取
	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category="Cube Block")
	UBoxComponent* BoxCollision;

	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category="Cube Block")
	UStaticMeshComponent* CubeStaticMesh;

protected:
	virtual void BeginPlay() override;

public:	
	virtual void TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction) override;
};

源文件（CubeBlockComponent.cpp）

#include "CubeBlockComponent.h"
#include "Components/BoxComponent.h"
#include "Components/StaticMeshComponent.h"

UCubeBlockComponent::UCubeBlockComponent()
{
	PrimaryComponentTick.bCanEverTick = false;

	// 创建碰撞盒并设置为组件的根节点
	BoxCollision = CreateDefaultSubobject<UBoxComponent>(TEXT("BoxCollision"));
	RootComponent = BoxCollision; // 核心：让碰撞盒作为整个组件的变换根
	BoxCollision->SetBoxExtent(FVector(40.f, 40.f, 40.f));

	// 创建静态网格并附着到根节点（碰撞盒）
	CubeStaticMesh = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("CubeStaticMesh"));
	CubeStaticMesh->SetupAttachment(RootComponent);
	// 确保网格与碰撞盒完全对齐
	CubeStaticMesh->SetRelativeLocation(FVector::ZeroVector);
}

void UCubeBlockComponent::BeginPlay()
{
	Super::BeginPlay();
}

void UCubeBlockComponent::TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickFunction* ThisTickFunction)
{
	Super::TickComponent(DeltaTime, TickType, ThisTickFunction);
}

关键修改说明 #

1. 属性声明调整：

   • 将EditAnywhere改为VisibleAnywhere, BlueprintReadOnly，编辑器会自动识别这是组件的内部子对象，在详情面板中直接展开显示碰撞盒和网格的所有属性，无需手动选择对象。
   • 添加Category分类，让蓝图中的属性面板更整洁。

2. 根节点设置：

   • 通过RootComponent = BoxCollision将碰撞盒设为整个CubeBlockComponent的根，这样组件的位置、旋转、缩放变换会直接传递给碰撞盒，进而带动静态网格同步变换，解决多个组件添加后网格停留在原点的问题。

ModuleActor实现示例 #

你可以创建一个Actor类来组合多个CubeBlockComponent，示例代码如下：

头文件（ModuleActor.h）

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "CubeBlockComponent.h"
#include "ModuleActor.generated.h"

UCLASS()
class YOURPROJECT_API AModuleActor : public AActor
{
	GENERATED_BODY()
	
public:	
	AModuleActor();

	// 允许在蓝图中编辑块数组
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Cube Blocks")
	TArray<UCubeBlockComponent*> CubeBlocks;

protected:
	virtual void BeginPlay() override;

public:	
	virtual void Tick(float DeltaTime) override;
};

源文件（ModuleActor.cpp）

#include "ModuleActor.h"

AModuleActor::AModuleActor()
{
	PrimaryActorTick.bCanEverTick = false;

	// 初始化3个CubeBlockComponent，按X轴排列
	for (int32 i = 0; i < 3; i++)
	{
		UCubeBlockComponent* NewBlock = CreateDefaultSubobject<UCubeBlockComponent>(FName("CubeBlock_", i));
		NewBlock->SetRelativeLocation(FVector(i * 100.f, 0.f, 0.f));
		CubeBlocks.Add(NewBlock);
	}
}

void AModuleActor::BeginPlay()
{
	Super::BeginPlay();
}

void AModuleActor::Tick(float DeltaTime)
{
	Super::Tick(DeltaTime);
}

使用注意事项 #

• 无需继承UBoxComponent，这种组合式的组件设计完全符合Unreal的组件化理念，避免不必要的代码冗余。
• 基于C++类创建蓝图组件后，直接在蓝图或Actor中添加该组件，修改其相对变换即可实现块的排列，每个组件会独立响应自身的位置设置。
• 如果需要在蓝图中动态添加组件，可在ModuleActor的蓝图中使用「添加组件」功能直接选择BpCubeBlockComponent。

内容的提问来源于stack exchange，提问作者bobombe