当前位置：首页 > article >正文

【UE5】制作插件并调试【vs2022】

article 2025/3/11 0:14:09

视频教程：好看视频-轻松有收获

https://www.youtube.com/watch?v=Ijpa9mI2b5I

原文：【UE】制作插件_ue插件-CSDN博客

C++制作插件
1. 我们可以在C++工程中创建更多类型的插件，这里我们选择“空白”作为模板来创建插件

点击“创建插件”按钮后，系统自动帮我们打开VS编辑器，VS编辑器中可以看到插件的内容如下

我们需要打开“xxx.uplugin”文件，然后添加如下内容来指定插件运行的平台

"WhitelistPlatforms": [
"Win64"
]
2. 关闭虚幻编辑器，在VS编辑器中重新生成项目

等待生成完毕

点击“调试-》开始执行不调试” ，然后等待打开虚幻编辑器

在项目浏览器中可以看到我们创建的插件文件夹

3. 接下来我们创建插件的功能（推出方块）。在“All-》C++类-》xxx”中新建C++类，这里准备使用代码实现将方块推出去的功能

这里选择“Actor组件”然后点击下一步

需要指定该C++类存放于插件中，然后点击“公有”，命名插件名称，然后点击创建类

4. 回到VS编辑器中，点击“全部重新加载”

此时可以看到在插件文件夹中已经创建了C++的.h和.cpp文件

打开.h文件，这里先删除TickComponent

在.cpp文件中，先将tick设置为false来减少性能消耗

删除TickComponent

回到.h文件中，我们添加一个蓝图可调用的函数，该函数需要传入一个布尔变量，用于表示是否需要生成一个方块并推出去

UFUNCTION(BlueprintCallable, Category = "Presets")
void StartPushing(bool spawnCube);
接下来需要在.cpp文件中完善该函数的逻辑，我们可以直接通过如下步骤创建函数体

此时在.cpp文件中自动帮我们创建好了函数体

再在.h文件中定义一个蓝图可识别并编辑的浮点型变量，表示推力的大小

在.cpp文件中设置力的大小

在.h中再定义一个推出的物体

完成推出方块的函数逻辑

打包插件还需指定引用的文件

完整的.cpp代码如下：

// Fill out your copyright notice in the Description page of Project Settings.

#include "PushCubeLogic.h"
//打包插件还需指定引用文件
#include "GameFramework/Actor.h"
#include "Engine/World.h"
#include "Components/StaticMeshComponent.h"

// Sets default values for this component's properties
UPushCubeLogic::UPushCubeLogic()
{
   // Set this component to be initialized when the game starts, and to be ticked every frame. You can turn these features
   // off to improve performance if you don't need them.
   PrimaryComponentTick.bCanEverTick = false;

   Force = 500.0f;
}

// Called when the game starts
void UPushCubeLogic::BeginPlay()
{
   Super::BeginPlay();

}

void UPushCubeLogic::StartPushing(bool spawnCube)
{
   if (GetOwner()) { //判断自身对象是否有效
       FVector Start = GetOwner()->GetActorLocation();
       FVector End = Start + (GetOwner()->GetActorForwardVector() * 300.0f);

       if (spawnCube && SpawnedCube) { //判断是否能够生成Cube并且是否指定Cube
           // 生成Cube
           GetWorld()->SpawnActor<AActor>(SpawnedCube, End, FRotator(0, 0, 0));
       }

       FHitResult Hit;
       FCollisionQueryParams QParams;
       bool bHit = GetWorld()->LineTraceSingleByChannel(Hit, Start, End, ECC_Visibility, QParams); //发出射线


       if (bHit) { //判断射线是否检测到物体
           UStaticMeshComponent* SMComp = Cast<UStaticMeshComponent>(Hit.GetActor()->GetRootComponent()); //获取物体的StaticMesh
           bool CubeMoveable = Hit.GetActor()->IsRootComponentMovable(); //物体是否可移动

           if (CubeMoveable && SMComp) {
               DrawDebugLine(GetWorld(), Start, End, FColor::Blue, false, 0.5f); //显示射线

               SMComp->AddImpulse(GetOwner()->GetActorForwardVector() * SMComp->GetMass()*Force); //施加力
           }

       }

   }

}

.h文件：

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "Components/ActorComponent.h"
#include "PushCubeLogic.generated.h"

UCLASS( ClassGroup=(Custom), meta=(BlueprintSpawnableComponent) )
class PUSHCUBEPLUGIN_API UPushCubeLogic : public UActorComponent
{
   GENERATED_BODY()

public:
   // Sets default values for this component's properties
   UPushCubeLogic();

protected:
   // Called when the game starts
   virtual void BeginPlay() override;

   UPROPERTY(EditAnywhere, Category = "Presets")
   float Force;

   UPROPERTY(EditAnywhere, Category = "Presets")
   TSubclassOf<AActor> SpawnedCube;

public:
   UFUNCTION(BlueprintCallable, Category = "Presets")
   void StartPushing(bool spawnCube);
};