UE5 游戏模板 —— TopDownGame 俯视角游戏

UE5 游戏模板 ------ TopDownGame 俯视角游戏

前言
一、模块导入
二、TopDownGameMode
三、TopDownPlayerController
四、TopDownCharacter
五、射线检测
总结

前言

上一篇文章介绍了一下PuzzleGame模板的流程，我们循序渐进这次介绍TopDownGame。

实际上TopDownGame和之前的PuzzleGame非常类似都是俯视角都要使用射线检测去做相应的判定。但是TopDownGame提供了角色寻路和角色位移的方式。

一、模块导入

UE是以导入模块来构建项目的，我们可以自己定义插件等内容当作一个模块来进行导入。

可以看到下图中导入了很多的模块

其中 "Core", "CoreUObject", "Engine", "InputCore" 是常用的也是默认都会导入的几个模块，有着最基础的内容。

"AIModule" 这个是用作寻路的必要模块

"Niagara" 粒子系统相关的模块

"EnhancedInput" 新的输入系统模块

二、TopDownGameMode

我们在之前的PuzzleGame中就有讲解过，下面的方式可以指定C++的蓝图派生类

三、TopDownPlayerController

1、构造函数

还是和上一节的内容相似，都是显示鼠标和设置鼠标的默认类型。
CachedDestination 用于记录点击到的点
FollowTime 用于记录鼠标按住的时间

2、SetupInputComponent

初始化新输入系统

获取新输入的本地玩家子系统，对子系统设置MappingContext

cpp 复制代码

	// Add Input Mapping Context
	if (UEnhancedInputLocalPlayerSubsystem* Subsystem = ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(GetLocalPlayer()))
	{
		Subsystem->AddMappingContext(DefaultMappingContext, 0);
	}

将InputComponent 转换成新输入组件并绑定事件

cpp 复制代码

// Set up action bindings
if (UEnhancedInputComponent* EnhancedInputComponent = Cast<UEnhancedInputComponent>(InputComponent))
{
	// Setup mouse input events
	EnhancedInputComponent->BindAction(SetDestinationClickAction, ETriggerEvent::Started, this, &ATestTopDownPlayerController::OnInputStarted);
	EnhancedInputComponent->BindAction(SetDestinationClickAction, ETriggerEvent::Triggered, this, &ATestTopDownPlayerController::OnSetDestinationTriggered);
	EnhancedInputComponent->BindAction(SetDestinationClickAction, ETriggerEvent::Completed, this, &ATestTopDownPlayerController::OnSetDestinationReleased);
	EnhancedInputComponent->BindAction(SetDestinationClickAction, ETriggerEvent::Canceled, this, &ATestTopDownPlayerController::OnSetDestinationReleased);

	// Setup touch input events
	EnhancedInputComponent->BindAction(SetDestinationTouchAction, ETriggerEvent::Started, this, &ATestTopDownPlayerController::OnInputStarted);
	EnhancedInputComponent->BindAction(SetDestinationTouchAction, ETriggerEvent::Triggered, this, &ATestTopDownPlayerController::OnTouchTriggered);
	EnhancedInputComponent->BindAction(SetDestinationTouchAction, ETriggerEvent::Completed, this, &ATestTopDownPlayerController::OnTouchReleased);
	EnhancedInputComponent->BindAction(SetDestinationTouchAction, ETriggerEvent::Canceled, this, &ATestTopDownPlayerController::OnTouchReleased);
}

处理输入逻辑

点击鼠标左键开始时先停止角色移动

cpp 复制代码

void ATestTopDownPlayerController::OnInputStarted()
{
	StopMovement();
}

按住触发鼠标左键

1.先累加帧时间间隔

2.发射射线（可能会疑问这个发射射线的方法，其实是对之前PuzzleGame中发射射线方法的一个封装下面详细讲解一下这个地方）

3.记录射线碰撞的点

4.计算移动的方向向量

cpp 复制代码

void ATestTopDownPlayerController::OnSetDestinationTriggered()
{
	// We flag that the input is being pressed
	FollowTime += GetWorld()->GetDeltaSeconds();
	
	// We look for the location in the world where the player has pressed the input
	FHitResult Hit;
	bool bHitSuccessful = false;
	if (bIsTouch)
	{
		bHitSuccessful = GetHitResultUnderFinger(ETouchIndex::Touch1, ECollisionChannel::ECC_Visibility, true, Hit);
	}
	else
	{
		bHitSuccessful = GetHitResultUnderCursor(ECollisionChannel::ECC_Visibility, true, Hit);
	}

	// If we hit a surface, cache the location
	if (bHitSuccessful)
	{
		CachedDestination = Hit.Location;
	}
	
	// Move towards mouse pointer or touch
	APawn* ControlledPawn = GetPawn();
	if (ControlledPawn != nullptr)
	{
		FVector WorldDirection = (CachedDestination - ControlledPawn->GetActorLocation()).GetSafeNormal();
		ControlledPawn->AddMovementInput(WorldDirection, 1.0, false);
	}
}

松开鼠标左键

如果按键按下的时长小于设定值判定是鼠标瞬间点击，将玩家使用导航移动到目标点，同时播放粒子特效和声音

cpp 复制代码

void ATestTopDownPlayerController::OnSetDestinationReleased()
{
	// If it was a short press
	if (FollowTime <= ShortPressThreshold)
	{
		// We move there and spawn some particles
		UAIBlueprintHelperLibrary::SimpleMoveToLocation(this, CachedDestination);
		UNiagaraFunctionLibrary::SpawnSystemAtLocation(this, FXCursor, CachedDestination, FRotator::ZeroRotator, FVector(1.f, 1.f, 1.f), true, true, ENCPoolMethod::None, true);

		if (AudioSound != nullptr)
		{
			UGameplayStatics::PlaySoundAtLocation(GetWorld(), AudioSound, CachedDestination);
		}
	}

	FollowTime = 0.f;
}