[Day 4] AI Monster with C++

📌 목표

• 플레이어를 인식하고 추적하는 몬스터 AI를 만든다
• 근접하면 공격한다
• 일정 시간 이상 가까이 있으면 '분노 상태'로 전환하여 더 빨라진다

---

✅ 프로젝트 생성

• Unreal Engine 5 실행
• 새 프로젝트 > Games > First Person 템플릿
• With Starter Content 선택 가능
• 프로젝트 이름: MonShooting
• With C++ 활성화!

---

🧱 Step 1: MonsterCharacter 클래스

이 클래스는 실제 몬스터 캐릭터의 움직임, 공격, 분노 상태 등을 담당합니다.

MonsterCharacter.h

UCLASS()
class MONSHOOTING_API AMonsterCharacter : public ACharacter
{
	GENERATED_BODY()

public:
	AMonsterCharacter();

protected:
	virtual void BeginPlay() override;

public:	
	virtual void Tick(float DeltaTime) override;

	UPROPERTY(EditAnywhere, Category = "AI")
	float DetectionRange = 1000.0f;  // 플레이어 감지 거리

	UPROPERTY(EditAnywhere, Category = "AI")
	float AttackRange = 150.0f;      // 공격 거리

	UPROPERTY(EditAnywhere, Category = "AI")
	float EnrageTime = 5.0f;         // 몇 초 이상 가까이 있으면 분노

	UPROPERTY(EditAnywhere, Category = "AI")
	float NormalSpeed = 300.0f;

	UPROPERTY(EditAnywhere, Category = "AI")
	float EnragedSpeed = 600.0f;

private:
	APawn* TargetPlayer;   // 추적 대상
	float TimeInRange;     // 근접 시간 누적
	bool bIsEnraged;       // 분노 상태 여부

	void CheckPlayerProximity(float DeltaTime); // 거리 체크
	void AttackPlayer();                        // 공격 실행
	void BecomeEnraged();                       // 분노 전환
};

MonsterCharacter.cpp

AMonsterCharacter::AMonsterCharacter()
{
	PrimaryActorTick.bCanEverTick = true;

	// 기본 이동 속도 설정
	GetCharacterMovement()->MaxWalkSpeed = NormalSpeed;
}

void AMonsterCharacter::BeginPlay()
{
	Super::BeginPlay();

	// 타겟을 현재 플레이어로 설정
	TargetPlayer = UGameplayStatics::GetPlayerPawn(GetWorld(), 0);

	// 초기화
	TimeInRange = 0.0f;
	bIsEnraged = false;
}

// 매 프레임마다 거리 체크 수행
void AMonsterCharacter::Tick(float DeltaTime)
{
	Super::Tick(DeltaTime);

	if (TargetPlayer)
	{
		CheckPlayerProximity(DeltaTime);
	}
}

void AMonsterCharacter::CheckPlayerProximity(float DeltaTime)
{
	// 플레이어와의 거리 계산
	float Distance = FVector::Dist(GetActorLocation(), TargetPlayer->GetActorLocation());

	if (Distance <= DetectionRange)
	{
		// AIController를 통해 추적 시작
		AAIController* AIController = Cast<AAIController>(GetController());
		if (AIController)
		{
			AIController->MoveToActor(TargetPlayer);
		}

		// 일정 시간 가까이 있으면 분노 상태로
		TimeInRange += DeltaTime;
		if (!bIsEnraged && TimeInRange >= EnrageTime)
		{
			BecomeEnraged();
		}

		// 공격 거리 안이면 공격
		if (Distance <= AttackRange)
		{
			AttackPlayer();
		}
	}
	else
	{
		// 멀어지면 타이머 초기화
		TimeInRange = 0.0f;
	}
}

void AMonsterCharacter::AttackPlayer()
{
	// 지금은 로그만 출력 (나중에 데미지 추가 가능)
	UE_LOG(LogTemp, Warning, TEXT("몬스터가 플레이어를 공격합니다!"));
}

void AMonsterCharacter::BecomeEnraged()
{
	bIsEnraged = true;
	GetCharacterMovement()->MaxWalkSpeed = EnragedSpeed;
	UE_LOG(LogTemp, Warning, TEXT("몬스터가 분노 상태가 되었습니다!"));
}

---

🧠 Step 2: MonsterAIController 클래스

이 클래스는 AI의 '두뇌'입니다. Behavior Tree를 실행하고, 추적 대상을 설정하는 역할을 합니다.

MonsterAIController.h

UCLASS()
class MONSHOOTING_API AMonsterAIController : public AAIController
{
	GENERATED_BODY()

public:
	AMonsterAIController();
	virtual void BeginPlay() override;

	UPROPERTY(EditDefaultsOnly, Category = "AI")
	UBehaviorTree* BehaviorTreeAsset;

	void SetTargetActor(AActor* NewTarget);
};

MonsterAIController.cpp

AMonsterAIController::AMonsterAIController()
{
	// 에셋 로드: Behavior Tree는 리소스 경로가 정확해야 합니다!
	static ConstructorHelpers::FObjectFinder<UBehaviorTree> BTAsset(TEXT("/Game/AI/BT_MonsterBehavior"));
	if (BTAsset.Succeeded())
	{
		BehaviorTreeAsset = BTAsset.Object;
	}
}

void AMonsterAIController::BeginPlay()
{
	Super::BeginPlay();

	if (BehaviorTreeAsset)
	{
		RunBehaviorTree(BehaviorTreeAsset);

		// 타겟을 플레이어로 설정
		APawn* PlayerPawn = UGameplayStatics::GetPlayerPawn(GetWorld(), 0);
		if (PlayerPawn)
		{
			SetTargetActor(PlayerPawn);
		}
	}
}

void AMonsterAIController::SetTargetActor(AActor* NewTarget)
{
	if (GetBlackboardComponent())
	{
		GetBlackboardComponent()->SetValueAsObject(TEXT("TargetActor"), NewTarget);
	}
}

---

🧩 Step 3: Behavior Tree & Blackboard

AI의 행동을 시각적으로 조절할 수 있는 시스템입니다.
Blackboard는 기억 저장소, Behavior Tree는 행동 절차입니다.

Blackboard Key 목록

Key 이름	타입	용도
TargetActor	Object	추적 대상
IsEnraged	Bool	분노 상태

---

Behavior Tree 구조

[Root]
 └── Selector
      ├── Sequence
      │    ├── Check: TargetActor != null
      │    └── MoveTo(TargetActor)
      └── Task: AttackPlayer

---

⚙️ Step 4: 커스텀 Task 노드

AttackPlayer를 Behavior Tree 안에서 실행할 수 있게 해주는 C++ 클래스입니다.

BTTask_AttackPlayer.h

UCLASS()
class MONSHOOTING_API UBTTask_AttackPlayer : public UBTTaskNode
{
	GENERATED_BODY()

public:
	UBTTask_AttackPlayer();
	virtual EBTNodeResult::Type ExecuteTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory) override;
};

BTTask_AttackPlayer.cpp

EBTNodeResult::Type UBTTask_AttackPlayer::ExecuteTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory)
{
	AAIController* AIController = OwnerComp.GetAIOwner();
	if (!AIController) return EBTNodeResult::Failed;

	AMonsterCharacter* Monster = Cast<AMonsterCharacter>(AIController->GetPawn());
	if (!Monster) return EBTNodeResult::Failed;

	Monster->AttackPlayer(); // 실제 공격 실행

	return EBTNodeResult::Succeeded;
}

---

✅ 핵심 요약

구성 요소	역할
MonsterCharacter	플레이어와의 거리 체크 → 추적 → 공격 → 분노 상태 전환
MonsterAIController	Behavior Tree 실행 및 타겟 지정
Blackboard	TargetActor, IsEnraged 상태값 저장 및 관리
Behavior Tree	추적·공격 플로우 제어
커스텀 Task	BT에서 C++ 공격 함수(AttackPlayer()) 실행

---