feat(combat): cues de hit react + som punch + camera shake (cliente UE)

3 GameplayCueNotify_Burst BPs (taxonomia Lyra GameplayCue.Zeus.Combat.Hit.*):
  GC_Combat_Hit_React   -> PlayAnimMontage AM_HitReact_Light no alvo
  GC_Combat_Hit_Impact  -> SpawnSoundAtLocation SW_Punch_Cartoon na pos do alvo
  GC_Combat_Hit_Self    -> ClientStartCameraShake CS_HitReact no PC do alvo

Assets novos:
  AS_HitReact (+ AM_HitReact_Light/Medium/Heavy) -- montages de reacao
  SW_Punch_Cartoon -- SFX de impacto (0.3s)
  CS_HitReact -- LegacyCameraShake (osc 0.35s, pitch/roll/locZ)

DT_Abilities recriado (RowStruct ZeusAbilityDataRow): rows Dash+Kick com
AbilityClass + ActivateCueTag GameplayCue.Zeus.*. GC_Kick/GC_Dash com tags
renomeadas pro prefixo GameplayCue.* (filter do Asset Picker).

ZeusServerTags.ini: regenerado via ZeusTool tags sync (106 tags canonicas).

Source/Combat/ZeusAnimNotifyState_BodyHitWindow: AnimNotifyState que abre a
janela de hit detection (FootR capsule) durante o swing do Kick.

GC_Kick_Target removido (substituido por Combat.Hit.React reutilizavel).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Config/DefaultGame.ini

@@ -91,3 +91,12 @@ bShouldAcquireMissingChunksOnLoad=False
 bShouldWarnAboutInvalidAssets=True
 MetaDataTagsForAssetRegistry=()
 
+
+[/Script/GameplayAbilities.AbilitySystemGlobals]
+bUseDebugTargetFromHud=true
+
+[ConsoleVariables]
+; mostra cooldowns, ativações, falhas
+AbilitySystem.LogAbilityTriggers=1
+; mostra effects aplicados/removidos com magnitude
+AbilitySystem.DebugAbilityTags=1

Config/Tags/ZeusServerTags.ini

@@ -1,13 +1,29 @@
 ; Gerado por ZeusTool tags sync -- tags do ZeusServer p/ o cliente UE.
 ; NAO editar a mao: regenere com `ZeusTool tags sync <json> <ini>`.
 [/Script/GameplayTags.GameplayTagsList]
+GameplayTagList=(Tag="GameplayCue",DevComment="")
+GameplayTagList=(Tag="GameplayCue.Zeus",DevComment="")
+GameplayTagList=(Tag="GameplayCue.Zeus.Melee",DevComment="")
+GameplayTagList=(Tag="GameplayCue.Zeus.Melee.Kick",DevComment="")
+GameplayTagList=(Tag="GameplayCue.Zeus.Combat",DevComment="Categoria root de cues compartilhados por TODO melee (reutilizaveis)")
+GameplayTagList=(Tag="GameplayCue.Zeus.Combat.Hit",DevComment="Familia de cues do impacto de hit")
+GameplayTagList=(Tag="GameplayCue.Zeus.Combat.Hit.Impact",DevComment="Broadcast AOI - SFX impact + VFX sparks na location (todos ouvem)")
+GameplayTagList=(Tag="GameplayCue.Zeus.Combat.Hit.React",DevComment="Broadcast AOI - AnimMontage de hit react no target (todos veem)")
+GameplayTagList=(Tag="GameplayCue.Zeus.Combat.Hit.Self",DevComment="Unicast - feedback privado do alvo (camera shake, hit flash, rumble)")
+GameplayTagList=(Tag="GameplayCue.Zeus.Melee.Kick.Target",DevComment="")
+GameplayTagList=(Tag="GameplayCue.Zeus.Movement",DevComment="")
+GameplayTagList=(Tag="GameplayCue.Zeus.Movement.Dash",DevComment="")
 GameplayTagList=(Tag="Zeus",DevComment="")
 GameplayTagList=(Tag="Zeus.Ability",DevComment="")
 GameplayTagList=(Tag="Zeus.Ability.Casting",DevComment="")
 GameplayTagList=(Tag="Zeus.Ability.Channeling",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Melee",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Melee.Kick",DevComment="")
 GameplayTagList=(Tag="Zeus.Ability.Movement",DevComment="")
 GameplayTagList=(Tag="Zeus.Ability.Movement.Dash",DevComment="")
 GameplayTagList=(Tag="Zeus.Ability.Recovery",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Spell",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Spell.FireballRain",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Agi",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Aspd",DevComment="")
@@ -20,6 +36,7 @@ GameplayTagList=(Tag="Zeus.Attribute.Dex",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Flee",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Hit",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Hp",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.HpRegenRate",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Int",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.JobExp",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.JobLevel",DevComment="")
@@ -32,6 +49,9 @@ GameplayTagList=(Tag="Zeus.Attribute.MaxSp",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Mdef",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.SkillPoint",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Sp",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.SpRegenRate",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Stamina",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.StaminaRegenRate",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.StatusPoint",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Str",DevComment="")
 GameplayTagList=(Tag="Zeus.Attribute.Vit",DevComment="")
@@ -46,9 +66,7 @@ GameplayTagList=(Tag="Zeus.Combo.Slot2",DevComment="")
 GameplayTagList=(Tag="Zeus.Combo.Slot3",DevComment="")
 GameplayTagList=(Tag="Zeus.Combo.Window",DevComment="")
 GameplayTagList=(Tag="Zeus.Cooldown",DevComment="")
-GameplayTagList=(Tag="Zeus.Cue",DevComment="")
+GameplayTagList=(Tag="Zeus.Cooldown.FireballRain",DevComment="")
-GameplayTagList=(Tag="Zeus.Cue.Movement",DevComment="")
-GameplayTagList=(Tag="Zeus.Cue.Movement.Dash",DevComment="")
 GameplayTagList=(Tag="Zeus.Damage",DevComment="")
 GameplayTagList=(Tag="Zeus.Damage.Earth",DevComment="")
 GameplayTagList=(Tag="Zeus.Damage.Fire",DevComment="")
@@ -60,10 +78,23 @@ GameplayTagList=(Tag="Zeus.Damage.Shadow",DevComment="")
 GameplayTagList=(Tag="Zeus.Damage.Water",DevComment="")
 GameplayTagList=(Tag="Zeus.Damage.Wind",DevComment="")
 GameplayTagList=(Tag="Zeus.Effect",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Buff",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Buff.StrUp",DevComment="")
 GameplayTagList=(Tag="Zeus.Effect.Cooldown",DevComment="")
 GameplayTagList=(Tag="Zeus.Effect.Cooldown.Dash",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Cooldown.FireballRain",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Cooldown.Kick",DevComment="")
 GameplayTagList=(Tag="Zeus.Effect.Cost",DevComment="")
 GameplayTagList=(Tag="Zeus.Effect.Cost.Sp_10",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Cost.Sp_50",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Cost.Stamina_5",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Damage",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Damage.Kick",DevComment="")
+GameplayTagList=(Tag="Zeus.State",DevComment="")
+GameplayTagList=(Tag="Zeus.State.NoHpRegen",DevComment="")
+GameplayTagList=(Tag="Zeus.State.NoRegen",DevComment="")
+GameplayTagList=(Tag="Zeus.State.NoSpRegen",DevComment="")
+GameplayTagList=(Tag="Zeus.State.NoStaminaRegen",DevComment="")
 GameplayTagList=(Tag="Zeus.Status",DevComment="")
 GameplayTagList=(Tag="Zeus.Status.Buff",DevComment="")
 GameplayTagList=(Tag="Zeus.Status.CC",DevComment="")

Source/ZMMO/Game/Combat/ZeusAnimNotifyState_BodyHitWindow.cpp

@@ -0,0 +1,46 @@
+// Copyright Zeus Server Engine. All rights reserved.
+
+#include "ZeusAnimNotifyState_BodyHitWindow.h"
+
+#include "Components/SkeletalMeshComponent.h"
+#include "GameFramework/Actor.h"
+#include "Game/Entity/ZeusCharacter.h"
+
+void UZeusAnimNotifyState_BodyHitWindow::NotifyBegin(USkeletalMeshComponent* MeshComp,
+	UAnimSequenceBase* /*Animation*/, float /*TotalDuration*/,
+	const FAnimNotifyEventReference& /*EventReference*/)
+{
+	if (!MeshComp) { return; }
+	if (AZeusCharacter* Char = Cast<AZeusCharacter>(MeshComp->GetOwner()))
+	{
+		Char->SetHitColliderEnabled(Source, /*bEnabled*/ true);
+	}
+}
+
+void UZeusAnimNotifyState_BodyHitWindow::NotifyEnd(USkeletalMeshComponent* MeshComp,
+	UAnimSequenceBase* /*Animation*/, const FAnimNotifyEventReference& /*EventReference*/)
+{
+	if (!MeshComp) { return; }
+	if (AZeusCharacter* Char = Cast<AZeusCharacter>(MeshComp->GetOwner()))
+	{
+		Char->SetHitColliderEnabled(Source, /*bEnabled*/ false);
+	}
+}
+
+#if WITH_EDITOR
+FString UZeusAnimNotifyState_BodyHitWindow::GetNotifyName_Implementation() const
+{
+	const TCHAR* SourceLabel;
+	switch (Source)
+	{
+	case EZeusHitSource::FootR:   SourceLabel = TEXT("FootR");   break;
+	case EZeusHitSource::FootL:   SourceLabel = TEXT("FootL");   break;
+	case EZeusHitSource::HandR:   SourceLabel = TEXT("HandR");   break;
+	case EZeusHitSource::HandL:   SourceLabel = TEXT("HandL");   break;
+	case EZeusHitSource::WeaponR: SourceLabel = TEXT("WeaponR"); break;
+	case EZeusHitSource::WeaponL: SourceLabel = TEXT("WeaponL"); break;
+	default:                      SourceLabel = TEXT("?");       break;
+	}
+	return FString::Printf(TEXT("Zeus Body Hit (%s)"), SourceLabel);
+}
+#endif

Source/ZMMO/Game/Combat/ZeusAnimNotifyState_BodyHitWindow.h

@@ -0,0 +1,74 @@
+// Copyright Zeus Server Engine. All rights reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Animation/AnimNotifies/AnimNotifyState.h"
+#include "Game/Entity/ZeusCharacter.h"  // EZeusHitSource
+#include "ZeusAnimNotifyState_BodyHitWindow.generated.h"
+
+class USkeletalMeshComponent;
+class UAnimSequenceBase;
+
+/**
+ *  AnimNotifyState que liga o HitCollider de uma parte do corpo durante a sua
+ *  janela no montage. NotifyBegin liga + NotifyEnd desliga -- define o HIT
+ *  WINDOW do golpe melee/arma branca.
+ *
+ *  Generaliza para qualquer parte do corpo via EZeusHitSource:
+ *    - FootR / FootL  -> chute   (capsule attachado em foot_*_Socket)
+ *    - HandR / HandL  -> soco    (capsule em HandGrip_*)
+ *    - WeaponR / WeaponL -> arma branca (capsule em weapon_*)
+ *
+ *  === Como usar ===
+ *
+ *  No editor de um AnimMontage (ex: AM_Kick_Montage):
+ *    1. Encontrar o frame onde o membro comeca o movimento de impacto.
+ *    2. Right-click na track de notifies -> Add Notify State -> Zeus Body Hit Window.
+ *    3. Definir Source = FootR (ou HandR pra soco, WeaponR pra arma, etc).
+ *    4. Arrastar o range pra cobrir o arco completo do golpe (ex: frame 8 a 18
+ *       em 30fps = ~330ms de janela).
+ *
+ *  Pq AnimNotifyState e nao AnimNotify pontual:
+ *    - AnimNotify dispara em UM frame -> nao da' pra detectar entradas no
+ *      capsule durante a janela.
+ *    - AnimNotifyState tem NotifyBegin/NotifyTick/NotifyEnd. Pra "ligar
+ *      collider de frame X ate Y", e' o pattern correto.
+ *
+ *  === Replicacao ===
+ *
+ *  Roda LOCAL em cada cliente. Cliente do ATIVADOR liga capsule local + reporta
+ *  overlap via opcode MELEE_HIT_REPORT pro server. Server valida e aplica dano +
+ *  dispatcha cue Kick.Target pra todos no AOI do alvo.
+ *
+ *  Proxies de outros clientes tocam o montage via GameplayCue replicado (visual)
+ *  mas o capsule deles roda no PROXY que e' Pawn local de outra coisa -- nao
+ *  importa, o reportador autoritativo eh quem ativou a ability.
+ */
+UCLASS(meta = (DisplayName = "Zeus Body Hit Window"))
+class ZMMO_API UZeusAnimNotifyState_BodyHitWindow : public UAnimNotifyState
+{
+	GENERATED_BODY()
+
+public:
+	/// Qual parte do corpo (capsule) tem o hit ligado durante a janela.
+	/// Default = FootR (chute direito e' o golpe mais comum em montages
+	/// melee unarmed). Trocar pra HandR pra soco, WeaponR pra arma, etc.
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|Combat")
+	EZeusHitSource Source = EZeusHitSource::FootR;
+
+	// === AnimNotifyState overrides ===
+
+	virtual void NotifyBegin(USkeletalMeshComponent* MeshComp, UAnimSequenceBase* Animation,
+		float TotalDuration, const FAnimNotifyEventReference& EventReference) override;
+
+	virtual void NotifyEnd(USkeletalMeshComponent* MeshComp, UAnimSequenceBase* Animation,
+		const FAnimNotifyEventReference& EventReference) override;
+
+#if WITH_EDITOR
+	/// Mostra "Zeus Body Hit (FootR/HandL/WeaponR/...)" no editor de montage em
+	/// vez do nome generico da classe -- ajuda a identificar qual parte sem
+	/// abrir details.
+	virtual FString GetNotifyName_Implementation() const override;
+#endif
+};

Source/ZMMO/Game/Entity/ZeusCharacter.cpp

@@ -173,6 +173,12 @@ void AZeusCharacter::Tick(const float DeltaSeconds)
 
 void AZeusCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
 {
+	// IMPORTANTE: chamar Super:: pra que BPs filhos consigam auto-bindar
+	// nodes EnhancedInputAction no Event Graph (ex: GA_Kick / IA_Kick no
+	// BP_ThirdPersonCharacter). Sem isso, bindings em BP ficam orfaos --
+	// so' bindings C++ (Move/Look/Jump/Dash abaixo) recebem input.
+	Super::SetupPlayerInputComponent(PlayerInputComponent);
+
 	if (UEnhancedInputComponent* EnhancedInputComponent = Cast<UEnhancedInputComponent>(PlayerInputComponent))
 	{
 		EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Started, this, &AZeusCharacter::OnJumpPressed);

Source/ZMMO/Game/Modes/ZeusGameMode.cpp

@@ -5,10 +5,47 @@
 #include "ZeusPlayerController.h"
 #include "ZeusPlayerState.h"
 
+#include "UObject/ConstructorHelpers.h"
+
 AZeusGameMode::AZeusGameMode()
 {
-	DefaultPawnClass = AZeusCharacter::StaticClass();
+	// DefaultPawnClass: usar o BP filho (BP_ThirdPersonCharacter) em vez do
+	// C++ puro. BPs filhos so' sao instanciados se o pawn possessed for da
+	// classe BP -- caso contrario o engine cria a classe C++ direta e perde
+	// TUDO que o designer fez no BP (EnhancedInputAction events, AnimBP wire,
+	// hooks de ability, componentes adicionados via editor).
+	//
+	// Fallback pra AZeusCharacter pura se o asset BP nao existir (asset
+	// renomeado/deletado por engano -- nao deve acontecer em prod).
+	static ConstructorHelpers::FClassFinder<APawn> DefaultPawnBP(
+		TEXT("/Game/ZMMO/Core/Player/BP_ZeusPlayerCharacter"));
+	if (DefaultPawnBP.Succeeded())
+	{
+		DefaultPawnClass = DefaultPawnBP.Class;
+	}
+	else
+	{
+		DefaultPawnClass = AZeusCharacter::StaticClass();
+	}
+
 	PlayerControllerClass = AZeusPlayerController::StaticClass();
-	PlayerStateClass = AZeusPlayerState::StaticClass();
+
+	// PlayerStateClass: usar BP filho pelo mesmo motivo do DefaultPawnClass --
+	// componentes BP-added (ex: UZeusGASComponent listado em DefaultGame.ini
+	// ComponentClasses), eventos no Event Graph e overrides do designer so'
+	// existem na classe BP. C++ direto (AZeusPlayerState) perde tudo isso.
+	// TODO: renomear o asset pra BP_ZeusPlayerState pra alinhar com a convencao
+	// (BP_ZeusPlayerCharacter) -- quando renomear, atualizar o path aqui.
+	static ConstructorHelpers::FClassFinder<APlayerState> PlayerStateBP(
+		TEXT("/Game/ZMMO/Core/Player/BP_PlayerState"));
+	if (PlayerStateBP.Succeeded())
+	{
+		PlayerStateClass = PlayerStateBP.Class;
+	}
+	else
+	{
+		PlayerStateClass = AZeusPlayerState::StaticClass();
+	}
+
 	HUDClass = AZeusHUD::StaticClass();
 }

ZMMO.uproject

@@ -76,6 +76,10 @@
 		{
 			"Name": "CommonUI",
 			"Enabled": true
+		},
+		{
+			"Name": "GameplayAbilities",
+			"Enabled": true
 		}
 	],
 	"AdditionalPluginDirectories": [