Unreal Engine C++ Pro

Esta habilidade fornece diretrizes de nível especialista para desenvolver com Unreal Engine 5 usando C++. Ela foca em escrever código robusto, performático e em conformidade com os padrões.

Quando Usar

Use esta habilidade quando:

• Desenvolver código C++ para projetos Unreal Engine 5.x
• Escrever Actors, Components ou classes derivadas de UObject
• Otimizar código crítico de performance no Unreal Engine
• Depurar vazamentos de memória ou problemas de coleta de lixo
• Implementar funcionalidades expostas para Blueprints
• Seguir os padrões e convenções de codificação da Epic Games
• Trabalhar com o sistema de reflexão do Unreal (UCLASS, USTRUCT, UFUNCTION)
• Gerenciar carregamento de assets e referências "soft"

Não use esta habilidade quando:

• Trabalhar com projetos apenas em Blueprint (sem código C++)
• Desenvolver para versões do Unreal Engine anteriores à 5.x
• Trabalhar em engines de jogos não-Unreal
• A tarefa não estiver relacionada ao desenvolvimento do Unreal Engine

Princípios Fundamentais

1. UObject e Coleta de Lixo:

   • Sempre use UPROPERTY() para variáveis membro UObject* para garantir que sejam rastreadas pelo Coletor de Lixo (GC).
   • Use TStrongObjectPtr<> se precisar manter uma referência raiz fora de um grafo UObject, mas prefira addToRoot() geralmente.
   • Entenda a verificação IsValid() versus nullptr. IsValid() lida com o estado de "pendente de exclusão" de forma segura.

2. Sistema de Reflexão do Unreal:

   • Use UCLASS(), USTRUCT(), UENUM(), UFUNCTION() para expor tipos ao sistema de reflexão e aos Blueprints.
   • Minimize BlueprintReadWrite quando possível; prefira BlueprintReadOnly para estados que não devem ser sobrescritos por lógica em BPs de UI/Level.

3. Performance em Primeiro Lugar:

   • Tick: Desabilite o Tick (bCanEverTick = false) por padrão. Habilite-o apenas se for absolutamente necessário. Prefira timers (GetWorldTimerManager()) ou lógica orientada a eventos.
   • Casting: Evite Cast<T>() em loops "quentes". Armazene referências em cache em BeginPlay.
   • Structs vs Classes: Use structs F para tipos pesados em dados e não-UObject para reduzir a sobrecarga.

Convenções de Nomenclatura (Estritas)

Siga o padrão de codificação da Epic Games:

• Templates: Prefixo T (ex: TArray, TMap).
• UObject: Prefixo U (ex: UCharacterMovementComponent).
• AActor: Prefixo A (ex: AMyGameMode).
• SWidget: Prefixo S (widgets Slate).
• Structs: Prefixo F (ex: FVector).
• Enums: Prefixo E (ex: EWeaponState).
• Interfaces: Prefixo I (ex: IInteractable).
• Booleans: Prefixo b (ex: bIsDead).

Padrões Comuns

1. Busca Robusta de Componentes

Evite GetComponentByClass em Tick. Faça isso em PostInitializeComponents ou BeginPlay.

void AMyCharacter::PostInitializeComponents() {
    Super::PostInitializeComponents();
    HealthComp = FindComponentByClass<UHealthComponent>();
    check(HealthComp); // Fail hard in dev if missing
}

2. Implementação de Interface

Use interfaces para desacoplar sistemas (ex: sistema de Interação).

// Interface call check
if (TargetActor->Implements<UInteractable>()) {
    IInteractable::Execute_OnInteract(TargetActor, this);
}

3. Carregamento Assíncrono (Referências "Soft")

Evite referências "hard" (UPROPERTY(EditDefaultsOnly) TSubclassOf<AActor>) para assets massivos que forçam ordens de carregamento. Use TSoftClassPtr ou TSoftObjectPtr.

UPROPERTY(EditAnywhere, BlueprintReadWrite)
TSoftClassPtr<AWeapon> WeaponClassToLoad;

void AMyCharacter::Equip() {
    if (WeaponClassToLoad.IsPending()) {
        WeaponClassToLoad.LoadSynchronous(); // Or use StreamableManager for async
    }
}

Depuração

• Logging: Use UE_LOG com categorias personalizadas.

  DEFINE_LOG_CATEGORY_STATIC(LogMyGame, Log, All);
  UE_LOG(LogMyGame, Warning, TEXT("Health is low: %f"), CurrentHealth);
  

• Mensagens na Tela:

  if (GEngine) GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Red, TEXT("Died!"));
  

• Visual Logger: Extremamente útil para depurar IA. Implemente IVisualLoggerDebugSnapshotInterface.

Checklist antes do PR

• Este Actor precisa dar Tick? Pode ser um Timer?
• Todos os membros UObject* estão encapsulados em UPROPERTY?
• Referências "hard" (TSubclassOf) estão causando cadeias de carregamento? Podem ser Ponteiros "Soft"?
• Você limpou delegates verificados em EndPlay?

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.

…