Merge pull request 'Consolidar GameplayAbilitySystem na main (baseline cliente tudo funcionando 2026-06-16)' (#6) from GameplayAbilitySystem into main

Reviewed-on: #6

Config/DefaultEngine.ini

@@ -2,9 +2,9 @@
 GameDefaultMap=/Game/ZMMO/Maps/FrontEnd/L_FrontEnd.L_FrontEnd
 EditorStartupMap=/Game/ZMMO/Maps/FrontEnd/L_FrontEnd.L_FrontEnd
 ; GameMode/PlayerController/PlayerCharacter agora moram em C++ (Game/Modes/Entity/Controller).
-; O motor pode spawnar AZMMOGameMode directamente; um BP filho continua opcional.
-GlobalDefaultGameMode=/Script/ZMMO.ZMMOGameMode
-GameInstanceClass=/Script/ZMMO.ZMMOGameInstance
+; O motor pode spawnar AZeusGameMode directamente; um BP filho continua opcional.
+GlobalDefaultGameMode=/Script/ZMMO.ZeusGameMode
+GameInstanceClass=/Script/ZMMO.ZeusGameInstance
 
 [/Script/Engine.RendererSettings]
 r.ReflectionMethod=1
@@ -80,12 +80,30 @@ GameViewportClientClassName=/Script/CommonUI.CommonGameViewportClient
 +ActiveGameNameRedirects=(OldGameName="TP_ThirdPerson",NewGameName="/Script/ZMMO")
 +ActiveGameNameRedirects=(OldGameName="/Script/TP_ThirdPerson",NewGameName="/Script/ZMMO")
 ; Redirects do template antigo para a nova arquitectura (Game/Modes/Entity/Controller).
-; ZMMOCharacter foi reescrito como ZMMOPlayerCharacter (ACharacter local com CMC livre).
-+ActiveClassRedirects=(OldClassName="TP_ThirdPersonPlayerController",NewClassName="ZMMOPlayerController")
-+ActiveClassRedirects=(OldClassName="TP_ThirdPersonGameMode",NewClassName="ZMMOGameMode")
-+ActiveClassRedirects=(OldClassName="TP_ThirdPersonCharacter",NewClassName="ZMMOPlayerCharacter")
-+ActiveClassRedirects=(OldClassName="ZMMOCharacter",NewClassName="ZMMOPlayerCharacter")
-
+; Pipeline: TP_ThirdPerson* -> ZMMO* (legado) -> Zeus* (atual). Os redirects de
+; ZMMO*->Zeus* preservam asset/BP refs criadas durante o periodo ZMMO* (Batches 1-3).
++ActiveClassRedirects=(OldClassName="TP_ThirdPersonPlayerController",NewClassName="ZeusPlayerController")
++ActiveClassRedirects=(OldClassName="TP_ThirdPersonGameMode",NewClassName="ZeusGameMode")
++ActiveClassRedirects=(OldClassName="TP_ThirdPersonCharacter",NewClassName="ZeusCharacter")
++ActiveClassRedirects=(OldClassName="ZMMOCharacter",NewClassName="ZeusCharacter")
++ActiveClassRedirects=(OldClassName="ZMMOPlayerCharacter",NewClassName="ZeusCharacter")
++ActiveClassRedirects=(OldClassName="ZMMOPlayerController",NewClassName="ZeusPlayerController")
++ActiveClassRedirects=(OldClassName="ZMMOFrontEndPlayerController",NewClassName="ZeusFrontEndPlayerController")
++ActiveClassRedirects=(OldClassName="ZMMOGameMode",NewClassName="ZeusGameMode")
++ActiveClassRedirects=(OldClassName="ZMMOFrontEndGameMode",NewClassName="ZeusFrontEndGameMode")
++ActiveClassRedirects=(OldClassName="ZMMOGameInstance",NewClassName="ZeusGameInstance")
++ActiveClassRedirects=(OldClassName="ZMMOHUD",NewClassName="ZeusHUD")
++ActiveClassRedirects=(OldClassName="ZMMOPlayerState",NewClassName="ZeusPlayerState")
++ActiveClassRedirects=(OldClassName="ZMMOEntity",NewClassName="ZeusEntity")
++ActiveClassRedirects=(OldClassName="ZMMOPlayerProxy",NewClassName="ZeusPlayerProxy")
++ActiveClassRedirects=(OldClassName="ZMMOProxyMovementComponent",NewClassName="ZeusProxyMovementComponent")
++ActiveClassRedirects=(OldClassName="ZMMOWorldSubsystem",NewClassName="ZeusWorldSubsystem")
++ActiveClassRedirects=(OldClassName="ZMMOThemeDataAsset",NewClassName="ZeusThemeDataAsset")
++ActiveClassRedirects=(OldClassName="ZMMOThemeSubsystem",NewClassName="ZeusThemeSubsystem")
++ActiveClassRedirects=(OldClassName="ZMMOLoginSaveGame",NewClassName="ZeusLoginSaveGame")
++ActiveClassRedirects=(OldClassName="ZMMOHudWidget",NewClassName="ZeusHudWidget")
++ActiveClassRedirects=(OldClassName="ZMMOHudPlayerVitalsWidget",NewClassName="ZeusHudPlayerVitalsWidget")
++ActiveClassRedirects=(OldClassName="ZMMOLoadingProfilesDataAsset",NewClassName="ZeusLoadingProfilesDataAsset")
 [CoreRedirects]
 ; Migração v1→v2 do FUIStylePanel: TMap<EUIPanelTexture,...> (Enum) → TMap<FName,...>.
 ; Os campos *_DEPRECATED preservam a leitura do asset antigo; PostSerialize copia
@@ -95,6 +113,27 @@ GameViewportClientClassName=/Script/CommonUI.CommonGameViewportClient
 +PropertyRedirects=(OldName="/Script/ZMMO.UIStylePanel.PanelOutline",NewName="/Script/ZMMO.UIStylePanel.PanelOutline_DEPRECATED")
 +PropertyRedirects=(OldName="/Script/ZMMO.UIStylePanel.PanelOutlineEffect",NewName="/Script/ZMMO.UIStylePanel.PanelOutlineEffect_DEPRECATED")
 
+; --- M7: Modulo cliente "ZMMOJobs" foi renomeado pra "ZeusJobs" + classe
+; UZMMOJobDataAsset -> UZeusJobDataAsset. Os 7 DA_Job_* em /Game/ZMMO/Data/Jobs/
+; foram salvos apontando pra /Script/ZMMOJobs.ZMMOJobDataAsset (modulo + classe
+; antigos). ActiveClassRedirects so' troca o NOME da classe, nao o package;
+; precisamos de CoreRedirects com path completo + PackageRedirect.
++PackageRedirects=(OldName="/Script/ZMMOJobs",NewName="/Script/ZeusJobs")
++ClassRedirects=(OldName="/Script/ZMMOJobs.ZMMOJobDataAsset",NewName="/Script/ZeusJobs.ZeusJobDataAsset")
+
+; --- M7: USTRUCTs renomeadas (mesmo modulo ZMMO). DTs salvos com Row Structure
+; apontando pro nome antigo (ZMMOMapDef, ZMMOLoadingTipRow). USTRUCT usa
+; +StructRedirects (nao +ClassRedirects).
++StructRedirects=(OldName="/Script/ZMMO.ZMMOMapDef",NewName="/Script/ZMMO.ZeusMapDef")
++StructRedirects=(OldName="/Script/ZMMO.ZMMOLoadingTipRow",NewName="/Script/ZMMO.ZeusLoadingTipRow")
+; DA_LoadingProfiles salvo com TMap<EZMMOLoadingContext, FZMMOLoadingProfile>;
+; FZMMOLoadingProfile contem TArray<FZMMOLoadingStepDef>. Precisa de 3 redirects
+; (1 enum + 2 struct) pra carregar sem warnings nem perda de dados.
++EnumRedirects=(OldName="/Script/ZMMO.EZMMOLoadingContext",NewName="/Script/ZMMO.EZeusLoadingContext")
++EnumRedirects=(OldName="/Script/ZMMO.EZMMOLoadingStepStatus",NewName="/Script/ZMMO.EZeusLoadingStepStatus")
++StructRedirects=(OldName="/Script/ZMMO.ZMMOLoadingProfile",NewName="/Script/ZMMO.ZeusLoadingProfile")
++StructRedirects=(OldName="/Script/ZMMO.ZMMOLoadingStepDef",NewName="/Script/ZMMO.ZeusLoadingStepDef")
+
 [/Script/AndroidFileServerEditor.AndroidFileServerRuntimeSettings]
 bEnablePlugin=True
 bAllowNetworkConnection=True

Config/DefaultGame.ini

@@ -3,10 +3,10 @@ ProjectID=FC3E256F43B2AFD43009F4949B0814BE
 ProjectName=Third Person Game Template
 
 ; -----------------------------------------------------------------------------
-; ZMMO Theme subsystem (see Source/ZMMO/Game/UI/ZMMOThemeSubsystem.h and
+; ZMMO Theme subsystem (see Source/ZMMO/Game/UI/ZeusThemeSubsystem.h and
 ; ARQUITETURA.md §1.10 / §4.7).
 ;
-; - DefaultThemeAsset is the fallback theme (must define every EZMMOThemeKey).
+; - DefaultThemeAsset is the fallback theme (must define every EZeusThemeKey).
 ; - ThemeRegistry maps ThemeId -> seasonal DA_Theme_* asset.
 ; - CalendarTable points to DT_ThemeCalendar (FThemeCalendarRow rows).
 ; - UIStyleTable points to DT_UI_Styles (FUIStyleRow rows): tokens de estilo
@@ -18,7 +18,7 @@ ProjectName=Third Person Game Template
 ; assets are actually created in the editor.
 ; -----------------------------------------------------------------------------
 
-[/Script/ZMMO.ZMMOThemeSubsystem]
+[/Script/ZMMO.ZeusThemeSubsystem]
 ;DefaultThemeAsset=/Game/ZMMO/UI/Themes/DA_Theme_Default.DA_Theme_Default
 ;+ThemeRegistry=(("Christmas", "/Game/ZMMO/UI/Themes/DA_Theme_Christmas.DA_Theme_Christmas"))
 ;+ThemeRegistry=(("Halloween", "/Game/ZMMO/UI/Themes/DA_Theme_Halloween.DA_Theme_Halloween"))
@@ -33,20 +33,20 @@ ScreenSetAsset=/Game/ZMMO/UI/FrontEnd/DA_FrontEndScreenSet.DA_FrontEndScreenSet
 
 ; Fase 4 — char spawn DB-driven. DT_Maps espelha o `maps_config.json` do
 ; server (Server/ZeusServerEngine/Config/DataTables/maps_config.json) — o
-; cliente resolve `mapId -> ClientLevel/spawns` via FZMMOMapDef rows.
+; cliente resolve `mapId -> ClientLevel/spawns` via FZeusMapDef rows.
 MapsTableAsset=/Game/ZMMO/Data/World/DT_Maps.DT_Maps
 
 ; Loading dinâmico (etapas + dicas). DA_LoadingProfiles tem 1 perfil por
-; contexto (EZMMOLoadingContext); DT_LoadingTips rotaciona durante o load.
+; contexto (EZeusLoadingContext); DT_LoadingTips rotaciona durante o load.
 ; Cliente local marca etapas via eventos (sem opcode novo).
 LoadingProfilesAsset=/Game/ZMMO/Data/UI/Loading/DA_LoadingProfiles.DA_LoadingProfiles
 LoadingTipsAsset=/Game/ZMMO/Data/UI/Loading/DT_LoadingTips.DT_LoadingTips
 
 ; -----------------------------------------------------------------------------
 ; UI in-game (PR 19+). Espelho do front-end pattern:
-; - ScreenSetAsset mapeia EZMMOInGameUIState -> WBP (Playing -> WBP_HUD,
+; - ScreenSetAsset mapeia EZeusInGameUIState -> WBP (Playing -> WBP_HUD,
 ;   StatusWindow -> WBP_StatusWindow, etc.)
-; - Subsystem orquestra: AZMMOHUD::BeginPlay chama StartInGame que vai pra
+; - Subsystem orquestra: AZeusHUD::BeginPlay chama StartInGame que vai pra
 ;   Playing.
 ; Asset criado via MCP em /Game/ZMMO/UI/InGame/DA_InGameScreenSet.
 ; -----------------------------------------------------------------------------
@@ -56,16 +56,27 @@ ScreenSetAsset=/Game/ZMMO/UI/InGame/DA_InGameScreenSet.DA_InGameScreenSet
 
 ; -----------------------------------------------------------------------------
 ; PlayerState Component Registry (PR 19+). Cada módulo MMO registra seus
-; UActorComponent aqui. O AZMMOPlayerState lê esta lista no construtor e
+; UActorComponent aqui. O AZeusPlayerState lê esta lista no construtor e
 ; instancia cada classe como subobject — pattern Open-Closed: adicionar
-; Inventory/Skills/Guild = mais uma linha aqui, sem editar AZMMOPlayerState.
+; Inventory/Skills/Guild = mais uma linha aqui, sem editar AZeusPlayerState.
 ;
 ; Convenção: usa o path /Script/<Module>.<ClassName> (sem o "U" do prefixo
 ; C++; UClass resolve pelo nome curto).
 ; -----------------------------------------------------------------------------
 
-[/Script/ZMMO.ZMMOPlayerState]
-+ComponentClasses=/Script/ZMMOAttributes.ZMMOAttributeComponent
+[/Script/ZMMO.ZeusPlayerState]
+; UZeusGASComponent (plugin ZeusGAS) — dono unico dos atributos do char (M7).
+; Owns UZeusAbilitySystemComponent + UZeusAttributeSet (26 atributos
+; espelhados do server CharAttributeSet). Bridge via UZeusGASNetworkHandler
+; (UWorldSubsystem) subscribe nos delegates do UZeusNetworkSubsystem.
++ComponentClasses=/Script/ZeusGAS.ZeusGASComponent
+
+; === GAS Cue paths (Batch 2.5 — S_ABILITY_CUE multicast cosmetico) ===
+; UGameplayCueManager scaneia esses paths no boot pra mapear FGameplayTag
+; -> AGameplayCueNotify_Actor BP. UZeusGASComponent::DispatchAbilityCue chama
+; ASC->ExecuteGameplayCueLocal(CueTag, params) -> manager resolve pelo path.
+[/Script/GameplayAbilities.AbilitySystemGlobals]
++GameplayCueNotifyPaths="/Game/ZMMO/GAS/Cues"
 
 [/Script/Engine.AssetManagerSettings]
 -PrimaryAssetTypesToScan=(PrimaryAssetType="Map",AssetBaseClass=/Script/Engine.World,bHasBlueprintClasses=False,bIsEditorOnly=True,Directories=((Path="/Game/Maps")),SpecificAssets=,Rules=(Priority=-1,ChunkId=-1,bApplyRecursively=True,CookRule=Unknown))

Config/DefaultZeusV1.ini

@@ -0,0 +1,19 @@
+; DefaultZeusV1.ini
+; Config inicial pra UZeusNetworkingClientSubsystem (P9-6/P9-7 plugin).
+; Editar via UE Project Settings -> Plugins -> Zeus V1 OU editar este arquivo
+; e relancar o editor.
+;
+; PORT 7777: ZeusGateway. NodeService popula routes via charId lookup quando
+; cliente conecta (validado: handshake routed charId=7 -> SP_01 cell 0). Fluxo
+; padrao de producao -- UE conecta no Gateway, Gateway resolve cell ownership
+; via lease em Valkey + encaminha pro ZS correto.
+;
+; ALTERNATIVO (debug only -- bug aberto pendente investigacao):
+; ServerPort=9001 conecta DIRETO em SP_01 mas hoje pacote UE nao chega no
+; server (FUdpSocketBuilder + Windows multi-NIC loopback issue). Use 7777.
+
+[/Script/ZeusNetwork.ZeusNetworkingClientSubsystem]
+ServerHost=127.0.0.1
+ServerPort=7777
+bUseZeusNetworkingV1=True
+bAutoConnectOnStart=True

Config/Tags/ZeusServerTags.ini

@@ -0,0 +1,83 @@
+; 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="Zeus",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Casting",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Channeling",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Movement",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Movement.Dash",DevComment="")
+GameplayTagList=(Tag="Zeus.Ability.Recovery",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Agi",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Aspd",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Atk",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.BaseExp",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.BaseLevel",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Crit",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Def",DevComment="")
+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.Int",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.JobExp",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.JobLevel",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Luk",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Matk",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.MatkMax",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.MatkMin",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.MaxHp",DevComment="")
+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.StatusPoint",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Str",DevComment="")
+GameplayTagList=(Tag="Zeus.Attribute.Vit",DevComment="")
+GameplayTagList=(Tag="Zeus.Combat",DevComment="")
+GameplayTagList=(Tag="Zeus.Combat.Blocking",DevComment="")
+GameplayTagList=(Tag="Zeus.Combat.Dodging",DevComment="")
+GameplayTagList=(Tag="Zeus.Combat.InCombat",DevComment="")
+GameplayTagList=(Tag="Zeus.Combat.LockOn",DevComment="")
+GameplayTagList=(Tag="Zeus.Combo",DevComment="")
+GameplayTagList=(Tag="Zeus.Combo.Slot1",DevComment="")
+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.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="")
+GameplayTagList=(Tag="Zeus.Damage.Holy",DevComment="")
+GameplayTagList=(Tag="Zeus.Damage.Magical",DevComment="")
+GameplayTagList=(Tag="Zeus.Damage.Physical",DevComment="")
+GameplayTagList=(Tag="Zeus.Damage.Poison",DevComment="")
+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.Cooldown",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Cooldown.Dash",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Cost",DevComment="")
+GameplayTagList=(Tag="Zeus.Effect.Cost.Sp_10",DevComment="")
+GameplayTagList=(Tag="Zeus.Status",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Buff",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC.Disarmed",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC.Feared",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC.Frozen",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC.KnockedDown",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC.Rooted",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC.Silenced",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.CC.Stunned",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Dead",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Debuff",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Invulnerable",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Regen",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Regen.Blocked",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Regen.Boosted",DevComment="")
+GameplayTagList=(Tag="Zeus.Status.Regen.Poisoned",DevComment="")

Source/ZMMO/Data/UI/FrontEndTypes.h

@@ -10,17 +10,17 @@
  *
  * Fluxo: Boot → Connecting → Login → ServerSelect → Lobby → EnteringWorld
  * → InWorld. O Lobby é o hub principal logado; suas páginas internas são
- * EZMMOLobbyPage (não são estados de topo — ver ARQUITETURA.md §4.8).
+ * EZeusLobbyPage (não são estados de topo — ver ARQUITETURA.md §4.8).
  */
 UENUM(BlueprintType)
-enum class EZMMOFrontEndState : uint8
+enum class EZeusFrontEndState : uint8
 {
 	None,
 	Boot,			// splash inicial enquanto subsistemas sobem
 	Connecting,		// conectando ao servidor Zeus (UDP)
 	Login,			// autenticação
 	ServerSelect,	// escolha de servidor/realm
-	Lobby,			// hub principal logado (host das EZMMOLobbyPage)
+	Lobby,			// hub principal logado (host das EZeusLobbyPage)
 	EnteringWorld,	// loading/handoff: OpenLevel do mapa de mundo
 	InWorld			// no mundo (HUD de gameplay assume)
 };
@@ -30,7 +30,7 @@ enum class EZMMOFrontEndState : uint8
  * de Lobby ("Switch principal"), não pelo fluxo de topo.
  */
 UENUM(BlueprintType)
-enum class EZMMOLobbyPage : uint8
+enum class EZeusLobbyPage : uint8
 {
 	None,
 	CharacterSelect,

Source/ZMMO/Data/UI/InGameTypes.h

@@ -7,7 +7,7 @@
  *  Estados da UI in-game. Dirigidos pelo UUIInGameFlowSubsystem; cada estado
  *  resolve uma tela (UCommonActivatableWidget) via DA_InGameScreenSet.
  *
- *  Espelha simetricamente EZMMOFrontEndState (Data/UI/FrontEndTypes.h):
+ *  Espelha simetricamente EZeusFrontEndState (Data/UI/FrontEndTypes.h):
  *   - Front-end usa estados pra Login/ServerSelect/Lobby (UI.Layer.Menu)
  *   - In-game usa estados pra HUD/Status/Inventory/Skills (UI.Layer.Game + GameMenu)
  *
@@ -22,7 +22,7 @@
  *  Layer.GameMenu por cima dele.
  */
 UENUM(BlueprintType)
-enum class EZMMOInGameUIState : uint8
+enum class EZeusInGameUIState : uint8
 {
 	None,           ///< Antes do player local spawnar; UI in-game inativa.
 	Playing,        ///< HUD principal visivel (HP/SP/level/etc).

Source/ZMMO/Data/UI/LoadingTypes.h

@@ -5,14 +5,14 @@
 
 /**
  *  Contexto do loading screen genérico. Cada contexto resolve um perfil
- *  (lista de etapas) no UZMMOLoadingProfilesDataAsset.
+ *  (lista de etapas) no UZeusLoadingProfilesDataAsset.
  *
  *  Cliente local rastreia o progresso assinando eventos próprios
  *  (HandlePostLoadMap, OnPlayerSpawned, etc) — server não envia opcode de
  *  progresso, ver decisão em [[project_ui_loading_dynamic]].
  */
 UENUM(BlueprintType)
-enum class EZMMOLoadingContext : uint8
+enum class EZeusLoadingContext : uint8
 {
 	None,
 	FrontEndEnteringWorld,	///< FrontEnd → mundo (handoff CharServer→WorldServer + spawn).
@@ -21,7 +21,7 @@ enum class EZMMOLoadingContext : uint8
 };
 
 UENUM(BlueprintType)
-enum class EZMMOLoadingStepStatus : uint8
+enum class EZeusLoadingStepStatus : uint8
 {
 	Pending,	///< Ainda não começou.
 	Running,	///< Em andamento (o "barber pole").
@@ -34,7 +34,7 @@ enum class EZMMOLoadingStepStatus : uint8
  *  pra chamar MarkStepDone(StepId); Label é o texto localizado mostrado.
  */
 USTRUCT(BlueprintType)
-struct FZMMOLoadingStepDef
+struct FZeusLoadingStepDef
 {
 	GENERATED_BODY()
 
@@ -52,13 +52,13 @@ struct FZMMOLoadingStepDef
  *  consulta StepId pra avançar etapa.
  */
 USTRUCT(BlueprintType)
-struct FZMMOLoadingProfile
+struct FZeusLoadingProfile
 {
 	GENERATED_BODY()
 
 	/** Etapas em ordem. ProgressBar = #Done / #Steps. */
 	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Loading")
-	TArray<FZMMOLoadingStepDef> Steps;
+	TArray<FZeusLoadingStepDef> Steps;
 
 	/** Título da tela (vazio = usa default da classe). */
 	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Loading")

Source/ZMMO/Data/UI/ThemeKeys.h

@@ -4,7 +4,7 @@
 #include "ThemeKeys.generated.h"
 
 UENUM(BlueprintType)
-enum class EZMMOThemeKey : uint8
+enum class EZeusThemeKey : uint8
 {
 	// HUD
 	HUD_Frame               UMETA(DisplayName = "HUD - Frame"),

Source/ZMMO/Data/UI/UILayerTags.cpp

@@ -1,6 +1,6 @@
 #include "UI/UILayerTags.h"
 
-namespace ZMMOUITags
+namespace ZeusUITags
 {
 	UE_DEFINE_GAMEPLAY_TAG(UI_Layer_Game, "UI.Layer.Game");
 	UE_DEFINE_GAMEPLAY_TAG(UI_Layer_GameMenu, "UI.Layer.GameMenu");

Source/ZMMO/Data/UI/UILayerTags.h

@@ -12,7 +12,7 @@
  *   UI.Layer.Menu     — front-end (Boot/Login/ServerSelect/Lobby)
  *   UI.Layer.Modal    — diálogos/loading por cima de tudo
  */
-namespace ZMMOUITags
+namespace ZeusUITags
 {
 	ZMMO_API UE_DECLARE_GAMEPLAY_TAG_EXTERN(UI_Layer_Game);
 	ZMMO_API UE_DECLARE_GAMEPLAY_TAG_EXTERN(UI_Layer_GameMenu);

Source/ZMMO/Data/UI/UIStyleRow.h

@@ -73,7 +73,7 @@ struct ZMMO_API FUIStyle
 /**
  * Linha de DT_UI_Styles. O Row Name é o ThemeId (ex.: "Default", "RPG"),
  * espelhando DT_ThemeCalendar e ThemeRegistry — assim a camada de estilo
- * é consumidora do ThemeId já resolvido pelo UZMMOThemeSubsystem.
+ * é consumidora do ThemeId já resolvido pelo UZeusThemeSubsystem.
  */
 USTRUCT(BlueprintType)
 struct ZMMO_API FUIStyleRow : public FTableRowBase
@@ -87,7 +87,7 @@ struct ZMMO_API FUIStyleRow : public FTableRowBase
 	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "UI Style")
 	EUITheme Theme = EUITheme::None;
 
-	/** Ponte para o ThemeId resolvido pelo UZMMOThemeSubsystem. */
+	/** Ponte para o ThemeId resolvido pelo UZeusThemeSubsystem. */
 	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "UI Style")
 	FName ThemeId;
 

Source/ZMMO/Data/UI/UIStyleTypes.h

@@ -7,7 +7,7 @@
  * Enums do sistema de UI Style (tokens de tema visual).
  *
  * Espelha ThemeKeys.h: enums fortes, BlueprintType, primeiro valor None.
- * O conceito de "tema ativo" continua sendo do UZMMOThemeSubsystem
+ * O conceito de "tema ativo" continua sendo do UZeusThemeSubsystem
  * (resolvido por FName ThemeId). EUITheme é apenas validação tipada de
  * design-time ao preencher DT_UI_Styles — não é a chave de runtime.
  */

Source/ZMMO/Data/World/MapDef.h

@@ -7,7 +7,7 @@
 #include "MapDef.generated.h"
 
 /**
- *  FZMMOMapSpawn
+ *  FZeusMapSpawn
  *
  *  Ponto de spawn dentro de um mapa, identificado por `Tag`. Usado pelo
  *  server pra decidir onde materializar um char quando ele entra:
@@ -15,12 +15,12 @@
  *    - Char saindo de raid:    pode pedir tag="raid_return"
  *    - Char morto:             pode pedir tag="graveyard"
  *
- *  ZeusEditorTools pode auto-popular o `Spawns[]` do FZMMOMapDef varrendo
- *  todos APlayerStart (ou ator custom AZMMOMapSpawnPoint) presentes no
+ *  ZeusEditorTools pode auto-popular o `Spawns[]` do FZeusMapDef varrendo
+ *  todos APlayerStart (ou ator custom AZeusMapSpawnPoint) presentes no
  *  `.umap` do `ClientLevel` — botao "Sync from level".
  */
 USTRUCT(BlueprintType)
-struct ZMMO_API FZMMOMapSpawn
+struct ZMMO_API FZeusMapSpawn
 {
 	GENERATED_BODY()
 
@@ -38,7 +38,7 @@ struct ZMMO_API FZMMOMapSpawn
 };
 
 /**
- *  FZMMOMapDef
+ *  FZeusMapDef
  *
  *  Definicao canonica de um mapa do MMO. Linha da DT_Maps no cliente.
  *  Exportada para `Server/ZeusServerEngine/Config/DataTables/maps_config.json`
@@ -55,7 +55,7 @@ struct ZMMO_API FZMMOMapSpawn
  *      `mapName` (string), evitando ~10-30 bytes por handoff.
  */
 USTRUCT(BlueprintType)
-struct ZMMO_API FZMMOMapDef : public FTableRowBase
+struct ZMMO_API FZeusMapDef : public FTableRowBase
 {
 	GENERATED_BODY()
 
@@ -77,7 +77,7 @@ struct ZMMO_API FZMMOMapDef : public FTableRowBase
 	 *  Pelo menos um com Tag="default" e esperado.
 	 */
 	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Map|Spawns")
-	TArray<FZMMOMapSpawn> Spawns;
+	TArray<FZeusMapSpawn> Spawns;
 
 	/** Regras PvP/Safe/Dungeon. Reusa enum de FZoneRow. */
 	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Map")

Source/ZMMO/Game/Controller/ZeusFrontEndPlayerController.cpp

@@ -1,14 +1,14 @@
-#include "ZMMOFrontEndPlayerController.h"
+#include "ZeusFrontEndPlayerController.h"
 
 #include "UIFrontEndFlowSubsystem.h"
 #include "Engine/GameInstance.h"
 
-AZMMOFrontEndPlayerController::AZMMOFrontEndPlayerController()
+AZeusFrontEndPlayerController::AZeusFrontEndPlayerController()
 {
 	bShowMouseCursor = true;
 }
 
-void AZMMOFrontEndPlayerController::BeginPlay()
+void AZeusFrontEndPlayerController::BeginPlay()
 {
 	Super::BeginPlay();
 

Source/ZMMO/Game/Controller/ZeusFrontEndPlayerController.h

@@ -2,24 +2,24 @@
 
 #include "CoreMinimal.h"
 #include "GameFramework/PlayerController.h"
-#include "ZMMOFrontEndPlayerController.generated.h"
+#include "ZeusFrontEndPlayerController.generated.h"
 
 /**
- *  AZMMOFrontEndPlayerController
+ *  AZeusFrontEndPlayerController
  *
- *  Controller do mapa de front-end. Não herda de AZMMOPlayerController (sem
+ *  Controller do mapa de front-end. Não herda de AZeusPlayerController (sem
  *  Enhanced Input de gameplay/touch). Em BeginPlay arranca o fluxo de
  *  front-end (UUIFrontEndFlowSubsystem) — feito aqui, e não no
  *  GameInstance::Init, porque os subsistemas já existem neste ponto (ver
  *  aviso no header do ZeusNetworkSubsystem).
  */
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API AZMMOFrontEndPlayerController : public APlayerController
+class ZMMO_API AZeusFrontEndPlayerController : public APlayerController
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOFrontEndPlayerController();
+	AZeusFrontEndPlayerController();
 
 protected:
 	virtual void BeginPlay() override;

Source/ZMMO/Game/Controller/ZeusPlayerController.cpp

@@ -1,4 +1,4 @@
-#include "ZMMOPlayerController.h"
+#include "ZeusPlayerController.h"
 
 #include "Blueprint/UserWidget.h"
 #include "Components/InputComponent.h"
@@ -13,11 +13,11 @@
 #include "UI/InGame/UIInGameFlowSubsystem.h"
 #include "UI/InGameTypes.h"
 
-AZMMOPlayerController::AZMMOPlayerController()
+AZeusPlayerController::AZeusPlayerController()
 {
 	// Defaults dos Input Mapping Contexts (alinhados ao ZClientMMO). Permitem
-	// instanciar AZMMOPlayerController directamente como
-	// `PlayerControllerClass` do AZMMOGameMode sem exigir um BP filho. Se o
+	// instanciar AZeusPlayerController directamente como
+	// `PlayerControllerClass` do AZeusGameMode sem exigir um BP filho. Se o
 	// projeto adicionar mais IMCs, podemos extender via BP filho ou via
 	// arquivos de Config (UPROPERTY EditAnywhere abaixo).
 	static ConstructorHelpers::FObjectFinder<UInputMappingContext> DefaultImc(
@@ -35,7 +35,7 @@ AZMMOPlayerController::AZMMOPlayerController()
 	}
 }
 
-void AZMMOPlayerController::BeginPlay()
+void AZeusPlayerController::BeginPlay()
 {
 	Super::BeginPlay();
 
@@ -43,7 +43,7 @@ void AZMMOPlayerController::BeginPlay()
 	{
 		// Limpa estado de input herdado da UI do FrontEnd (UIManagerSubsystem
 		// e LocalPlayerSubsystem — sobrevive ao travel, e o controller anterior
-		// (AZMMOFrontEndPlayerController) tinha setado FInputModeUIOnly +
+		// (AZeusFrontEndPlayerController) tinha setado FInputModeUIOnly +
 		// bShowMouseCursor=true). Sem este reset, WASD/Look podem nao chegar
 		// ao pawn porque o Slate ainda esta com foco no widget antigo.
 		FInputModeGameOnly InputMode;
@@ -67,7 +67,7 @@ void AZMMOPlayerController::BeginPlay()
 	}
 }
 
-void AZMMOPlayerController::SetupInputComponent()
+void AZeusPlayerController::SetupInputComponent()
 {
 	Super::SetupInputComponent();
 
@@ -101,7 +101,7 @@ void AZMMOPlayerController::SetupInputComponent()
 		FInputKeyBinding& Binding = InputComponent->BindKey(
 			FInputChord(EKeys::A, /*bShift*/ false, /*bCtrl*/ false, /*bAlt*/ true, /*bCmd*/ false),
 			IE_Pressed,
-			this, &AZMMOPlayerController::ToggleStatusWindow);
+			this, &AZeusPlayerController::ToggleStatusWindow);
 		Binding.bConsumeInput = true;
 		Binding.bExecuteWhenPaused = true;  // dispara mesmo com StatusWindow aberto (CommonUI menu mode)
 
@@ -109,35 +109,35 @@ void AZMMOPlayerController::SetupInputComponent()
 		FInputKeyBinding& JobBinding = InputComponent->BindKey(
 			FInputChord(EKeys::J, /*bShift*/ false, /*bCtrl*/ false, /*bAlt*/ false, /*bCmd*/ false),
 			IE_Pressed,
-			this, &AZMMOPlayerController::ToggleJobChangePanel);
+			this, &AZeusPlayerController::ToggleJobChangePanel);
 		JobBinding.bConsumeInput = true;
 		JobBinding.bExecuteWhenPaused = true;
 	}
 }
 
-void AZMMOPlayerController::ToggleStatusWindow()
+void AZeusPlayerController::ToggleStatusWindow()
 {
 	if (UGameInstance* GI = GetGameInstance())
 	{
 		if (UUIInGameFlowSubsystem* Flow = GI->GetSubsystem<UUIInGameFlowSubsystem>())
 		{
-			Flow->ToggleScreen(EZMMOInGameUIState::StatusWindow);
+			Flow->ToggleScreen(EZeusInGameUIState::StatusWindow);
 		}
 	}
 }
 
-void AZMMOPlayerController::ToggleJobChangePanel()
+void AZeusPlayerController::ToggleJobChangePanel()
 {
 	if (UGameInstance* GI = GetGameInstance())
 	{
 		if (UUIInGameFlowSubsystem* Flow = GI->GetSubsystem<UUIInGameFlowSubsystem>())
 		{
-			Flow->ToggleScreen(EZMMOInGameUIState::JobChangePanel);
+			Flow->ToggleScreen(EZeusInGameUIState::JobChangePanel);
 		}
 	}
 }
 
-bool AZMMOPlayerController::ShouldUseTouchControls() const
+bool AZeusPlayerController::ShouldUseTouchControls() const
 {
 	return SVirtualJoystick::ShouldDisplayTouchInterface() || bForceTouchControls;
 }

Source/ZMMO/Game/Controller/ZeusPlayerController.h

@@ -2,26 +2,26 @@
 
 #include "CoreMinimal.h"
 #include "GameFramework/PlayerController.h"
-#include "ZMMOPlayerController.generated.h"
+#include "ZeusPlayerController.generated.h"
 
 class UInputMappingContext;
 class UUserWidget;
 
 /**
- *  AZMMOPlayerController
+ *  AZeusPlayerController
  *
  *  Player controller do cliente Zeus MMO. Responsavel apenas pela camada de
  *  input do Unreal (Enhanced Input Mapping Contexts e widget opcional de
  *  controlos touch). Toda a logica de identidade Zeus, envio de input e
- *  reconciliacao vive em `AZMMOPlayerCharacter`.
+ *  reconciliacao vive em `AZeusCharacter`.
  */
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API AZMMOPlayerController : public APlayerController
+class ZMMO_API AZeusPlayerController : public APlayerController
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOPlayerController();
+	AZeusPlayerController();
 
 protected:
 	/** Mapping contexts default (sempre adicionados). */

Source/ZMMO/Game/Entity/ZMMOPlayerCharacter.cpp

@@ -1,490 +0,0 @@
-#include "ZMMOPlayerCharacter.h"
-
-#include "Animation/AnimInstance.h"
-#include "Camera/CameraComponent.h"
-#include "Components/CapsuleComponent.h"
-#include "Components/SkeletalMeshComponent.h"
-#include "EnhancedInputComponent.h"
-#include "Engine/GameInstance.h"
-#include "Engine/SkeletalMesh.h"
-#include "Engine/World.h"
-#include "GameFramework/CharacterMovementComponent.h"
-#include "GameFramework/Controller.h"
-#include "GameFramework/SpringArmComponent.h"
-#include "InputAction.h"
-#include "InputActionValue.h"
-#include "GameFramework/PlayerState.h"
-#include "Subsystems/WorldSubsystem.h"
-#include "UObject/ConstructorHelpers.h"
-#include "ZMMO.h"
-#include "ZMMOAttributeComponent.h"
-#include "ZMMOPlayerState.h"
-#include "ZMMOWorldSubsystem.h"
-#include "ZeusNetworkSubsystem.h"
-#include "UI/FrontEnd/UIFrontEndFlowSubsystem.h"
-
-DEFINE_LOG_CATEGORY(LogZMMOPlayer);
-
-AZMMOPlayerCharacter::AZMMOPlayerCharacter()
-{
-	PrimaryActorTick.bCanEverTick = true;
-	PrimaryActorTick.bStartWithTickEnabled = true;
-
-	GetCapsuleComponent()->InitCapsuleSize(42.0f, 96.0f);
-
-	bUseControllerRotationPitch = false;
-	bUseControllerRotationYaw = false;
-	bUseControllerRotationRoll = false;
-
-	UCharacterMovementComponent* CMC = GetCharacterMovement();
-	CMC->bOrientRotationToMovement = true;
-	CMC->RotationRate = FRotator(0.0f, 500.0f, 0.0f);
-	CMC->JumpZVelocity = 500.0f;
-	CMC->AirControl = 0.35f;
-	CMC->MaxWalkSpeed = 500.0f;
-	CMC->MinAnalogWalkSpeed = 20.0f;
-	CMC->BrakingDecelerationWalking = 2000.0f;
-	CMC->BrakingDecelerationFalling = 1500.0f;
-
-	CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));
-	CameraBoom->SetupAttachment(RootComponent);
-	CameraBoom->TargetArmLength = 400.0f;
-	CameraBoom->bUsePawnControlRotation = true;
-
-	FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));
-	FollowCamera->SetupAttachment(CameraBoom, USpringArmComponent::SocketName);
-	FollowCamera->bUsePawnControlRotation = false;
-
-	// AttributeComponent migrou pro PlayerState (AZMMOPlayerState + Component
-	// Registry config-driven). Pawn fica leve — so' movement/input/camera.
-
-	// Defaults visuais (mesh + AnimBP) — alinhados ao ZClientMMO. Permitem ao
-	// motor spawnar AZMMOPlayerCharacter directamente como DefaultPawnClass do
-	// AZMMOGameMode sem exigir um BP filho. Um BP filho continua opcional para
-	// trocar mesh/AnimBP por mapa.
-	if (USkeletalMeshComponent* MeshComponent = GetMesh())
-	{
-		static ConstructorHelpers::FObjectFinder<USkeletalMesh> QuinnMesh(
-			TEXT("/Game/Characters/Mannequins/Meshes/SKM_Quinn_Simple.SKM_Quinn_Simple"));
-		static ConstructorHelpers::FClassFinder<UAnimInstance> QuinnAnimBp(
-			TEXT("/Game/Characters/Mannequins/Anims/Unarmed/ABP_Unarmed"));
-
-		if (QuinnMesh.Succeeded())
-		{
-			MeshComponent->SetSkeletalMesh(QuinnMesh.Object);
-			MeshComponent->SetRelativeLocation(FVector(0.0f, 0.0f, -90.0f));
-			MeshComponent->SetRelativeRotation(FRotator(0.0f, -90.0f, 0.0f));
-		}
-		else
-		{
-			UE_LOG(LogZMMOPlayer, Warning, TEXT("Default mesh SKM_Quinn_Simple not found for AZMMOPlayerCharacter."));
-		}
-
-		if (QuinnAnimBp.Succeeded())
-		{
-			MeshComponent->SetAnimationMode(EAnimationMode::AnimationBlueprint);
-			MeshComponent->SetAnimInstanceClass(QuinnAnimBp.Class);
-		}
-		else
-		{
-			UE_LOG(LogZMMOPlayer, Warning, TEXT("Default anim blueprint ABP_Unarmed not found for AZMMOPlayerCharacter."));
-		}
-	}
-
-	// Input Actions defaults (Enhanced Input) — IMCs sao adicionados pelo
-	// AZMMOPlayerController. As IAs aqui resolvem o asset por path; um BP filho
-	// pode sobrescrever caso queira inputs custom.
-	static ConstructorHelpers::FObjectFinder<UInputAction> MoveActionAsset(
-		TEXT("/Game/Input/Actions/IA_Move.IA_Move"));
-	static ConstructorHelpers::FObjectFinder<UInputAction> LookActionAsset(
-		TEXT("/Game/Input/Actions/IA_Look.IA_Look"));
-	static ConstructorHelpers::FObjectFinder<UInputAction> MouseLookActionAsset(
-		TEXT("/Game/Input/Actions/IA_MouseLook.IA_MouseLook"));
-	static ConstructorHelpers::FObjectFinder<UInputAction> JumpActionAsset(
-		TEXT("/Game/Input/Actions/IA_Jump.IA_Jump"));
-
-	if (MoveActionAsset.Succeeded()) { MoveAction = MoveActionAsset.Object; }
-	if (LookActionAsset.Succeeded()) { LookAction = LookActionAsset.Object; }
-	if (MouseLookActionAsset.Succeeded()) { MouseLookAction = MouseLookActionAsset.Object; }
-	if (JumpActionAsset.Succeeded()) { JumpAction = JumpActionAsset.Object; }
-}
-
-void AZMMOPlayerCharacter::BeginPlay()
-{
-	Super::BeginPlay();
-	ResolveZeusNetworkSubsystem();
-	BindZeusSpawnDelegate();
-	TryRegisterLocalEntityFromCachedSpawn();
-
-	// Fase 4: reposiciona o pawn na pos salva no DB (vinda no S_CHAR_SELECT_OK
-	// e memorizada no Flow). Substitui o PlayerStart default do level. Se nao
-	// ha pose pendente (primeiro boot / debug PIE direto no level), mantem o
-	// PlayerStart.
-	if (const UGameInstance* GI = GetGameInstance())
-	{
-		if (UUIFrontEndFlowSubsystem* Flow = GI->GetSubsystem<UUIFrontEndFlowSubsystem>())
-		{
-			FVector PosCm = FVector::ZeroVector;
-			float YawDeg = 0.0f;
-			if (Flow->ConsumePendingSpawnPose(PosCm, YawDeg))
-			{
-				const FRotator NewRot(0.0f, YawDeg, 0.0f);
-				SetActorLocationAndRotation(PosCm, NewRot, /*bSweep=*/false, nullptr, ETeleportType::TeleportPhysics);
-				if (AController* C = GetController())
-				{
-					C->SetControlRotation(NewRot);
-				}
-				UE_LOG(LogZMMOPlayer, Log,
-					TEXT("AZMMOPlayerCharacter: pawn reposicionado pra pos do DB (%s) yaw=%.1f"),
-					*PosCm.ToString(), YawDeg);
-			}
-		}
-	}
-}
-
-void AZMMOPlayerCharacter::EndPlay(const EEndPlayReason::Type EndPlayReason)
-{
-	UnbindZeusSpawnDelegate();
-	ZeusNetwork = nullptr;
-	Super::EndPlay(EndPlayReason);
-}
-
-void AZMMOPlayerCharacter::Tick(const float DeltaSeconds)
-{
-	Super::Tick(DeltaSeconds);
-	FlushInputAxisToServer(DeltaSeconds);
-}
-
-void AZMMOPlayerCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
-{
-	if (UEnhancedInputComponent* EnhancedInputComponent = Cast<UEnhancedInputComponent>(PlayerInputComponent))
-	{
-		EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Started, this, &AZMMOPlayerCharacter::OnJumpPressed);
-		EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Completed, this, &AZMMOPlayerCharacter::OnJumpReleased);
-
-		EnhancedInputComponent->BindAction(MoveAction, ETriggerEvent::Triggered, this, &AZMMOPlayerCharacter::Move);
-		EnhancedInputComponent->BindAction(MoveAction, ETriggerEvent::Completed, this, &AZMMOPlayerCharacter::MoveCompleted);
-
-		EnhancedInputComponent->BindAction(LookAction, ETriggerEvent::Triggered, this, &AZMMOPlayerCharacter::Look);
-		EnhancedInputComponent->BindAction(MouseLookAction, ETriggerEvent::Triggered, this, &AZMMOPlayerCharacter::Look);
-	}
-	else
-	{
-		UE_LOG(LogZMMOPlayer, Error, TEXT("'%s' Failed to find an Enhanced Input component."), *GetNameSafe(this));
-	}
-}
-
-void AZMMOPlayerCharacter::Move(const FInputActionValue& Value)
-{
-	const FVector2D MovementVector = Value.Get<FVector2D>();
-	DoMove(MovementVector.X, MovementVector.Y);
-}
-
-void AZMMOPlayerCharacter::MoveCompleted(const FInputActionValue& Value)
-{
-	(void)Value;
-	DoMove(0.0f, 0.0f);
-}
-
-void AZMMOPlayerCharacter::Look(const FInputActionValue& Value)
-{
-	const FVector2D LookAxisVector = Value.Get<FVector2D>();
-	DoLook(LookAxisVector.X, LookAxisVector.Y);
-}
-
-void AZMMOPlayerCharacter::OnJumpPressed()
-{
-	bPendingJumpPressed = true;
-	DoJumpStart();
-}
-
-void AZMMOPlayerCharacter::OnJumpReleased()
-{
-	bPendingJumpReleased = true;
-	DoJumpEnd();
-}
-
-void AZMMOPlayerCharacter::DoMove(const float Right, const float Forward)
-{
-	PendingMoveRight = FMath::Clamp(Right, -1.0f, 1.0f);
-	PendingMoveForward = FMath::Clamp(Forward, -1.0f, 1.0f);
-
-	if (GetController() != nullptr)
-	{
-		const FRotator Rotation = GetController()->GetControlRotation();
-		const FRotator YawRotation(0.0f, Rotation.Yaw, 0.0f);
-		const FVector ForwardDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
-		const FVector RightDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);
-		AddMovementInput(ForwardDirection, Forward);
-		AddMovementInput(RightDirection, Right);
-	}
-}
-
-void AZMMOPlayerCharacter::DoLook(const float Yaw, const float Pitch)
-{
-	if (GetController() != nullptr)
-	{
-		AddControllerYawInput(Yaw);
-		AddControllerPitchInput(Pitch);
-	}
-}
-
-void AZMMOPlayerCharacter::DoJumpStart()
-{
-	Jump();
-}
-
-void AZMMOPlayerCharacter::DoJumpEnd()
-{
-	StopJumping();
-}
-
-void AZMMOPlayerCharacter::ApplyEntitySnapshot(const FZMMOEntitySnapshot& /*Snapshot*/)
-{
-	// Cliente local solto: o servidor nao reconcilia posicao em V0 (ADR 0038).
-	// Quando colisao de objetos chegar, podemos ligar uma reconciliacao opcional
-	// horizontal aqui (XY only), preservando o Z do CMC local.
-}
-
-void AZMMOPlayerCharacter::SetEntityRelevant(bool /*bRelevant*/)
-{
-	// Nunca despawnamos o jogador local via AOI.
-}
-
-void AZMMOPlayerCharacter::ResolveZeusNetworkSubsystem()
-{
-	if (ZeusNetwork)
-	{
-		return;
-	}
-
-	UGameInstance* GI = GetGameInstance();
-	if (!GI)
-	{
-		return;
-	}
-
-	ZeusNetwork = GI->GetSubsystem<UZeusNetworkSubsystem>();
-}
-
-void AZMMOPlayerCharacter::BindZeusSpawnDelegate()
-{
-	if (bSpawnDelegateBound || !IsLocallyControlled())
-	{
-		return;
-	}
-	if (!ZeusNetwork)
-	{
-		return;
-	}
-
-	ZeusNetwork->OnPlayerSpawned.AddDynamic(this, &AZMMOPlayerCharacter::HandleZeusPlayerSpawned);
-	ZeusNetwork->OnCharInfoReceived.AddDynamic(this, &AZMMOPlayerCharacter::HandleZeusCharInfo);
-	bSpawnDelegateBound = true;
-}
-
-void AZMMOPlayerCharacter::UnbindZeusSpawnDelegate()
-{
-	if (!bSpawnDelegateBound || !ZeusNetwork)
-	{
-		bSpawnDelegateBound = false;
-		return;
-	}
-	ZeusNetwork->OnPlayerSpawned.RemoveDynamic(this, &AZMMOPlayerCharacter::HandleZeusPlayerSpawned);
-	ZeusNetwork->OnCharInfoReceived.RemoveDynamic(this, &AZMMOPlayerCharacter::HandleZeusCharInfo);
-	bSpawnDelegateBound = false;
-}
-
-void AZMMOPlayerCharacter::TryRegisterLocalEntityFromCachedSpawn()
-{
-	if (!ZeusNetwork)
-	{
-		return;
-	}
-
-	int64 CachedEntityId = 0;
-	FVector CachedPosCm = FVector::ZeroVector;
-	float CachedYawDeg = 0.0f;
-	int64 CachedServerTimeMs = 0;
-	if (ZeusNetwork->TryGetLastLocalSpawn(CachedEntityId, CachedPosCm, CachedYawDeg, CachedServerTimeMs))
-	{
-		HandleLocalSpawnReady(CachedEntityId, CachedPosCm, CachedYawDeg, CachedServerTimeMs);
-	}
-
-	// Race fix: o S_CHAR_INFO chega ANTES de S_SPAWN_PLAYER mas o pawn pode
-	// nao existir ainda (OpenLevel em andamento). Aplica o ultimo cacheado.
-	TryApplyCachedCharInfo();
-}
-
-void AZMMOPlayerCharacter::HandleZeusPlayerSpawned(const int64 InEntityId, const bool bIsLocal,
-	const FVector PosCm, const float YawDeg, const int64 ServerTimeMs)
-{
-	if (!bIsLocal)
-	{
-		// Remote spawns sao tratados pelo `UZMMOWorldSubsystem`; aqui so reagimos
-		// ao spawn do pawn possessivel local (S_SPAWN_PLAYER com bIsLocal=true).
-		return;
-	}
-	HandleLocalSpawnReady(InEntityId, PosCm, YawDeg, ServerTimeMs);
-}
-
-void AZMMOPlayerCharacter::HandleLocalSpawnReady(const int64 InEntityId, const FVector PosCm,
-	const float YawDeg, const int64 ServerTimeMs)
-{
-	if (InEntityId == 0)
-	{
-		return;
-	}
-
-	// PR-HANDOFF-007 — InEntityId é int64 (era int32)
-	if (ZMMOEntityId == InEntityId)
-	{
-		return;
-	}
-
-	ZMMOEntityId = InEntityId;
-
-	UE_LOG(LogZMMOPlayer, Log,
-		TEXT("AZMMOPlayerCharacter: local spawn captured EntityId=%lld pos=(%s) yaw=%.1f t=%lld"),
-		InEntityId, *PosCm.ToString(), YawDeg, ServerTimeMs);
-
-	if (UWorld* World = GetWorld())
-	{
-		if (UZMMOWorldSubsystem* WorldSubsystem = World->GetSubsystem<UZMMOWorldSubsystem>())
-		{
-			WorldSubsystem->RegisterLocalEntity(InEntityId, this);
-		}
-	}
-
-	// Identidade publica (EntityId) + seed no AttributeComponent. CharName/Guild
-	// vem separado via S_CHAR_INFO -> HandleZeusCharInfo. AttributeComponent vive
-	// como subobject e recebe seed pra que o ZMMOAttributeNetworkHandler consiga
-	// rotear o snapshot por EntityId desde o primeiro pacote.
-	if (APlayerState* PS = GetPlayerState())
-	{
-		if (AZMMOPlayerState* ZMMOPs = Cast<AZMMOPlayerState>(PS))
-		{
-			ZMMOPs->SetPublicIdentity(InEntityId, /*CharId*/ FString(),
-				/*BaseLevel*/ 1, /*ClassId*/ 0);
-		}
-		if (UZMMOAttributeComponent* AttrComp = PS->FindComponentByClass<UZMMOAttributeComponent>())
-		{
-			AttrComp->SeedEntityId(InEntityId);
-		}
-	}
-
-	// Aplica char info cacheada (caso S_CHAR_INFO tenha chegado antes do PS existir).
-	TryApplyCachedCharInfo();
-
-	// UI in-game e' responsabilidade do AZMMOHUD (GameMode.HUDClass), nao do
-	// Pawn. AHUD::BeginPlay chama UUIInGameFlowSubsystem::StartInGame, que
-	// pushea WBP_HUD em UI.Layer.Game. UZMMOHudWidget::NativeOnActivated auto-binda
-	// no UZMMOAttributeComponent via PlayerState.
-}
-
-void AZMMOPlayerCharacter::HandleZeusCharInfo(const int64 InEntityId, const FString& CharName, const FString& GuildName)
-{
-	UE_LOG(LogZMMOPlayer, Log,
-		TEXT("AZMMOPlayerCharacter: S_CHAR_INFO recebido EntityId=%lld name=%s guild=%s"),
-		InEntityId, *CharName, *GuildName);
-
-	APlayerState* PS = GetPlayerState();
-	if (!PS)
-	{
-		// Race fix: pawn pode nao ter PlayerState ainda. Subsystem ja cacheou
-		// (LastLocalCharInfoCache); TryApplyCachedCharInfo aplica em
-		// HandleLocalSpawnReady ou em outra oportunidade.
-		return;
-	}
-	if (AZMMOPlayerState* ZMMOPs = Cast<AZMMOPlayerState>(PS))
-	{
-		ZMMOPs->SetCharInfo(CharName, GuildName);
-	}
-}
-
-void AZMMOPlayerCharacter::TryApplyCachedCharInfo()
-{
-	if (!ZeusNetwork)
-	{
-		return;
-	}
-	int64 CachedEntityId = 0;
-	FString CachedCharName;
-	FString CachedGuildName;
-	if (!ZeusNetwork->TryGetLastLocalCharInfo(CachedEntityId, CachedCharName, CachedGuildName))
-	{
-		return;
-	}
-	if (APlayerState* PS = GetPlayerState())
-	{
-		if (AZMMOPlayerState* ZMMOPs = Cast<AZMMOPlayerState>(PS))
-		{
-			ZMMOPs->SetCharInfo(CachedCharName, CachedGuildName);
-		}
-	}
-}
-
-void AZMMOPlayerCharacter::FlushInputAxisToServer(const float DeltaSeconds)
-{
-	ResolveZeusNetworkSubsystem();
-	if (!ZeusNetwork || !ZeusNetwork->IsConnected())
-	{
-		return;
-	}
-
-	const float SendInterval = 1.0f / FMath::Max(1, InputSendRateHz);
-	SendAccumulatorSec += DeltaSeconds;
-	TimeSinceLastSendSec += DeltaSeconds;
-
-	const bool bMovingInput = !FMath::IsNearlyZero(PendingMoveForward) || !FMath::IsNearlyZero(PendingMoveRight);
-	const bool bJumpEvent = bPendingJumpPressed || bPendingJumpReleased;
-	const bool bRateReached = SendAccumulatorSec >= SendInterval;
-	const bool bHeartbeatReached = TimeSinceLastSendSec >= HeartbeatIntervalSec;
-
-	// IsFalling é estado contínuo do CMC (espelhado em PlayerStatePayload::grounded
-	// para alimentar o MovementMode dos proxies). Forçar envio em transições
-	// walking↔falling garante que a animação de queda/pulo dispare nos outros
-	// clientes mesmo quando estamos em rate limit / sem input de movimento.
-	const UCharacterMovementComponent* CMCForFalling = GetCharacterMovement();
-	const bool bIsFalling = CMCForFalling != nullptr && CMCForFalling->IsFalling();
-	const bool bFallingChanged = (bIsFalling != bPreviousFalling);
-
-	const bool bShouldSend = bJumpEvent || bFallingChanged || (bMovingInput && bRateReached) || (!bMovingInput && bHeartbeatReached);
-	if (!bShouldSend)
-	{
-		return;
-	}
-
-	++InputSequence;
-	const int32 ClientTimeMs = static_cast<int32>(FPlatformTime::Seconds() * 1000.0);
-	// ADR 0040: yaw da camara/controller para que o servidor consiga rotar o
-	// input (referencial-camara) para velocidade mundial. Fallback para o yaw
-	// do actor se nao houver controller (e.g. tela de loading).
-	const float ViewYawDeg = (GetController()
-		? static_cast<float>(GetController()->GetControlRotation().Yaw)
-		: static_cast<float>(GetActorRotation().Yaw));
-	// ADR 0041: cliente autoritativo da posicao XYZ + velocidade XY. O CMC ja
-	// integrou o input local antes deste flush, portanto `GetActorLocation` e
-	// `GetVelocity` reflectem o estado real que o servidor deve replicar para
-	// os outros clientes (sujeito ao clamp anti-cheat).
-	const FVector PosCm = GetActorLocation();
-	const FVector Vel = GetVelocity();
-	ZeusNetwork->SendInputAxis(
-		PendingMoveForward,
-		PendingMoveRight,
-		bPendingJumpPressed,
-		bPendingJumpReleased,
-		InputSequence,
-		ClientTimeMs,
-		ViewYawDeg,
-		PosCm,
-		FVector2D(Vel.X, Vel.Y),
-		bIsFalling,
-		static_cast<float>(Vel.Z));
-
-	SendAccumulatorSec = 0.0f;
-	TimeSinceLastSendSec = 0.0f;
-	bPendingJumpPressed = false;
-	bPendingJumpReleased = false;
-	bPreviousFalling = bIsFalling;
-}

Source/ZMMO/Game/Entity/ZMMOProxyMovementComponent.h

@@ -1,25 +0,0 @@
-#pragma once
-
-#include "CoreMinimal.h"
-#include "GameFramework/CharacterMovementComponent.h"
-
-#include "ZMMOProxyMovementComponent.generated.h"
-
-/**
- * CMC customizado para AZMMOPlayerProxy. Expõe escrita direta de Acceleration
- * (protected na base) para que o AnimBP veja Acceleration!=0 quando o proxy
- * recebe snapshots, alimentando a fórmula ShouldMove e a transição Jump_Start
- * do ABP_Unarmed (ambas dependem de aceleração não-nula). Espelha
- * UZeusProxyMovementComponent do ZClientMMO.
- */
-UCLASS(ClassGroup = (ZMMO), meta = (BlueprintSpawnableComponent))
-class ZMMO_API UZMMOProxyMovementComponent : public UCharacterMovementComponent
-{
-	GENERATED_BODY()
-
-public:
-	void SetZMMOExternalAcceleration(const FVector& InAccelerationCmS2)
-	{
-		Acceleration = InAccelerationCmS2;
-	}
-};

Source/ZMMO/Game/Entity/ZeusCharacter.cpp

@@ -0,0 +1,711 @@
+#include "ZeusCharacter.h"
+
+#include "Animation/AnimInstance.h"
+#include "Camera/CameraComponent.h"
+#include "Components/CapsuleComponent.h"
+#include "Components/SkeletalMeshComponent.h"
+#include "EnhancedInputComponent.h"
+#include "Engine/GameInstance.h"
+#include "Engine/SkeletalMesh.h"
+#include "Engine/World.h"
+#include "GameFramework/CharacterMovementComponent.h"
+#include "GameFramework/Controller.h"
+#include "GameFramework/SpringArmComponent.h"
+#include "InputAction.h"
+#include "InputActionValue.h"
+#include "GameFramework/PlayerState.h"
+#include "Subsystems/WorldSubsystem.h"
+#include "UObject/ConstructorHelpers.h"
+#include "ZMMO.h"
+#include "GameplayTagContainer.h"
+#include "GameplayTagsManager.h"
+#include "ZeusGASComponent.h"
+#include "ZeusAOIComponent.h"
+#include "ZeusPlayerState.h"
+#include "Blueprint/UserWidget.h"
+#include "GameFramework/PlayerController.h"
+#include "ZeusWorldSubsystem.h"
+#include "ZeusNetworkSubsystem.h"
+#include "ZeusNetworkingClientSubsystem.h"
+#include "UI/FrontEnd/UIFrontEndFlowSubsystem.h"
+
+DEFINE_LOG_CATEGORY(LogZeusPlayer);
+
+AZeusCharacter::AZeusCharacter()
+{
+	PrimaryActorTick.bCanEverTick = true;
+	PrimaryActorTick.bStartWithTickEnabled = true;
+
+	GetCapsuleComponent()->InitCapsuleSize(42.0f, 96.0f);
+
+	bUseControllerRotationPitch = false;
+	bUseControllerRotationYaw = false;
+	bUseControllerRotationRoll = false;
+
+	UCharacterMovementComponent* CMC = GetCharacterMovement();
+	CMC->bOrientRotationToMovement = true;
+	CMC->RotationRate = FRotator(0.0f, 500.0f, 0.0f);
+	CMC->JumpZVelocity = 500.0f;
+	CMC->AirControl = 0.35f;
+	CMC->MaxWalkSpeed = 500.0f;
+	CMC->MinAnalogWalkSpeed = 20.0f;
+	CMC->BrakingDecelerationWalking = 2000.0f;
+	CMC->BrakingDecelerationFalling = 1500.0f;
+
+	CameraBoom = CreateDefaultSubobject<USpringArmComponent>(TEXT("CameraBoom"));
+	CameraBoom->SetupAttachment(RootComponent);
+	CameraBoom->TargetArmLength = 400.0f;
+	CameraBoom->bUsePawnControlRotation = true;
+
+	FollowCamera = CreateDefaultSubobject<UCameraComponent>(TEXT("FollowCamera"));
+	FollowCamera->SetupAttachment(CameraBoom, USpringArmComponent::SocketName);
+	FollowCamera->bUsePawnControlRotation = false;
+
+	// AOI do cliente (+ overlays de debug). Implementa IZeusAOIDebugTarget; o
+	// Zeus Admin Tools acha este componente no pawn e dirige os overlays.
+	AOIComponent = CreateDefaultSubobject<UZeusAOIComponent>(TEXT("ZeusAOIComponent"));
+
+	// AdminPanelClass NAO e' resolvido aqui via FClassFinder: na criacao do CDO
+	// (load do modulo) o asset registry pode nao estar pronto e o static cacheia
+	// null pra sempre. Resolvido lazy em ToggleAdminPanel (LoadClass em runtime).
+
+	// AttributeComponent migrou pro PlayerState (AZeusPlayerState + Component
+	// Registry config-driven). Pawn fica leve — so' movement/input/camera.
+
+	// Defaults visuais (mesh + AnimBP). Permitem ao motor spawnar AZeusCharacter
+	// directamente como DefaultPawnClass do AZeusGameMode sem exigir um BP filho.
+	// Um BP filho continua opcional para trocar mesh/AnimBP por mapa.
+	if (USkeletalMeshComponent* MeshComponent = GetMesh())
+	{
+		static ConstructorHelpers::FObjectFinder<USkeletalMesh> QuinnMesh(
+			TEXT("/Game/Characters/Mannequins/Meshes/SKM_Quinn_Simple.SKM_Quinn_Simple"));
+		static ConstructorHelpers::FClassFinder<UAnimInstance> QuinnAnimBp(
+			TEXT("/Game/Characters/Mannequins/Anims/Unarmed/ABP_Unarmed"));
+
+		if (QuinnMesh.Succeeded())
+		{
+			MeshComponent->SetSkeletalMesh(QuinnMesh.Object);
+			MeshComponent->SetRelativeLocation(FVector(0.0f, 0.0f, -90.0f));
+			MeshComponent->SetRelativeRotation(FRotator(0.0f, -90.0f, 0.0f));
+		}
+		else
+		{
+			UE_LOG(LogZeusPlayer, Warning, TEXT("Default mesh SKM_Quinn_Simple not found for AZeusCharacter."));
+		}
+
+		if (QuinnAnimBp.Succeeded())
+		{
+			MeshComponent->SetAnimationMode(EAnimationMode::AnimationBlueprint);
+			MeshComponent->SetAnimInstanceClass(QuinnAnimBp.Class);
+		}
+		else
+		{
+			UE_LOG(LogZeusPlayer, Warning, TEXT("Default anim blueprint ABP_Unarmed not found for AZeusCharacter."));
+		}
+	}
+
+	// Input Actions defaults (Enhanced Input) — IMCs sao adicionados pelo
+	// AZeusPlayerController. As IAs aqui resolvem o asset por path; um BP filho
+	// pode sobrescrever caso queira inputs custom.
+	static ConstructorHelpers::FObjectFinder<UInputAction> MoveActionAsset(
+		TEXT("/Game/Input/Actions/IA_Move.IA_Move"));
+	static ConstructorHelpers::FObjectFinder<UInputAction> LookActionAsset(
+		TEXT("/Game/Input/Actions/IA_Look.IA_Look"));
+	static ConstructorHelpers::FObjectFinder<UInputAction> MouseLookActionAsset(
+		TEXT("/Game/Input/Actions/IA_MouseLook.IA_MouseLook"));
+	static ConstructorHelpers::FObjectFinder<UInputAction> JumpActionAsset(
+		TEXT("/Game/Input/Actions/IA_Jump.IA_Jump"));
+	static ConstructorHelpers::FObjectFinder<UInputAction> DashActionAsset(
+		TEXT("/Game/Input/Actions/IA_Dash.IA_Dash"));
+
+	if (MoveActionAsset.Succeeded()) { MoveAction = MoveActionAsset.Object; }
+	if (LookActionAsset.Succeeded()) { LookAction = LookActionAsset.Object; }
+	if (MouseLookActionAsset.Succeeded()) { MouseLookAction = MouseLookActionAsset.Object; }
+	if (JumpActionAsset.Succeeded()) { JumpAction = JumpActionAsset.Object; }
+	if (DashActionAsset.Succeeded()) { DashAction = DashActionAsset.Object; }
+}
+
+void AZeusCharacter::BeginPlay()
+{
+	Super::BeginPlay();
+	ResolveZeusNetworkSubsystem();
+	BindZeusSpawnDelegate();
+	TryRegisterLocalEntityFromCachedSpawn();
+
+	// Fase 4: reposiciona o pawn na pos salva no DB (vinda no S_CHAR_SELECT_OK
+	// e memorizada no Flow). Substitui o PlayerStart default do level. Se nao
+	// ha pose pendente (primeiro boot / debug PIE direto no level), mantem o
+	// PlayerStart.
+	if (const UGameInstance* GI = GetGameInstance())
+	{
+		if (UUIFrontEndFlowSubsystem* Flow = GI->GetSubsystem<UUIFrontEndFlowSubsystem>())
+		{
+			FVector PosCm = FVector::ZeroVector;
+			float YawDeg = 0.0f;
+			if (Flow->ConsumePendingSpawnPose(PosCm, YawDeg))
+			{
+				const FRotator NewRot(0.0f, YawDeg, 0.0f);
+				SetActorLocationAndRotation(PosCm, NewRot, /*bSweep=*/false, nullptr, ETeleportType::TeleportPhysics);
+				if (AController* C = GetController())
+				{
+					C->SetControlRotation(NewRot);
+				}
+				UE_LOG(LogZeusPlayer, Log,
+					TEXT("AZeusCharacter: pawn reposicionado pra pos do DB (%s) yaw=%.1f"),
+					*PosCm.ToString(), YawDeg);
+			}
+		}
+	}
+}
+
+void AZeusCharacter::EndPlay(const EEndPlayReason::Type EndPlayReason)
+{
+	UnbindZeusSpawnDelegate();
+	ZeusNetwork = nullptr;
+	Super::EndPlay(EndPlayReason);
+}
+
+void AZeusCharacter::Tick(const float DeltaSeconds)
+{
+	Super::Tick(DeltaSeconds);
+	FlushInputAxisToServer(DeltaSeconds);
+}
+
+void AZeusCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
+{
+	if (UEnhancedInputComponent* EnhancedInputComponent = Cast<UEnhancedInputComponent>(PlayerInputComponent))
+	{
+		EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Started, this, &AZeusCharacter::OnJumpPressed);
+		EnhancedInputComponent->BindAction(JumpAction, ETriggerEvent::Completed, this, &AZeusCharacter::OnJumpReleased);
+
+		EnhancedInputComponent->BindAction(MoveAction, ETriggerEvent::Triggered, this, &AZeusCharacter::Move);
+		EnhancedInputComponent->BindAction(MoveAction, ETriggerEvent::Completed, this, &AZeusCharacter::MoveCompleted);
+
+		EnhancedInputComponent->BindAction(LookAction, ETriggerEvent::Triggered, this, &AZeusCharacter::Look);
+		EnhancedInputComponent->BindAction(MouseLookAction, ETriggerEvent::Triggered, this, &AZeusCharacter::Look);
+
+		if (DashAction)
+		{
+			EnhancedInputComponent->BindAction(DashAction, ETriggerEvent::Triggered, this, &AZeusCharacter::OnDashTriggered);
+		}
+	}
+	else
+	{
+		UE_LOG(LogZeusPlayer, Error, TEXT("'%s' Failed to find an Enhanced Input component."), *GetNameSafe(this));
+	}
+
+	// Debug: F8 abre/fecha o Zeus Admin Tools (AIO Debug). Legacy BindKey
+	// convive com Enhanced Input. Trocar a tecla aqui se conflitar.
+	PlayerInputComponent->BindKey(EKeys::F8, IE_Pressed, this, &AZeusCharacter::ToggleAdminPanel);
+}
+
+void AZeusCharacter::ToggleAdminPanel()
+{
+	APlayerController* PC = Cast<APlayerController>(GetController());
+	if (!PC)
+	{
+		return;
+	}
+
+	// Aberto -> fecha + devolve input pro jogo.
+	if (AdminPanelInstance && AdminPanelInstance->IsInViewport())
+	{
+		AdminPanelInstance->RemoveFromParent();
+		PC->SetInputMode(FInputModeGameOnly());
+		PC->bShowMouseCursor = false;
+		return;
+	}
+
+	// Lazy load (runtime): no F8 o asset ja' esta carregavel; evita o pitfall do
+	// FClassFinder na criacao do CDO. Path do generated class (_C).
+	// A UI vive no CONTENT DO PLUGIN (mount /ZeusAdminTools/), nao no /Game do projeto:
+	// o plugin ZeusAdminTools e' autocontido (C++ + UI no repo Server).
+	if (!AdminPanelClass)
+	{
+		AdminPanelClass = LoadClass<UUserWidget>(nullptr,
+			TEXT("/ZeusAdminTools/UI/WBP_AdminToolsAIO.WBP_AdminToolsAIO_C"));
+	}
+	if (!AdminPanelClass)
+	{
+		UE_LOG(LogZeusPlayer, Warning, TEXT("[AdminPanel] AdminPanelClass nao resolvido (WBP_AdminToolsAIO ausente?)."));
+		return;
+	}
+
+	if (!AdminPanelInstance)
+	{
+		AdminPanelInstance = CreateWidget<UUserWidget>(PC, AdminPanelClass);
+	}
+	if (AdminPanelInstance)
+	{
+		AdminPanelInstance->AddToViewport(1000);
+
+		// UIOnly: trava a acao do jogo enquanto o menu esta aberto e garante que
+		// os cliques vao 100% pra UI (no GameAndUI o viewport rouba o clique).
+		// O mundo continua renderizando + os overlays de debug seguem desenhando.
+		FInputModeUIOnly Mode;
+		Mode.SetWidgetToFocus(AdminPanelInstance->TakeWidget());
+		Mode.SetLockMouseToViewportBehavior(EMouseLockMode::DoNotLock);
+		PC->SetInputMode(Mode);
+		PC->bShowMouseCursor = true;
+	}
+}
+
+void AZeusCharacter::Move(const FInputActionValue& Value)
+{
+	const FVector2D MovementVector = Value.Get<FVector2D>();
+	DoMove(MovementVector.X, MovementVector.Y);
+}
+
+void AZeusCharacter::MoveCompleted(const FInputActionValue& Value)
+{
+	(void)Value;
+	DoMove(0.0f, 0.0f);
+}
+
+void AZeusCharacter::Look(const FInputActionValue& Value)
+{
+	const FVector2D LookAxisVector = Value.Get<FVector2D>();
+	DoLook(LookAxisVector.X, LookAxisVector.Y);
+}
+
+void AZeusCharacter::OnJumpPressed()
+{
+	bPendingJumpPressed = true;
+	DoJumpStart();
+}
+
+void AZeusCharacter::OnJumpReleased()
+{
+	bPendingJumpReleased = true;
+	DoJumpEnd();
+}
+
+void AZeusCharacter::OnDashTriggered()
+{
+	// Resolve UZeusGASComponent do PlayerState. Component vive la' via
+	// AZeusPlayerState Component Registry (config-driven). Sem el, ASC ausente
+	// e RequestActivateAbilityByTag falha — log warning.
+	const APlayerState* PS = GetPlayerState();
+	if (!PS)
+	{
+		UE_LOG(LogZeusPlayer, Warning, TEXT("OnDashTriggered: PlayerState nullptr — ignorado"));
+		return;
+	}
+	UZeusGASComponent* Comp = PS->FindComponentByClass<UZeusGASComponent>();
+	if (!Comp)
+	{
+		UE_LOG(LogZeusPlayer, Warning, TEXT("OnDashTriggered: UZeusGASComponent nao achado"));
+		return;
+	}
+
+	// Tag canonica casa com row do DT + JSON do server. Hash FNV calculado
+	// dentro do componente (RequestActivateAbilityByTag).
+	const FGameplayTag DashTag = UGameplayTagsManager::Get().RequestGameplayTag(
+		FName(TEXT("Zeus.Ability.Movement.Dash")));
+	if (!DashTag.IsValid())
+	{
+		UE_LOG(LogZeusPlayer, Warning,
+			TEXT("OnDashTriggered: tag Zeus.Ability.Movement.Dash nao registrada no cliente"));
+		return;
+	}
+
+	const bool bSent = Comp->RequestActivateAbilityByTag(DashTag);
+	UE_LOG(LogZeusPlayer, Log, TEXT("OnDashTriggered -> RequestActivateAbilityByTag = %s"),
+		bSent ? TEXT("OK (C_ABILITY_TRY_ACTIVATE enviado)") : TEXT("FALHOU"));
+}
+
+void AZeusCharacter::DoMove(const float Right, const float Forward)
+{
+	PendingMoveRight = FMath::Clamp(Right, -1.0f, 1.0f);
+	PendingMoveForward = FMath::Clamp(Forward, -1.0f, 1.0f);
+
+	if (GetController() != nullptr)
+	{
+		const FRotator Rotation = GetController()->GetControlRotation();
+		const FRotator YawRotation(0.0f, Rotation.Yaw, 0.0f);
+		const FVector ForwardDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::X);
+		const FVector RightDirection = FRotationMatrix(YawRotation).GetUnitAxis(EAxis::Y);
+		AddMovementInput(ForwardDirection, Forward);
+		AddMovementInput(RightDirection, Right);
+	}
+}
+
+void AZeusCharacter::DoLook(const float Yaw, const float Pitch)
+{
+	if (GetController() != nullptr)
+	{
+		AddControllerYawInput(Yaw);
+		AddControllerPitchInput(Pitch);
+	}
+}
+
+void AZeusCharacter::DoJumpStart()
+{
+	Jump();
+}
+
+void AZeusCharacter::DoJumpEnd()
+{
+	StopJumping();
+}
+
+void AZeusCharacter::ApplyEntitySnapshot(const FZeusEntitySnapshot& /*Snapshot*/)
+{
+	// Cliente local solto: o servidor nao reconcilia posicao em V0 (ADR 0038).
+	// Quando colisao de objetos chegar, podemos ligar uma reconciliacao opcional
+	// horizontal aqui (XY only), preservando o Z do CMC local.
+}
+
+void AZeusCharacter::SetEntityRelevant(bool /*bRelevant*/)
+{
+	// Nunca despawnamos o jogador local via AOI.
+}
+
+void AZeusCharacter::ResolveZeusNetworkSubsystem()
+{
+	if (ZeusNetwork && NetClient)
+	{
+		return;
+	}
+
+	UGameInstance* GI = GetGameInstance();
+	if (!GI)
+	{
+		return;
+	}
+
+	if (!ZeusNetwork)
+	{
+		ZeusNetwork = GI->GetSubsystem<UZeusNetworkSubsystem>();
+	}
+	if (!NetClient)
+	{
+		NetClient = GI->GetSubsystem<UZeusNetworkingClientSubsystem>();
+	}
+}
+
+void AZeusCharacter::BindZeusSpawnDelegate()
+{
+	if (bSpawnDelegateBound || !IsLocallyControlled())
+	{
+		return;
+	}
+	if (!NetClient && !ZeusNetwork)
+	{
+		return;
+	}
+
+	// Self-entity (entityId do proprio char) vem do sistema de rede novo.
+	if (NetClient)
+	{
+		NetClient->OnSelfEntityAssigned.AddDynamic(this, &AZeusCharacter::HandleSelfEntityAssigned);
+	}
+	// CHAR_INFO (nome/guild) ainda nao tem equivalente no sistema novo -> legacy.
+	if (ZeusNetwork)
+	{
+		ZeusNetwork->OnCharInfoReceived.AddDynamic(this, &AZeusCharacter::HandleZeusCharInfo);
+	}
+	bSpawnDelegateBound = true;
+}
+
+void AZeusCharacter::UnbindZeusSpawnDelegate()
+{
+	if (!bSpawnDelegateBound)
+	{
+		return;
+	}
+	if (NetClient)
+	{
+		NetClient->OnSelfEntityAssigned.RemoveDynamic(this, &AZeusCharacter::HandleSelfEntityAssigned);
+	}
+	if (ZeusNetwork)
+	{
+		ZeusNetwork->OnCharInfoReceived.RemoveDynamic(this, &AZeusCharacter::HandleZeusCharInfo);
+	}
+	bSpawnDelegateBound = false;
+}
+
+void AZeusCharacter::TryRegisterLocalEntityFromCachedSpawn()
+{
+	// Self-entity vem do sistema de rede novo (ENT_SELF). O subsystem e'
+	// per-GameInstance e sobrevive ao OpenLevel, entao o entityId pode ja' ter
+	// chegado antes deste pawn existir -- puxa o cache agora. Caso ainda nao
+	// tenha chegado, o bind em OnSelfEntityAssigned cobre quando chegar.
+	// A pos/yaw vem do proprio pawn (ja posicionado via PendingSpawnPose do DB);
+	// o sistema novo so' carrega o entityId.
+	if (NetClient)
+	{
+		const int64 SelfId = NetClient->GetLocalEntityId();
+		if (SelfId != 0)
+		{
+			HandleLocalSpawnReady(SelfId, GetActorLocation(), GetActorRotation().Yaw, 0);
+		}
+	}
+
+	// Race fix CHAR_INFO (ainda legacy): o S_CHAR_INFO pode ter chegado antes do
+	// pawn existir; aplica o ultimo nome/guild cacheado.
+	TryApplyCachedCharInfo();
+}
+
+void AZeusCharacter::HandleSelfEntityAssigned(const int64 InEntityId)
+{
+	// Sistema novo informou o entityId do proprio char (ENT_SELF). Reusa o mesmo
+	// caminho do spawn local legacy (seta ZeusEntityId + RegisterLocalEntity).
+	// pos/yaw vem do pawn (ja posicionado); o sistema novo so' traz o entityId.
+	HandleLocalSpawnReady(InEntityId, GetActorLocation(), GetActorRotation().Yaw, 0);
+}
+
+void AZeusCharacter::HandleZeusPlayerSpawned(const int64 InEntityId, const bool bIsLocal,
+	const FVector PosCm, const float YawDeg, const int64 ServerTimeMs)
+{
+	if (!bIsLocal)
+	{
+		// Remote spawns sao tratados pelo `UZeusWorldSubsystem`; aqui so reagimos
+		// ao spawn do pawn possessivel local (S_SPAWN_PLAYER com bIsLocal=true).
+		return;
+	}
+	HandleLocalSpawnReady(InEntityId, PosCm, YawDeg, ServerTimeMs);
+}
+
+void AZeusCharacter::HandleLocalSpawnReady(const int64 InEntityId, const FVector PosCm,
+	const float YawDeg, const int64 ServerTimeMs)
+{
+	if (InEntityId == 0)
+	{
+		return;
+	}
+
+	// PR-HANDOFF-007 — InEntityId é int64 (era int32)
+	if (ZeusEntityId == InEntityId)
+	{
+		return;
+	}
+
+	ZeusEntityId = InEntityId;
+
+	UE_LOG(LogZeusPlayer, Log,
+		TEXT("AZeusCharacter: local spawn captured EntityId=%lld pos=(%s) yaw=%.1f t=%lld"),
+		InEntityId, *PosCm.ToString(), YawDeg, ServerTimeMs);
+
+	if (UWorld* World = GetWorld())
+	{
+		if (UZeusWorldSubsystem* WorldSubsystem = World->GetSubsystem<UZeusWorldSubsystem>())
+		{
+			WorldSubsystem->RegisterLocalEntity(InEntityId, this);
+		}
+	}
+
+	// Identidade publica (EntityId) + seed no GAS Component. CharName/Guild
+	// vem separado via S_CHAR_INFO -> HandleZeusCharInfo. UZeusGASComponent
+	// vive como subobject do PlayerState (Component Registry) e recebe seed
+	// pra que o UZeusGASNetworkHandler consiga rotear o snapshot por
+	// EntityId desde o primeiro pacote.
+	if (APlayerState* PS = GetPlayerState())
+	{
+		if (AZeusPlayerState* ZeusPs = Cast<AZeusPlayerState>(PS))
+		{
+			ZeusPs->SetPublicIdentity(InEntityId, /*CharId*/ FString(),
+				/*BaseLevel*/ 1, /*ClassId*/ 0);
+		}
+		if (UZeusGASComponent* GASComp = PS->FindComponentByClass<UZeusGASComponent>())
+		{
+			GASComp->SeedEntityId(InEntityId);
+		}
+	}
+
+	// Aplica char info cacheada (caso S_CHAR_INFO tenha chegado antes do PS existir).
+	TryApplyCachedCharInfo();
+
+	// UI in-game e' responsabilidade do AZeusHUD (GameMode.HUDClass), nao do
+	// Pawn. AHUD::BeginPlay chama UUIInGameFlowSubsystem::StartInGame, que
+	// pushea WBP_HUD em UI.Layer.Game. UZeusHudWidget::NativeOnActivated auto-binda
+	// no UZeusGASComponent via PlayerState.
+}
+
+void AZeusCharacter::HandleZeusCharInfo(const int64 InEntityId, const FString& CharName, const FString& GuildName)
+{
+	UE_LOG(LogZeusPlayer, Log,
+		TEXT("AZeusCharacter: S_CHAR_INFO recebido EntityId=%lld name=%s guild=%s"),
+		InEntityId, *CharName, *GuildName);
+
+	// 2026-06-03 fix: server envia S_CHAR_INFO de TODOS os players (proprio +
+	// catch-up de proxies pre-existentes). Sem este filtro, o nome do ultimo
+	// proxy recebido sobrescrevia o do pawn local (ex: player Mateuus loga e
+	// ve "Olatudook" em si mesmo porque o catch-up do Olatudook chegou depois
+	// do S_CHAR_INFO proprio). Proxies remotos sao roteados pelo registry no
+	// UZeusWorldSubsystem (futuro nameplate por EntityId).
+	if (ZeusEntityId != 0 && InEntityId != ZeusEntityId)
+	{
+		return;
+	}
+
+	APlayerState* PS = GetPlayerState();
+	if (!PS)
+	{
+		// Race fix: pawn pode nao ter PlayerState ainda. Subsystem ja cacheou
+		// (LastLocalCharInfoCache); TryApplyCachedCharInfo aplica em
+		// HandleLocalSpawnReady ou em outra oportunidade.
+		return;
+	}
+	if (AZeusPlayerState* ZeusPs = Cast<AZeusPlayerState>(PS))
+	{
+		ZeusPs->SetCharInfo(CharName, GuildName);
+	}
+}
+
+void AZeusCharacter::TryApplyCachedCharInfo()
+{
+	if (!ZeusNetwork)
+	{
+		return;
+	}
+	int64 CachedEntityId = 0;
+	FString CachedCharName;
+	FString CachedGuildName;
+	if (!ZeusNetwork->TryGetLastLocalCharInfo(CachedEntityId, CachedCharName, CachedGuildName))
+	{
+		return;
+	}
+	if (APlayerState* PS = GetPlayerState())
+	{
+		if (AZeusPlayerState* ZeusPs = Cast<AZeusPlayerState>(PS))
+		{
+			ZeusPs->SetCharInfo(CachedCharName, CachedGuildName);
+		}
+	}
+}
+
+void AZeusCharacter::FlushInputAxisToServer(const float DeltaSeconds)
+{
+	ResolveZeusNetworkSubsystem();
+	// Sistema de rede novo (canonico) tem prioridade; legacy e' fallback.
+	const bool bV1 = (NetClient
+		&& NetClient->GetConnectionState() == EZeusV1ConnectionState::Accepted);
+	if (!bV1 && (!ZeusNetwork || !ZeusNetwork->IsConnected()))
+	{
+		return;
+	}
+
+	const float SendInterval = 1.0f / FMath::Max(1, InputSendRateHz);
+	SendAccumulatorSec += DeltaSeconds;
+	TimeSinceLastSendSec += DeltaSeconds;
+
+	// Movimento p/ efeitos de rate NAO e' so' o input (W/A/S/D): o CMC do dono
+	// continua desacelerando (braking) por ~0.3s depois de soltar a tecla. Se
+	// pararmos de enviar no rate rapido assim que o input zera, o servidor fica
+	// congelado na ultima `simpleVelCmS` alta e o proxy remoto extrapola ~1m alem
+	// (NewPos = Last.Pos + Last.Vel*ExtrapSec) ate o heartbeat corrigir -> overshoot
+	// + snap-back ("velocidade grande que demora a zerar" + jitter). Tratar a
+	// velocidade residual como movimento mantem o envio a InputSendRateHz ate o
+	// dono realmente parar, alimentando o proxy com a curva de desaceleracao.
+	const bool bHasInputAxis = !FMath::IsNearlyZero(PendingMoveForward) || !FMath::IsNearlyZero(PendingMoveRight);
+	const FVector OwnerVelNow = GetVelocity();
+	constexpr float kResidualSpeedSqCmS = 25.0f * 25.0f; // abaixo de 25 cm/s tratamos como parado
+	const bool bHasResidualVel = OwnerVelNow.SizeSquared() > kResidualSpeedSqCmS;
+	const bool bMovingInput = bHasInputAxis || bHasResidualVel;
+	const bool bJumpEvent = bPendingJumpPressed || bPendingJumpReleased;
+	const bool bRateReached = SendAccumulatorSec >= SendInterval;
+	const bool bHeartbeatReached = TimeSinceLastSendSec >= HeartbeatIntervalSec;
+
+	// IsFalling é estado contínuo do CMC (espelhado em PlayerStatePayload::grounded
+	// para alimentar o MovementMode dos proxies). Forçar envio em transições
+	// walking↔falling garante que a animação de queda/pulo dispare nos outros
+	// clientes mesmo quando estamos em rate limit / sem input de movimento.
+	const UCharacterMovementComponent* CMCForFalling = GetCharacterMovement();
+	const bool bIsFalling = CMCForFalling != nullptr && CMCForFalling->IsFalling();
+	const bool bFallingChanged = (bIsFalling != bPreviousFalling);
+
+	const bool bShouldSend = bJumpEvent || bFallingChanged || (bMovingInput && bRateReached) || (!bMovingInput && bHeartbeatReached);
+	// DEBUG-INPUT (2026-06-12): log ~1x/s COM o PIE. Remover apos achar o gap.
+	{
+		static float DbgInputAcc = 0.0f;
+		DbgInputAcc += DeltaSeconds;
+		if (DbgInputAcc >= 1.0f)
+		{
+			DbgInputAcc = 0.0f;
+			const int32 PieId = (GetWorld() && GetWorld()->GetOutermost())
+				? GetWorld()->GetOutermost()->GetPIEInstanceID() : -1;
+			UE_LOG(LogZeusPlayer, Warning,
+				TEXT("[PIE%d][InputDbg] bV1=%d state=%d moving=%d rate=%d should=%d hbReached=%d fwd=%.2f right=%.2f"),
+				PieId, bV1 ? 1 : 0,
+				NetClient ? static_cast<int32>(NetClient->GetConnectionState()) : -99,
+				bMovingInput ? 1 : 0, bRateReached ? 1 : 0, bShouldSend ? 1 : 0,
+				bHeartbeatReached ? 1 : 0, PendingMoveForward, PendingMoveRight);
+		}
+	}
+	if (!bShouldSend)
+	{
+		return;
+	}
+
+	++InputSequence;
+	const int32 ClientTimeMs = static_cast<int32>(FPlatformTime::Seconds() * 1000.0);
+	// YAW DO CORPO (nao da mira): GetActorRotation().Yaw reflete o orient-to-movement
+	// do CMC (bOrientRotationToMovement=true, RotationRate=(0,500,0)) -> o corpo vira
+	// pra direcao do MOVIMENTO (WASD), suave a 500 deg/s, e o MOUSE nao gira o corpo
+	// (bUseControllerRotationYaw=false). O servidor usa este yaw direto e o proxy nos
+	// outros clientes o replica -> o proxy vira IDENTICO ao corpo do dono.
+	//
+	// (Historico bug 2026-06-13: antes mandava GetControlRotation().Yaw -- a MIRA --
+	// e o servidor fazia atan2(vel) INSTANTANEO quando movia (proxy "virava demais"
+	// 45 graus) e usava a mira quando parado (proxy seguia o mouse). ADR 0040: o
+	// servidor NAO rotaciona mais o input por este yaw (ADR 0041 manda pos+vel
+	// mundiais), entao trocar a mira pelo corpo e' seguro. Quando precisar da MIRA
+	// real (aim/combate), adicionar um campo aimYawDeg dedicado -- nao reusar este.)
+	const float BodyYawDeg = static_cast<float>(GetActorRotation().Yaw);
+	// ADR 0041: cliente autoritativo da posicao XYZ + velocidade XY. O CMC ja
+	// integrou o input local antes deste flush, portanto `GetActorLocation` e
+	// `GetVelocity` reflectem o estado real que o servidor deve replicar para
+	// os outros clientes (sujeito ao clamp anti-cheat).
+	const FVector PosCm = GetActorLocation();
+	const FVector Vel = GetVelocity();
+	if (bV1)
+	{
+		// Sistema novo: INPUT 6077 com a pose absoluta (ADR 0040/0041).
+		const bool bSent = NetClient->EmitInput(
+			PendingMoveForward,
+			PendingMoveRight,
+			bPendingJumpPressed,
+			bPendingJumpReleased,
+			InputSequence,
+			ClientTimeMs,
+			BodyYawDeg,
+			PosCm,
+			FVector2D(Vel.X, Vel.Y),
+			bIsFalling,
+			static_cast<float>(Vel.Z));
+		// DEBUG-INPUT (2026-06-12): confirma chamada + retorno do SendPacket.
+		static float DbgEmitAcc = 0.0f;
+		DbgEmitAcc += DeltaSeconds;
+		if (DbgEmitAcc >= 1.0f)
+		{
+			DbgEmitAcc = 0.0f;
+			const int32 PieId = (GetWorld() && GetWorld()->GetOutermost())
+				? GetWorld()->GetOutermost()->GetPIEInstanceID() : -1;
+			UE_LOG(LogZeusPlayer, Warning,
+				TEXT("[PIE%d][InputDbg] EmitInput seq=%d sent=%d pos=%s"),
+				PieId, InputSequence, bSent ? 1 : 0, *PosCm.ToString());
+		}
+	}
+	else if (ZeusNetwork)
+	{
+		ZeusNetwork->SendInputAxis(
+			PendingMoveForward,
+			PendingMoveRight,
+			bPendingJumpPressed,
+			bPendingJumpReleased,
+			InputSequence,
+			ClientTimeMs,
+			BodyYawDeg,
+			PosCm,
+			FVector2D(Vel.X, Vel.Y),
+			bIsFalling,
+			static_cast<float>(Vel.Z));
+	}
+
+	SendAccumulatorSec = 0.0f;
+	TimeSinceLastSendSec = 0.0f;
+	bPendingJumpPressed = false;
+	bPendingJumpReleased = false;
+	bPreviousFalling = bIsFalling;
+}

Source/ZMMO/Game/Entity/ZeusCharacter.h

@@ -3,23 +3,25 @@
 #include "CoreMinimal.h"
 #include "GameFramework/Character.h"
 #include "Logging/LogMacros.h"
-#include "ZMMOEntityInterface.h"
-#include "ZMMOEntityTypes.h"
-#include "ZMMOPlayerCharacter.generated.h"
+#include "ZeusEntityInterface.h"
+#include "ZeusEntityTypes.h"
+#include "ZeusCharacter.generated.h"
 
 class USpringArmComponent;
 class UCameraComponent;
 class UInputAction;
 class UZeusNetworkSubsystem;
+class UZeusNetworkingClientSubsystem;
+class UZeusAOIComponent;
+class UUserWidget;
 struct FInputActionValue;
 
-DECLARE_LOG_CATEGORY_EXTERN(LogZMMOPlayer, Log, All);
+DECLARE_LOG_CATEGORY_EXTERN(LogZeusPlayer, Log, All);
 
 /**
- *  AZMMOPlayerCharacter
+ *  AZeusCharacter
  *
- *  Personagem do jogador local. Diferente do template `ThirdPersonCharacter`
- *  e do antigo `AZMMOCharacter`, este ator e parte do pipeline de rede Zeus:
+ *  Personagem do jogador local. Parte do pipeline de rede Zeus:
  *
  *    - Continua a usar o `UCharacterMovementComponent` LIVRE para correr a
  *      fisica do landscape (ADR 0038): o cliente e autoritativo localmente
@@ -27,15 +29,15 @@ DECLARE_LOG_CATEGORY_EXTERN(LogZMMOPlayer, Log, All);
  *    - Envia `C_INPUT_AXIS` ao `UZeusNetworkSubsystem` na cadencia
  *      `InputSendRateHz` (com heartbeat 5 Hz quando parado para evitar
  *      starvation do `MovementSystem` no servidor).
- *    - Implementa `IZMMOEntityInterface` para participar do registry do
- *      `UZMMOWorldSubsystem`, mas `ApplyEntitySnapshot` e `SetEntityRelevant`
+ *    - Implementa `IZeusEntityInterface` para participar do registry do
+ *      `UZeusWorldSubsystem`, mas `ApplyEntitySnapshot` e `SetEntityRelevant`
  *      sao no-op em V0 — o cliente local nao reconcilia (cliente solto).
  *
  *  TODO V1: reconciliacao opcional XY quando colisao de objetos chegar; AOI
  *  debug spheres; visual smoothing apos correcao do servidor.
  */
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API AZMMOPlayerCharacter : public ACharacter, public IZMMOEntityInterface
+class ZMMO_API AZeusCharacter : public ACharacter, public IZeusEntityInterface
 {
 	GENERATED_BODY()
 
@@ -47,8 +49,12 @@ class ZMMO_API AZMMOPlayerCharacter : public ACharacter, public IZMMOEntityInter
 	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components", meta = (AllowPrivateAccess = "true"))
 	UCameraComponent* FollowCamera;
 
-	// AttributeComponent vive no PlayerState (AZMMOPlayerState + Component Registry).
-	// Acesso: GetPlayerState<AZMMOPlayerState>()->GetZMMOComponent<UZMMOAttributeComponent>().
+	/** AOI do cliente (+ overlays de debug dirigidos pelo Zeus Admin Tools). */
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Zeus|AOI", meta = (AllowPrivateAccess = "true"))
+	TObjectPtr<UZeusAOIComponent> AOIComponent;
+
+	// GAS Component vive no PlayerState (AZeusPlayerState + Component Registry).
+	// Acesso: GetPlayerState<AZeusPlayerState>()->GetZeusComponent<UZeusGASComponent>().
 
 protected:
 	UPROPERTY(EditAnywhere, Category = "Input")
@@ -63,8 +69,18 @@ protected:
 	UPROPERTY(EditAnywhere, Category = "Input")
 	UInputAction* MouseLookAction;
 
+	/// IA_Dash — dispara C_ABILITY_TRY_ACTIVATE pra Zeus.Ability.Movement.Dash
+	/// via UZeusGASComponent. Bind padrao no IMC_Default: LeftShift -> Pressed.
+	UPROPERTY(EditAnywhere, Category = "Input")
+	UInputAction* DashAction;
+
+	/** Painel Zeus Admin Tools (AIO Debug), aberto/fechado por F8. Default =
+	 *  WBP_AdminToolsAIO (resolvido no construtor). */
+	UPROPERTY(EditAnywhere, Category = "Zeus|Admin")
+	TSubclassOf<UUserWidget> AdminPanelClass;
+
 	/** Cadencia de envio dos pacotes `C_INPUT_AXIS` (Hz). */
-	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "ZMMO|Networking", meta = (ClampMin = "1", ClampMax = "120"))
+	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Zeus|Networking", meta = (ClampMin = "1", ClampMax = "120"))
 	int32 InputSendRateHz = 30;
 
 	/**
@@ -73,22 +89,22 @@ protected:
 	 *  evitar starvation do servidor caso pacotes sejam perdidos. Em movimento
 	 *  o envio segue `InputSendRateHz` (30 Hz).
 	 */
-	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "ZMMO|Networking", meta = (ClampMin = "0.05", ClampMax = "5.0"))
+	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Zeus|Networking", meta = (ClampMin = "0.05", ClampMax = "5.0"))
 	float HeartbeatIntervalSec = 0.2f;
 
 public:
-	AZMMOPlayerCharacter();
+	AZeusCharacter();
 
 	virtual void Tick(float DeltaSeconds) override;
 
-	// --- IZMMOEntityInterface ---
-	virtual int64 GetZMMOEntityId() const override { return ZMMOEntityId; }
-	virtual EZMMOEntityType GetZMMOEntityType() const override { return EZMMOEntityType::Player; }
-	virtual void ApplyEntitySnapshot(const FZMMOEntitySnapshot& Snapshot) override;
+	// --- IZeusEntityInterface ---
+	virtual int64 GetZeusEntityId() const override { return ZeusEntityId; }
+	virtual EZeusEntityType GetZeusEntityType() const override { return EZeusEntityType::Player; }
+	virtual void ApplyEntitySnapshot(const FZeusEntitySnapshot& Snapshot) override;
 	virtual void SetEntityRelevant(bool bRelevant) override;
 
-	UFUNCTION(BlueprintCallable, Category = "ZMMO|Entity")
-	void SetZMMOEntityId(int64 InEntityId) { ZMMOEntityId = InEntityId; }
+	UFUNCTION(BlueprintCallable, Category = "Zeus|Entity")
+	void SetZeusEntityId(int64 InEntityId) { ZeusEntityId = InEntityId; }
 
 	FORCEINLINE USpringArmComponent* GetCameraBoom() const { return CameraBoom; }
 	FORCEINLINE UCameraComponent* GetFollowCamera() const { return FollowCamera; }
@@ -105,6 +121,14 @@ protected:
 	void OnJumpPressed();
 	void OnJumpReleased();
 
+	/// IA_Dash Triggered -> resolve UZeusGASComponent do PlayerState e chama
+	/// RequestActivateAbilityByTag("Zeus.Ability.Movement.Dash"). Server valida
+	/// + responde S_ABILITY_ACTIVATED (HP/SP atualizado, montage roda local).
+	void OnDashTriggered();
+
+	/** F8: cria/mostra ou esconde o painel Zeus Admin Tools (input mode UI + cursor). */
+	void ToggleAdminPanel();
+
 public:
 	/** Wrappers expostos a Blueprint (UI / mobile / automation). */
 	UFUNCTION(BlueprintCallable, Category = "Input")
@@ -131,7 +155,7 @@ private:
 	void TryRegisterLocalEntityFromCachedSpawn();
 
 	/**
-	 *  Memoriza `EntityId` autoritativo e regista o pawn no `UZMMOWorldSubsystem`
+	 *  Memoriza `EntityId` autoritativo e regista o pawn no `UZeusWorldSubsystem`
 	 *  para o registry partilhado por proxies remotos (filtra snapshots locais).
 	 *  Metadados publicos do char (Name/Guild) chegam via S_CHAR_INFO em
 	 *  HandleZeusCharInfo (servidor envia ANTES de S_SPAWN_PLAYER).
@@ -141,6 +165,11 @@ private:
 	UFUNCTION()
 	void HandleZeusPlayerSpawned(int64 InEntityId, bool bIsLocal, FVector PosCm, float YawDeg, int64 ServerTimeMs);
 
+	// Self-entity do sistema de rede novo (ENT_SELF): o cliente aprende o
+	// proprio entityId. Substitui o caminho legacy OnPlayerSpawned(bIsLocal=true).
+	UFUNCTION()
+	void HandleSelfEntityAssigned(int64 InEntityId);
+
 	UFUNCTION()
 	void HandleZeusCharInfo(int64 InEntityId, const FString& CharName, const FString& GuildName);
 
@@ -149,11 +178,19 @@ private:
 	UPROPERTY()
 	TObjectPtr<UZeusNetworkSubsystem> ZeusNetwork;
 
+	// Sistema de rede novo (canonico): fonte do self-entity (ENT_SELF).
+	UPROPERTY()
+	TObjectPtr<UZeusNetworkingClientSubsystem> NetClient;
+
+	/** Instancia viva do painel admin (criada lazy no primeiro F8). */
+	UPROPERTY(Transient)
+	TObjectPtr<UUserWidget> AdminPanelInstance;
+
 	bool bSpawnDelegateBound = false;
 
 	/** Identidade autoritativa atribuida quando o servidor envia S_SPAWN_PLAYER local. */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity", meta = (AllowPrivateAccess = "true"))
-	int64 ZMMOEntityId = 0;
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity", meta = (AllowPrivateAccess = "true"))
+	int64 ZeusEntityId = 0;
 
 	float PendingMoveForward = 0.0f;
 	float PendingMoveRight = 0.0f;

Source/ZMMO/Game/Entity/ZeusEntity.cpp

@@ -1,31 +1,31 @@
-#include "ZMMOEntity.h"
+#include "ZeusEntity.h"
 
-AZMMOEntity::AZMMOEntity()
+AZeusEntity::AZeusEntity()
 {
 	PrimaryActorTick.bCanEverTick = false;
 	bReplicates = false;
 }
 
-void AZMMOEntity::SetZMMOIdentity(const int64 InEntityId, const EZMMOEntityType InEntityType)
+void AZeusEntity::SetZeusIdentity(const int64 InEntityId, const EZeusEntityType InEntityType)
 {
 	EntityId = InEntityId;
 	EntityType = InEntityType;
 }
 
-void AZMMOEntity::ApplyEntitySnapshot(const FZMMOEntitySnapshot& Snapshot)
+void AZeusEntity::ApplyEntitySnapshot(const FZeusEntitySnapshot& Snapshot)
 {
 	const FRotator NewRotation(0.0f, Snapshot.YawDeg, 0.0f);
 	SetActorLocationAndRotation(Snapshot.PositionCm, NewRotation);
 }
 
-void AZMMOEntity::SetEntityRelevant(const bool bRelevant)
+void AZeusEntity::SetEntityRelevant(const bool bRelevant)
 {
-	if (bIsZMMORelevant == bRelevant)
+	if (bIsZeusRelevant == bRelevant)
 	{
 		return;
 	}
 
-	bIsZMMORelevant = bRelevant;
+	bIsZeusRelevant = bRelevant;
 	SetActorHiddenInGame(!bRelevant);
 	SetActorEnableCollision(bRelevant);
 	SetActorTickEnabled(bRelevant);

Source/ZMMO/Game/Entity/ZeusEntity.h

@@ -2,22 +2,22 @@
 
 #include "CoreMinimal.h"
 #include "GameFramework/Actor.h"
-#include "ZMMOEntityInterface.h"
-#include "ZMMOEntityTypes.h"
-#include "ZMMOEntity.generated.h"
+#include "ZeusEntityInterface.h"
+#include "ZeusEntityTypes.h"
+#include "ZeusEntity.generated.h"
 
 /**
- *  AZMMOEntity
+ *  AZeusEntity
  *
  *  Classe base para entidades replicadas pelo servidor que NAO precisam de
  *  capsula + `UCharacterMovementComponent` — tipicamente NPCs estaticos,
  *  objetos dinamicos do mundo, mobs simples sem locomotion fisica.
  *
  *  Para personagens com capsula + CMC (proxy de jogador, mobs com locomotion
- *  por capsula), use `AZMMOPlayerProxy` ou uma futura `AZMMOMob` que herde
+ *  por capsula), use `AZeusPlayerProxy` ou uma futura `AZeusMob` que herde
  *  de `ACharacter`.
  *
- *  Implementa `IZMMOEntityInterface` com:
+ *  Implementa `IZeusEntityInterface` com:
  *    - getters para `EntityId` / `EntityType`;
  *    - `ApplyEntitySnapshot` default: `SetActorLocationAndRotation` (sem
  *      interpolacao temporal — V1 podera adicionar ring-buffer + lerp);
@@ -25,33 +25,33 @@
  *      desativa tick (preserva o ator no mundo para futuro pooling).
  */
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API AZMMOEntity : public AActor, public IZMMOEntityInterface
+class ZMMO_API AZeusEntity : public AActor, public IZeusEntityInterface
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOEntity();
+	AZeusEntity();
 
-	// --- IZMMOEntityInterface ---
-	virtual int64 GetZMMOEntityId() const override { return EntityId; }
-	virtual EZMMOEntityType GetZMMOEntityType() const override { return EntityType; }
-	virtual void ApplyEntitySnapshot(const FZMMOEntitySnapshot& Snapshot) override;
+	// --- IZeusEntityInterface ---
+	virtual int64 GetZeusEntityId() const override { return EntityId; }
+	virtual EZeusEntityType GetZeusEntityType() const override { return EntityType; }
+	virtual void ApplyEntitySnapshot(const FZeusEntitySnapshot& Snapshot) override;
 	virtual void SetEntityRelevant(bool bRelevant) override;
 
-	/** Setter usado pelo `UZMMOWorldSubsystem` apos o spawn para registrar a identidade. */
-	UFUNCTION(BlueprintCallable, Category = "ZMMO|Entity")
-	void SetZMMOIdentity(int64 InEntityId, EZMMOEntityType InEntityType);
+	/** Setter usado pelo `UZeusWorldSubsystem` apos o spawn para registrar a identidade. */
+	UFUNCTION(BlueprintCallable, Category = "Zeus|Entity")
+	void SetZeusIdentity(int64 InEntityId, EZeusEntityType InEntityType);
 
 protected:
-	/** Identificador autoritativo do servidor. Atribuido em `SetZMMOIdentity`. */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
+	/** Identificador autoritativo do servidor. Atribuido em `SetZeusIdentity`. */
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
 	int64 EntityId = 0;
 
 	/** Categoria autoritativa (Player/Mob/NPC/Object). */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
-	EZMMOEntityType EntityType = EZMMOEntityType::Object;
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
+	EZeusEntityType EntityType = EZeusEntityType::Object;
 
 	/** Estado de relevancia atual (espelha as transicoes Hidden<->Relevant do servidor). */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
-	bool bIsZMMORelevant = true;
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
+	bool bIsZeusRelevant = true;
 };

Source/ZMMO/Game/Entity/ZeusEntityInterface.h

@@ -2,27 +2,27 @@
 
 #include "CoreMinimal.h"
 #include "UObject/Interface.h"
-#include "ZMMOEntityTypes.h"
-#include "ZMMOEntityInterface.generated.h"
+#include "ZeusEntityTypes.h"
+#include "ZeusEntityInterface.generated.h"
 
 /**
- *  UZMMOEntityInterface
+ *  UZeusEntityInterface
  *
  *  Marcador `UInterface` necessario para o sistema de reflexao da Unreal. Todo o
- *  contrato vive em `IZMMOEntityInterface` (puro C++).
+ *  contrato vive em `IZeusEntityInterface` (puro C++).
  */
 UINTERFACE(BlueprintType, MinimalAPI, meta = (CannotImplementInterfaceInBlueprint))
-class UZMMOEntityInterface : public UInterface
+class UZeusEntityInterface : public UInterface
 {
 	GENERATED_BODY()
 };
 
 /**
- *  IZMMOEntityInterface
+ *  IZeusEntityInterface
  *
  *  Contrato comum de todas as entidades replicadas pelo Zeus Server (player
- *  local, players remotos, mobs, NPCs, objetos). Inspirado em `IZeusEntityInterface`
- *  (ZeusV1) e adaptado para o nosso modelo "cliente solto + servidor valida input".
+ *  local, players remotos, mobs, NPCs, objetos). Adaptado para o nosso modelo
+ *  "cliente solto + servidor valida input".
  *
  *  Decisoes:
  *    1. **Identidade autoritativa**: `EntityId` e `EntityType` vem do servidor; o
@@ -30,28 +30,28 @@ class UZMMOEntityInterface : public UInterface
  *    2. **Visibilidade gated por AOI**: o servidor envia spawn/despawn quando o
  *       target entra/sai da area de interesse. O cliente reage via
  *       `SetEntityRelevant(bool)`.
- *    3. **Player local nao reconcilia em V0**: para o `AZMMOPlayerCharacter` o
+ *    3. **Player local nao reconcilia em V0**: para o `AZeusCharacter` o
  *       `ApplyEntitySnapshot` e no-op (cliente solto controla landscape). Quando
  *       a colisao de objetos chegar no servidor podemos ligar reconciliacao
  *       horizontal opcional.
  *
  *  Por que UInterface (e nao heranca classica)?
- *    - `AZMMOPlayerCharacter` ja herda de `ACharacter`. Forcar uma classe base
- *      `AZMMOEntity : AActor` para todos perderia o `ACharacter` gratuito.
+ *    - `AZeusCharacter` ja herda de `ACharacter`. Forcar uma classe base
+ *      `AZeusEntity : AActor` para todos perderia o `ACharacter` gratuito.
  *      A interface permite que o player local (`ACharacter`), o proxy remoto
  *      (`ACharacter`) e entidades genericas (`AActor`) implementem o mesmo
  *      contrato sem heranca multipla concreta.
  */
-class ZMMO_API IZMMOEntityInterface
+class ZMMO_API IZeusEntityInterface
 {
 	GENERATED_BODY()
 
 public:
 	/** Identificador autoritativo da entidade no servidor. */
-	virtual int64 GetZMMOEntityId() const = 0;
+	virtual int64 GetZeusEntityId() const = 0;
 
 	/** Categoria da entidade (Player, Mob, NPC, Object). */
-	virtual EZMMOEntityType GetZMMOEntityType() const = 0;
+	virtual EZeusEntityType GetZeusEntityType() const = 0;
 
 	/**
 	 * Aplica um snapshot autoritativo. Implementacoes podem extender com
@@ -61,7 +61,7 @@ public:
 	 * fisica do landscape de forma autoritativa local, e o servidor apenas
 	 * valida input/velocidade (ADR 0038).
 	 */
-	virtual void ApplyEntitySnapshot(const FZMMOEntitySnapshot& Snapshot) = 0;
+	virtual void ApplyEntitySnapshot(const FZeusEntitySnapshot& Snapshot) = 0;
 
 	/**
 	 * Alterna entre estado visivel/ativo (`true`) e oculto/desativado (`false`).

Source/ZMMO/Game/Entity/ZeusEntityTypes.h

@@ -1,14 +1,14 @@
 #pragma once
 
 #include "CoreMinimal.h"
-#include "ZMMOEntityTypes.generated.h"
+#include "ZeusEntityTypes.generated.h"
 
 /**
  *  Categoria autoritativa replicada pelo servidor. Determina que classe de ator
- *  o `UZMMOWorldSubsystem` deve spawnar para um snapshot recebido.
+ *  o `UZeusWorldSubsystem` deve spawnar para um snapshot recebido.
  */
 UENUM(BlueprintType)
-enum class EZMMOEntityType : uint8
+enum class EZeusEntityType : uint8
 {
 	Player UMETA(DisplayName = "Player"),
 	Mob    UMETA(DisplayName = "Mob"),
@@ -17,48 +17,48 @@ enum class EZMMOEntityType : uint8
 };
 
 /**
- *  Snapshot autoritativo aplicado por `IZMMOEntityInterface::ApplyEntitySnapshot`.
+ *  Snapshot autoritativo aplicado por `IZeusEntityInterface::ApplyEntitySnapshot`.
  *
- *  Construido pelo `UZMMOWorldSubsystem` a partir dos delegates do
+ *  Construido pelo `UZeusWorldSubsystem` a partir dos delegates do
  *  `UZeusNetworkSubsystem` (`OnPlayerStateUpdate` em V0; opcodes para mobs/NPCs
  *  em V1+). Mantemos os campos minimos que o servidor ja replica hoje
  *  (`S_PLAYER_STATE`); novos campos sao adicionados aqui sempre que o protocolo
  *  evoluir, sem mexer nas classes de proxy.
  */
 USTRUCT(BlueprintType)
-struct FZMMOEntitySnapshot
+struct FZeusEntitySnapshot
 {
 	GENERATED_BODY()
 
 	/** EntityId autoritativo do servidor. */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
 	int64 EntityId = 0;
 
 	/** Categoria do ator (define qual proxy class spawnar). */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
-	EZMMOEntityType EntityType = EZMMOEntityType::Player;
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
+	EZeusEntityType EntityType = EZeusEntityType::Player;
 
 	/** Sequencia de input processada no servidor (so faz sentido para players). */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
 	int32 LastProcessedInputSeq = 0;
 
 	/** Posicao mundo (cm). */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
 	FVector PositionCm = FVector::ZeroVector;
 
 	/** Velocidade mundo (cm/s) — usada para network smoothing e drivers de animacao. */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
 	FVector VelocityCmS = FVector::ZeroVector;
 
 	/** Yaw em graus (orientacao visual). */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
 	float YawDeg = 0.0f;
 
 	/** Indica se o servidor considera o ator em solo. */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
 	bool bGrounded = false;
 
 	/** Tempo do servidor (ms desde epoch) quando este snapshot foi gerado. */
-	UPROPERTY(BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(BlueprintReadOnly, Category = "Zeus|Entity")
 	int64 ServerTimeMs = 0;
 };

Source/ZMMO/Game/Entity/ZeusPlayerProxy.cpp

@@ -1,4 +1,4 @@
-#include "ZMMOPlayerProxy.h"
+#include "ZeusPlayerProxy.h"
 
 #include "Animation/AnimInstance.h"
 #include "Components/CapsuleComponent.h"
@@ -8,10 +8,10 @@
 #include "GameFramework/CharacterMovementComponent.h"
 #include "UObject/ConstructorHelpers.h"
 #include "ZMMO.h"
-#include "ZMMOProxyMovementComponent.h"
+#include "ZeusProxyMovementComponent.h"
 
-AZMMOPlayerProxy::AZMMOPlayerProxy(const FObjectInitializer& ObjectInitializer)
-	: Super(ObjectInitializer.SetDefaultSubobjectClass<UZMMOProxyMovementComponent>(ACharacter::CharacterMovementComponentName))
+AZeusPlayerProxy::AZeusPlayerProxy(const FObjectInitializer& ObjectInitializer)
+	: Super(ObjectInitializer.SetDefaultSubobjectClass<UZeusProxyMovementComponent>(ACharacter::CharacterMovementComponentName))
 {
 	PrimaryActorTick.bCanEverTick = true;
 	PrimaryActorTick.bStartWithTickEnabled = true;
@@ -43,7 +43,7 @@ AZMMOPlayerProxy::AZMMOPlayerProxy(const FObjectInitializer& ObjectInitializer)
 		CMC->BrakingFrictionFactor = 0.0f;
 	}
 
-	// Defaults visuais (mesh + AnimBP) em paridade com `AZMMOPlayerCharacter`.
+	// Defaults visuais (mesh + AnimBP) em paridade com `AZeusCharacter`.
 	if (USkeletalMeshComponent* MeshComponent = GetMesh())
 	{
 		static ConstructorHelpers::FObjectFinder<USkeletalMesh> QuinnMesh(
@@ -60,7 +60,7 @@ AZMMOPlayerProxy::AZMMOPlayerProxy(const FObjectInitializer& ObjectInitializer)
 		else
 		{
 			UE_LOG(LogZMMO, Warning,
-				TEXT("AZMMOPlayerProxy: SKM_Quinn_Simple nao encontrado em /Game/Characters/Mannequins/Meshes."));
+				TEXT("AZeusPlayerProxy: SKM_Quinn_Simple nao encontrado em /Game/Characters/Mannequins/Meshes."));
 		}
 
 		if (QuinnAnimBp.Succeeded())
@@ -71,7 +71,7 @@ AZMMOPlayerProxy::AZMMOPlayerProxy(const FObjectInitializer& ObjectInitializer)
 		else
 		{
 			UE_LOG(LogZMMO, Warning,
-				TEXT("AZMMOPlayerProxy: ABP_Unarmed nao encontrado em /Game/Characters/Mannequins/Anims/Unarmed."));
+				TEXT("AZeusPlayerProxy: ABP_Unarmed nao encontrado em /Game/Characters/Mannequins/Anims/Unarmed."));
 		}
 	}
 
@@ -80,7 +80,7 @@ AZMMOPlayerProxy::AZMMOPlayerProxy(const FObjectInitializer& ObjectInitializer)
 	bUseControllerRotationRoll = false;
 }
 
-void AZMMOPlayerProxy::BeginPlay()
+void AZeusPlayerProxy::BeginPlay()
 {
 	Super::BeginPlay();
 
@@ -94,7 +94,7 @@ void AZMMOPlayerProxy::BeginPlay()
 	}
 }
 
-void AZMMOPlayerProxy::Tick(const float DeltaSeconds)
+void AZeusPlayerProxy::Tick(const float DeltaSeconds)
 {
 	Super::Tick(DeltaSeconds);
 
@@ -131,18 +131,25 @@ void AZMMOPlayerProxy::Tick(const float DeltaSeconds)
 		// Sem snapshot futuro: extrapolacao curta com a ultima velocidade
 		// conhecida, clampada por `MaxExtrapolationSeconds` para nao deixar
 		// o proxy fugir se a rede ficar muda.
-		const FZMMOProxySnapshot& Last = SnapshotBuffer.Last();
-		const float ExtrapSec = FMath::Clamp(
-			static_cast<float>(RenderMs - Last.ServerTimeMs) / 1000.0f,
-			0.0f, MaxExtrapolationSeconds);
+		const FZeusProxySnapshot& Last = SnapshotBuffer.Last();
+		const float RawExtrapSec =
+			static_cast<float>(RenderMs - Last.ServerTimeMs) / 1000.0f;
+		const float ExtrapSec = FMath::Clamp(RawExtrapSec, 0.0f, MaxExtrapolationSeconds);
 		NewPos = Last.PosCm + Last.VelCmS * ExtrapSec;
-		NewVel = Last.VelCmS;
+		// STARVATION (buffer=1 por muito tempo -- ex: 1o login sem DELTA_BATCH por
+		// segundos): a extrapolacao satura no clamp e a POSE congela, mas manter a
+		// velocidade faz o AnimBP rodar locomocao PARADO ("andar no lugar"/moonwalk
+		// = o "jitter" reportado). Se ja passamos bem do clamp, zera a vel visual
+		// pra o proxy ir pra Idle ate' os deltas voltarem (em vez de animar
+		// andando travado). Quando os deltas chegam, o ramo de interpolacao retoma.
+		const bool bStarved = RawExtrapSec > (MaxExtrapolationSeconds + 0.15f);
+		NewVel = bStarved ? FVector::ZeroVector : Last.VelCmS;
 		bExtrapolating = ExtrapSec > KINDA_SMALL_NUMBER;
 	}
 	else
 	{
-		const FZMMOProxySnapshot& A = SnapshotBuffer[IdxB - 1];
-		const FZMMOProxySnapshot& B = SnapshotBuffer[IdxB];
+		const FZeusProxySnapshot& A = SnapshotBuffer[IdxB - 1];
+		const FZeusProxySnapshot& B = SnapshotBuffer[IdxB];
 		const double Span = FMath::Max<double>(1.0, static_cast<double>(B.ServerTimeMs - A.ServerTimeMs));
 		InterpAlpha = static_cast<float>(FMath::Clamp(
 			static_cast<double>(RenderMs - A.ServerTimeMs) / Span, 0.0, 1.0));
@@ -150,12 +157,32 @@ void AZMMOPlayerProxy::Tick(const float DeltaSeconds)
 		NewVel = FMath::Lerp(A.VelCmS, B.VelCmS, InterpAlpha);
 	}
 
-	// Yaw deriva da velocidade interpolada: locomotion mantem face na direcao
-	// do movimento; em idle preserva o yaw atual para nao "snappar".
+	// ORIENTACAO DO CORPO = REPLICA do yaw autoritativo do servidor (Snapshot.YawDeg),
+	// interpolado shortest-path entre os MESMOS A/B da posicao. Esse yaw agora carrega
+	// o yaw do CORPO do dono (orient-to-movement do CMC: vira pra direcao do MOVIMENTO
+	// /WASD, suave a 500 deg/s; parado mantem; o MOUSE nao gira o corpo) -- o cliente
+	// dono manda GetActorRotation().Yaw e o servidor repassa direto. Por isso o proxy
+	// so' REPLICA: vira identico ao corpo do dono, sem re-derivar nada.
+	//
+	// NAO derivamos de Atan2(velocidade): isso era a fonte do bug 2026-06-13 ("virava
+	// demais 45 graus") -- a direcao da velocidade salta, o yaw do corpo nao. A
+	// suavizacao correta ja' aconteceu no CMC do dono; aqui so' interpolamos amostras.
+	//
+	// FUTURO -- Motion Matching/aim: quando "a mira dita a locomocao" (strafe/aim
+	// offset), o servidor passara a mandar um aimYawDeg separado e o AnimBP usara a
+	// velocidade relativa a este yaw pra escolher fwd/back/left/right. Por ORA, 1 yaw.
 	FRotator NewRot = GetActorRotation();
-	if (FVector(NewVel.X, NewVel.Y, 0.0f).SizeSquared() > 1.0f)
+	if (IdxB == INDEX_NONE)
 	{
-		NewRot.Yaw = FMath::RadiansToDegrees(FMath::Atan2(NewVel.Y, NewVel.X));
+		NewRot.Yaw = SnapshotBuffer.Last().YawDeg; // extrapolando: segura o ultimo yaw
+	}
+	else
+	{
+		const float YawA = SnapshotBuffer[IdxB - 1].YawDeg;
+		const float YawB = SnapshotBuffer[IdxB].YawDeg;
+		// FindDeltaAngleDegrees -> menor arco (-180..180); evita girar "o lado longo".
+		const float DeltaYaw = FMath::FindDeltaAngleDegrees(YawA, YawB);
+		NewRot.Yaw = YawA + DeltaYaw * InterpAlpha;
 	}
 	NewRot.Pitch = 0.0f;
 	NewRot.Roll  = 0.0f;
@@ -207,33 +234,96 @@ void AZMMOPlayerProxy::Tick(const float DeltaSeconds)
 		LastDiagLogSec = NowSec;
 		const int64 NewestMs = SnapshotBuffer.Last().ServerTimeMs;
 		const int64 RenderLagMs = ServerNowMs - NewestMs;
-		UE_LOG(LogZMMO, Verbose,
-			TEXT("ZMMOPlayerProxy[%lld] buffer=%d renderLagMs=%lld interpAlpha=%.2f extrap=%d delayMs=%.0f"),
-			EntityId, SnapshotBuffer.Num(), RenderLagMs, InterpAlpha,
-			bExtrapolating ? 1 : 0, InterpolationDelayMs);
+		// === DIAG PERMANENTE -- jitter por FOME DE DELTAS ========================
+		// Bug investigado/resolvido 2026-06-13 (ver memoria
+		// project_proxy_delta_starvation_jitter). Este Warning FICA DE PROPOSITO
+		// (decisao do dono: NAO rebaixar p/ Verbose nem remover) -- e' a sonda pra
+		// cacar regressao do jitter de proxy. Como ler:
+		//   secsSinceSnap = ha quanto tempo o proxy NAO recebe snapshot. Sobe = FOME
+		//     (player remoto parado -> ComputeDelta suprime no server -> sem DELTA_BATCH).
+		//   newestMs = serverTimeMs do ultimo snapshot; CONGELA na fome (deveria avancar).
+		//   renderLagMs = ServerNowMs - newestMs; cresce 1:1 com o wall-clock na fome.
+		//   speed=0 na fome = a mitigacao (zera a vel visual -> Idle, sem "moonwalk") agindo.
+		//   Ao o player voltar a se mover sai "buffer STALE ... reset+reseed" (anti-stale)
+		//   e renderLagMs/secsSinceSnap voltam a ~0 (snap limpo, sem salto/jitter).
+		// =========================================================================
+		const double SecsSinceSnap =
+			(LastSnapshotRecvSec > 0.0) ? (NowSec - LastSnapshotRecvSec) : -1.0;
+		UE_LOG(LogZMMO, Warning,
+			TEXT("ZeusPlayerProxy[%lld] buffer=%d renderLagMs=%lld newestMs=%lld secsSinceSnap=%.1f interpAlpha=%.2f extrap=%d speed=%.0f"),
+			EntityId, SnapshotBuffer.Num(), RenderLagMs, NewestMs, SecsSinceSnap, InterpAlpha,
+			bExtrapolating ? 1 : 0,
+			FVector(VisualVelocity.X, VisualVelocity.Y, 0.0f).Size());
 	}
 }
 
-void AZMMOPlayerProxy::SetZMMOIdentity(const int64 InEntityId, const EZMMOEntityType InEntityType)
+void AZeusPlayerProxy::SetZeusIdentity(const int64 InEntityId, const EZeusEntityType InEntityType)
 {
 	EntityId = InEntityId;
 	EntityType = InEntityType;
 }
 
-void AZMMOPlayerProxy::ApplyEntitySnapshot(const FZMMOEntitySnapshot& Snapshot)
+void AZeusPlayerProxy::ApplyEntitySnapshot(const FZeusEntitySnapshot& Snapshot)
 {
-	// Estabiliza o offset de relogio na primeira amostra. Subsequente nao
-	// re-sincroniza para evitar saltos visuais; um esquema mais sofisticado
-	// (ema do offset) cabe quando tivermos ping/RTT estabilizado por sessao.
-	if (SnapshotBuffer.Num() == 0)
+	LastSnapshotRecvSec = FPlatformTime::Seconds(); // DIAG: marca chegada (mede a fome no Tick)
+
+	// 2026-06-06 H3 fix — disciplina o ServerClockOffsetMs via EMA com clamp.
+	// Antes: offset congelado na 1a amostra. Em cross-server handoff a fonte
+	// do ServerTimeMs muda (publisher antigo -> novo) e o offset fica
+	// permanentemente skewed, alimentando tremor pos-handoff e drift cumulativo
+	// de clock cliente vs server. Agora cada amostra recalcula candidato e
+	// suaviza (alpha=0.02, ~50 amostras pra convergir) com clamp max 2ms/snapshot
+	// pra evitar salto visual durante transicao.
+	const int64 LocalNowMs = static_cast<int64>(FPlatformTime::Seconds() * 1000.0);
+	const int64 OffsetCandidate = LocalNowMs - Snapshot.ServerTimeMs;
+
+	// Anti-stale (2026-06-13): se este snapshot esta MUITO a frente do mais novo
+	// do buffer, o proxy ficou "mudo" por segundos -- player remoto parado ->
+	// ComputeDelta suprime -> sem DELTA_BATCH novo -> renderLagMs disparou pra
+	// dezenas de segundos. Manter os snapshots velhos faz a interpolacao usar um
+	// span gigante (pose de ~100s atras -> agora) quando o player volta a se mover,
+	// causando rasteio/salto (o jitter reportado). Descarta o buffer obsoleto +
+	// re-bootstrapa o relogio pra a interpolacao recomecar limpa neste keyframe.
+	if (SnapshotBuffer.Num() > 0
+		&& (Snapshot.ServerTimeMs - SnapshotBuffer.Last().ServerTimeMs) > 1000)
 	{
-		const int64 LocalNowMs = static_cast<int64>(FPlatformTime::Seconds() * 1000.0);
-		ServerClockOffsetMs = LocalNowMs - Snapshot.ServerTimeMs;
+		UE_LOG(LogZMMO, Warning,
+			TEXT("ZeusPlayerProxy[%lld] buffer STALE gap=%lldms -> reset+reseed"),
+			EntityId, Snapshot.ServerTimeMs - SnapshotBuffer.Last().ServerTimeMs);
+		SnapshotBuffer.Reset();
+		ServerClockOffsetMs = OffsetCandidate;
 	}
 
-	FZMMOProxySnapshot S;
+	if (SnapshotBuffer.Num() == 0)
+	{
+		// Primeira amostra: bootstrap direto (nao tem baseline pra suavizar).
+		ServerClockOffsetMs = OffsetCandidate;
+		// DIAG (jitter 1o login): confirma o seed do relogio. serverTimeMs deve ser
+		// != 0 e o offset razoavel; se vier 0 aqui, o keyframe/catch-up corrompeu o
+		// bootstrap (hipotese descartada, mas o log fecha a questao em campo).
+		UE_LOG(LogZMMO, Warning,
+			TEXT("ZeusPlayerProxy[%lld] SEED clock serverTimeMs=%lld localNowMs=%lld offset=%lld"),
+			EntityId, Snapshot.ServerTimeMs, LocalNowMs, ServerClockOffsetMs);
+	}
+	else
+	{
+		const double Alpha = 0.02;
+		const int64 RawTarget = static_cast<int64>(
+			static_cast<double>(ServerClockOffsetMs) * (1.0 - Alpha)
+			+ static_cast<double>(OffsetCandidate) * Alpha);
+		// Clamp max 2ms por amostra — em 30Hz isso converge a 60ms/s, mais que
+		// o suficiente pra absorver drift normal sem causar tremor visual.
+		const int64 Delta = RawTarget - ServerClockOffsetMs;
+		const int64 ClampedDelta = (Delta > 2)  ? 2
+		                          : (Delta < -2) ? -2
+		                          : Delta;
+		ServerClockOffsetMs += ClampedDelta;
+	}
+
+	FZeusProxySnapshot S;
 	S.PosCm = Snapshot.PositionCm;
 	S.VelCmS = Snapshot.VelocityCmS;
+	S.YawDeg = Snapshot.YawDeg; // yaw do CORPO do dono (orient-to-movement; mouse nao gira)
 	S.bGrounded = Snapshot.bGrounded;
 	S.ServerTimeMs = Snapshot.ServerTimeMs;
 
@@ -282,20 +372,20 @@ void AZMMOPlayerProxy::ApplyEntitySnapshot(const FZMMOEntitySnapshot& Snapshot)
 	ApplyCollisionPolicy();
 }
 
-void AZMMOPlayerProxy::SetEntityRelevant(const bool bRelevant)
+void AZeusPlayerProxy::SetEntityRelevant(const bool bRelevant)
 {
-	if (bIsZMMORelevant == bRelevant)
+	if (bIsZeusRelevant == bRelevant)
 	{
 		return;
 	}
 
-	bIsZMMORelevant = bRelevant;
+	bIsZeusRelevant = bRelevant;
 	SetActorHiddenInGame(!bRelevant);
 	SetActorTickEnabled(bRelevant);
 	ApplyCollisionPolicy();
 }
 
-void AZMMOPlayerProxy::RefreshAnimationDrivers()
+void AZeusPlayerProxy::RefreshAnimationDrivers()
 {
 	UCharacterMovementComponent* CMC = GetCharacterMovement();
 	if (!CMC)
@@ -314,13 +404,13 @@ void AZMMOPlayerProxy::RefreshAnimationDrivers()
 
 	// Acceleration externa via CMC custom — alimenta `Get Current Acceleration`
 	// que o AnimBP do Quinn usa em `ShouldMove` e nas transições de Jump_Start.
-	if (UZMMOProxyMovementComponent* ProxyCMC = Cast<UZMMOProxyMovementComponent>(CMC))
+	if (UZeusProxyMovementComponent* ProxyCMC = Cast<UZeusProxyMovementComponent>(CMC))
 	{
-		ProxyCMC->SetZMMOExternalAcceleration(LastDerivedAccelerationCmS2);
+		ProxyCMC->SetZeusExternalAcceleration(LastDerivedAccelerationCmS2);
 	}
 }
 
-void AZMMOPlayerProxy::ApplyCollisionPolicy()
+void AZeusPlayerProxy::ApplyCollisionPolicy()
 {
 	UCapsuleComponent* Capsule = GetCapsuleComponent();
 	if (!Capsule)
@@ -328,6 +418,6 @@ void AZMMOPlayerProxy::ApplyCollisionPolicy()
 		return;
 	}
 
-	const bool bShouldCollide = bIsZMMORelevant && bHasFirstSnapshot;
+	const bool bShouldCollide = bIsZeusRelevant && bHasFirstSnapshot;
 	Capsule->SetCollisionEnabled(bShouldCollide ? ECollisionEnabled::QueryOnly : ECollisionEnabled::NoCollision);
 }

Source/ZMMO/Game/Entity/ZeusPlayerProxy.h

@@ -2,19 +2,18 @@
 
 #include "CoreMinimal.h"
 #include "GameFramework/Character.h"
-#include "ZMMOEntityInterface.h"
-#include "ZMMOEntityTypes.h"
-#include "ZMMOPlayerProxy.generated.h"
+#include "ZeusEntityInterface.h"
+#include "ZeusEntityTypes.h"
+#include "ZeusPlayerProxy.generated.h"
 
 /**
- *  AZMMOPlayerProxy
+ *  AZeusPlayerProxy
  *
  *  Proxy visual para jogadores remotos (e, no futuro, mobs com locomotion
  *  por capsula) cuja posicao vem 100% do servidor via snapshots
  *  (`UZeusNetworkSubsystem::OnPlayerStateUpdate`).
  *
- *  Inspirado em `AZeusRemoteCharacter` (ZeusV1). Diferencas chave vs.
- *  `AZMMOPlayerCharacter` (jogador local):
+ *  Diferencas chave vs. `AZeusCharacter` (jogador local):
  *    - SEM `EnhancedInput`, sem envio de `C_INPUT_AXIS`.
  *    - SEM buffer de pending inputs nem reconciliacao.
  *    - Posicao aplicada por snapshot (`ApplyEntitySnapshot`); a `ACharacter`
@@ -22,19 +21,18 @@
  *      mas o CMC fica em modo "kinematic-ish" (nao integra fisica).
  *
  *  Animacao no AnimBP do Quinn (`ABP_Unarmed`): a formula `ShouldMove` exige
- *  `Acceleration != 0`. Como proxies nao tem input, adoptamos a mesma
- *  estrategia do ZClientMMO: CMC custom (`UZMMOProxyMovementComponent`) com
- *  escrita externa de `Acceleration`, alimentada pela derivada da velocidade
- *  entre snapshots. Tick do proxy roda **antes** do mesh tick para que
- *  Velocity+Acceleration estejam populados quando o `NativeUpdateAnimation`
- *  do AnimBP os ler.
+ *  `Acceleration != 0`. Como proxies nao tem input, adoptamos a estrategia
+ *  de CMC custom (`UZeusProxyMovementComponent`) com escrita externa de
+ *  `Acceleration`, alimentada pela derivada da velocidade entre snapshots.
+ *  Tick do proxy roda **antes** do mesh tick para que Velocity+Acceleration
+ *  estejam populados quando o `NativeUpdateAnimation` do AnimBP os ler.
  */
 /**
  *  Snapshot bruto guardado no buffer de interpolacao. Mantido como struct privada
  *  ao .h porque so o proxy (e debugging local) precisa olhar para ele.
  */
 USTRUCT()
-struct FZMMOProxySnapshot
+struct FZeusProxySnapshot
 {
 	GENERATED_BODY()
 
@@ -44,6 +42,15 @@ struct FZMMOProxySnapshot
 	UPROPERTY()
 	FVector VelCmS = FVector::ZeroVector;
 
+	/** Yaw autoritativo do servidor (graus) = o MESMO yaw que o player LOCAL aplicou
+	 *  ao virar. O proxy replica EXATAMENTE a viradinha do local (apertou D = mesma
+	 *  virada nos dois). Sem armazenar isto, o proxy derivava o yaw da velocidade
+	 *  (Atan2) e "virava totalmente pra direcao do movimento" (bug 2026-06-13).
+	 *  NAO confundir com "mira dita a locomocao" (strafe / Motion Matching) -- isso
+	 *  esta' DESABILITADO por ora (ver AVISO em ZeusPlayerProxy.cpp::Tick). */
+	UPROPERTY()
+	float YawDeg = 0.0f;
+
 	UPROPERTY()
 	bool bGrounded = true;
 
@@ -53,37 +60,37 @@ struct FZMMOProxySnapshot
 };
 
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API AZMMOPlayerProxy : public ACharacter, public IZMMOEntityInterface
+class ZMMO_API AZeusPlayerProxy : public ACharacter, public IZeusEntityInterface
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOPlayerProxy(const FObjectInitializer& ObjectInitializer);
+	AZeusPlayerProxy(const FObjectInitializer& ObjectInitializer);
 
 	virtual void BeginPlay() override;
 	virtual void Tick(float DeltaSeconds) override;
 
-	// --- IZMMOEntityInterface ---
-	virtual int64 GetZMMOEntityId() const override { return EntityId; }
-	virtual EZMMOEntityType GetZMMOEntityType() const override { return EntityType; }
-	virtual void ApplyEntitySnapshot(const FZMMOEntitySnapshot& Snapshot) override;
+	// --- IZeusEntityInterface ---
+	virtual int64 GetZeusEntityId() const override { return EntityId; }
+	virtual EZeusEntityType GetZeusEntityType() const override { return EntityType; }
+	virtual void ApplyEntitySnapshot(const FZeusEntitySnapshot& Snapshot) override;
 	virtual void SetEntityRelevant(bool bRelevant) override;
 
-	UFUNCTION(BlueprintCallable, Category = "ZMMO|Entity")
-	void SetZMMOIdentity(int64 InEntityId, EZMMOEntityType InEntityType);
+	UFUNCTION(BlueprintCallable, Category = "Zeus|Entity")
+	void SetZeusIdentity(int64 InEntityId, EZeusEntityType InEntityType);
 
 protected:
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
 	int64 EntityId = 0;
 
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
-	EZMMOEntityType EntityType = EZMMOEntityType::Player;
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
+	EZeusEntityType EntityType = EZeusEntityType::Player;
 
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
-	bool bIsZMMORelevant = true;
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
+	bool bIsZeusRelevant = true;
 
 	/** True apos o primeiro snapshot ser aplicado — antes disso o ator pode ficar oculto. */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
 	bool bHasFirstSnapshot = false;
 
 	/**
@@ -91,15 +98,15 @@ protected:
 	 *  de `InterpolatedPosCm` (visual) — separar os dois e essencial para
 	 *  comparar drift autoritativo vs visual via debug overlay/logs.
 	 */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
 	FVector AuthoritativePosCm = FVector::ZeroVector;
 
 	/** Posicao **visual** atual (resultado da interpolacao do tick). */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
 	FVector InterpolatedPosCm = FVector::ZeroVector;
 
 	/** Compat: alias para `AuthoritativePosCm` (preserva binding de Blueprint, se houver). */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
 	FVector LastSnapshotPosition = FVector::ZeroVector;
 
 	/**
@@ -108,7 +115,7 @@ protected:
 	 *  em cada `Tick` para manter os drivers de animacao alimentados entre
 	 *  updates de rede.
 	 */
-	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Entity")
+	UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Entity")
 	FVector VisualVelocity = FVector::ZeroVector;
 
 	/**
@@ -116,23 +123,23 @@ protected:
 	 *  expresso no dominio do tempo do servidor. Padrao 100 ms (~3 snapshots a 30 Hz)
 	 *  cobre 1 perda + 1 jitter sem extrapolar.
 	 */
-	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ZMMO|Network",
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|Network",
 		meta = (ClampMin = "0.0", ClampMax = "500.0"))
 	double InterpolationDelayMs = 100.0;
 
 	/** Tamanho maximo do buffer (em snapshots). Cobre ~270 ms a 30 Hz. */
-	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ZMMO|Network",
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|Network",
 		meta = (ClampMin = "2", ClampMax = "32"))
 	int32 SnapshotBufferCapacity = 8;
 
 	/** Limite duro de extrapolacao (s) quando nao ha snapshot futuro. */
-	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "ZMMO|Network",
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|Network",
 		meta = (ClampMin = "0.0", ClampMax = "0.5"))
 	float MaxExtrapolationSeconds = 0.1f;
 
 	/** Buffer ordenado por `ServerTimeMs` ascendente. */
 	UPROPERTY()
-	TArray<FZMMOProxySnapshot> SnapshotBuffer;
+	TArray<FZeusProxySnapshot> SnapshotBuffer;
 
 	/**
 	 *  Offset entre o relogio local (`FPlatformTime::Seconds * 1000`) e o
@@ -142,6 +149,12 @@ protected:
 	 */
 	int64 ServerClockOffsetMs = 0;
 
+	/** DIAG (2026-06-13): instante (s, monotonic) do ultimo snapshot recebido em
+	 *  ApplyEntitySnapshot. Usado no log do Tick pra medir "secsSinceSnap" = quanto
+	 *  tempo o proxy ficou MUDO (sem delta). secsSinceSnap grande == fome (player
+	 *  remoto parado -> ComputeDelta suprime). 0 = nenhum snapshot ainda. */
+	double LastSnapshotRecvSec = 0.0;
+
 	/** Aceleracao derivada (com smoothing) escrita no CMC custom para alimentar
 	 *  o AnimBP (`ShouldMove`/`Jump_Start` exigem Acceleration!=0). */
 	FVector LastDerivedAccelerationCmS2 = FVector::ZeroVector;

Source/ZMMO/Game/Entity/ZeusProxyMovementComponent.h

@@ -0,0 +1,24 @@
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameFramework/CharacterMovementComponent.h"
+
+#include "ZeusProxyMovementComponent.generated.h"
+
+/**
+ * CMC customizado para AZeusPlayerProxy. Expõe escrita direta de Acceleration
+ * (protected na base) para que o AnimBP veja Acceleration!=0 quando o proxy
+ * recebe snapshots, alimentando a fórmula ShouldMove e a transição Jump_Start
+ * do ABP_Unarmed (ambas dependem de aceleração não-nula).
+ */
+UCLASS(ClassGroup = (Zeus), meta = (BlueprintSpawnableComponent))
+class ZMMO_API UZeusProxyMovementComponent : public UCharacterMovementComponent
+{
+	GENERATED_BODY()
+
+public:
+	void SetZeusExternalAcceleration(const FVector& InAccelerationCmS2)
+	{
+		Acceleration = InAccelerationCmS2;
+	}
+};

Source/ZMMO/Game/Modes/ZMMOFrontEndGameMode.cpp

@@ -1,10 +0,0 @@
-#include "ZMMOFrontEndGameMode.h"
-
-#include "ZMMOFrontEndPlayerController.h"
-
-AZMMOFrontEndGameMode::AZMMOFrontEndGameMode()
-{
-	// UI pura: sem pawn. O controller cria o root layout e arranca o fluxo.
-	DefaultPawnClass = nullptr;
-	PlayerControllerClass = AZMMOFrontEndPlayerController::StaticClass();
-}

Source/ZMMO/Game/Modes/ZMMOGameMode.cpp

@@ -1,14 +0,0 @@
-#include "ZMMOGameMode.h"
-
-#include "ZMMOHUD.h"
-#include "ZMMOPlayerCharacter.h"
-#include "ZMMOPlayerController.h"
-#include "ZMMOPlayerState.h"
-
-AZMMOGameMode::AZMMOGameMode()
-{
-	DefaultPawnClass = AZMMOPlayerCharacter::StaticClass();
-	PlayerControllerClass = AZMMOPlayerController::StaticClass();
-	PlayerStateClass = AZMMOPlayerState::StaticClass();
-	HUDClass = AZMMOHUD::StaticClass();
-}

Source/ZMMO/Game/Modes/ZMMOPlayerState.cpp

@@ -1,100 +0,0 @@
-#include "ZMMOPlayerState.h"
-
-#include "Components/ActorComponent.h"
-#include "Misc/ConfigCacheIni.h"
-#include "Net/UnrealNetwork.h"
-#include "ZMMO.h"
-
-AZMMOPlayerState::AZMMOPlayerState()
-{
-	// Component Registry: instancia cada classe declarada em
-	// DefaultGame.ini::[/Script/ZMMO.ZMMOPlayerState]+ComponentClasses=...
-	//
-	// Le manualmente via GConfig para evitar timing do UPROPERTY(Config),
-	// que requer LoadConfig() ja ter rodado no CDO antes da instance ser
-	// construida. Pra propriedades em arrays config com `+` syntax, lendo
-	// direto e mais previsivel.
-	if (ComponentClasses.Num() == 0 && GConfig)
-	{
-		TArray<FString> ClassPaths;
-		GConfig->GetArray(TEXT("/Script/ZMMO.ZMMOPlayerState"),
-		                  TEXT("ComponentClasses"),
-		                  ClassPaths,
-		                  GGameIni);
-		for (const FString& Path : ClassPaths)
-		{
-			if (UClass* C = LoadClass<UActorComponent>(nullptr, *Path))
-			{
-				ComponentClasses.Add(C);
-			}
-			else
-			{
-				UE_LOG(LogZMMO, Warning,
-					TEXT("ZMMOPlayerState: ComponentClasses path nao resolveu: %s"), *Path);
-			}
-		}
-	}
-
-	UE_LOG(LogZMMO, Log,
-		TEXT("AZMMOPlayerState ctor: %d componente(s) no registry (instance=%s)"),
-		ComponentClasses.Num(), *GetName());
-
-	int32 SubobjectIndex = 0;
-	for (const TSubclassOf<UActorComponent>& CompClassRef : ComponentClasses)
-	{
-		UClass* CompClass = CompClassRef.Get();
-		if (!CompClass)
-		{
-			UE_LOG(LogZMMO, Warning,
-				TEXT("ZMMOPlayerState: ComponentClass null em ComponentClasses[%d]"),
-				SubobjectIndex);
-			++SubobjectIndex;
-			continue;
-		}
-		const FName CompName = MakeUniqueObjectName(this, CompClass,
-			FName(*FString::Printf(TEXT("ZMMOComp_%d_%s"), SubobjectIndex, *CompClass->GetName())));
-		// Overload runtime de CreateDefaultSubobject retorna UObject* (sem template) —
-		// precisa cast para UActorComponent.
-		UActorComponent* Comp = Cast<UActorComponent>(CreateDefaultSubobject(CompName, CompClass, CompClass,
-			/*bIsRequired*/ false, /*bIsTransient*/ false));
-		if (Comp)
-		{
-			UE_LOG(LogZMMO, Log,
-				TEXT("ZMMOPlayerState: componente registrado [%d] %s"),
-				SubobjectIndex, *CompClass->GetName());
-		}
-		else
-		{
-			UE_LOG(LogZMMO, Warning,
-				TEXT("ZMMOPlayerState: CreateDefaultSubobject falhou para %s"),
-				*CompClass->GetName());
-		}
-		++SubobjectIndex;
-	}
-}
-
-void AZMMOPlayerState::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
-{
-	Super::GetLifetimeReplicatedProps(OutLifetimeProps);
-	DOREPLIFETIME(AZMMOPlayerState, ZMMOEntityId);
-	DOREPLIFETIME(AZMMOPlayerState, CharId);
-	DOREPLIFETIME(AZMMOPlayerState, CharName);
-	DOREPLIFETIME(AZMMOPlayerState, BaseLevel);
-	DOREPLIFETIME(AZMMOPlayerState, ClassId);
-	DOREPLIFETIME(AZMMOPlayerState, GuildName);
-}
-
-void AZMMOPlayerState::SetPublicIdentity(int64 InEntityId, const FString& InCharId,
-                                          int32 InBaseLevel, int32 InClassId)
-{
-	ZMMOEntityId = InEntityId;
-	CharId = InCharId;
-	BaseLevel = InBaseLevel;
-	ClassId = InClassId;
-}
-
-void AZMMOPlayerState::SetCharInfo(const FString& InCharName, const FString& InGuildName)
-{
-	CharName = InCharName;
-	GuildName = InGuildName;
-}

Source/ZMMO/Game/Modes/ZeusFrontEndGameMode.cpp

@@ -0,0 +1,10 @@
+#include "ZeusFrontEndGameMode.h"
+
+#include "ZeusFrontEndPlayerController.h"
+
+AZeusFrontEndGameMode::AZeusFrontEndGameMode()
+{
+	// UI pura: sem pawn. O controller cria o root layout e arranca o fluxo.
+	DefaultPawnClass = nullptr;
+	PlayerControllerClass = AZeusFrontEndPlayerController::StaticClass();
+}

Source/ZMMO/Game/Modes/ZeusFrontEndGameMode.h

@@ -2,21 +2,21 @@
 
 #include "CoreMinimal.h"
 #include "GameFramework/GameModeBase.h"
-#include "ZMMOFrontEndGameMode.generated.h"
+#include "ZeusFrontEndGameMode.generated.h"
 
 /**
- *  AZMMOFrontEndGameMode
+ *  AZeusFrontEndGameMode
  *
  *  GameMode do mapa de front-end (L_FrontEnd): só UI, sem pawn nem network
- *  play. NÃO é o GameMode global (esse continua AZMMOGameMode para mapas de
+ *  play. NÃO é o GameMode global (esse continua AZeusGameMode para mapas de
  *  mundo) — aplicado via override no World Settings de L_FrontEnd
  *  (ARQUITETURA.md §3.3 / decisão de mapa dedicado).
  */
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API AZMMOFrontEndGameMode : public AGameModeBase
+class ZMMO_API AZeusFrontEndGameMode : public AGameModeBase
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOFrontEndGameMode();
+	AZeusFrontEndGameMode();
 };

Source/ZMMO/Game/Modes/ZeusGameInstance.cpp

@@ -1,13 +1,13 @@
-#include "ZMMOGameInstance.h"
+#include "ZeusGameInstance.h"
 
 #include "ZMMO.h"
 #include "ZeusNetworkSubsystem.h"
 
-void UZMMOGameInstance::Init()
+void UZeusGameInstance::Init()
 {
 	Super::Init();
 
-	UE_LOG(LogZMMO, Log, TEXT("ZMMOGameInstance::Init AutoConnect=%s Host=%s Port=%d"),
+	UE_LOG(LogZMMO, Log, TEXT("ZeusGameInstance::Init AutoConnect=%s Host=%s Port=%d"),
 		bAutoConnectOnStart ? TEXT("true") : TEXT("false"),
 		*ZeusServerHost,
 		ZeusServerPort);
@@ -15,7 +15,7 @@ void UZMMOGameInstance::Init()
 	UZeusNetworkSubsystem* ZeusNet = GetZeusNetwork();
 	if (!ZeusNet)
 	{
-		UE_LOG(LogZMMO, Warning, TEXT("ZMMOGameInstance: ZeusNetworkSubsystem unavailable; ZeusNetwork plugin enabled?"));
+		UE_LOG(LogZMMO, Warning, TEXT("ZeusGameInstance: ZeusNetworkSubsystem unavailable; ZeusNetwork plugin enabled?"));
 		return;
 	}
 
@@ -29,7 +29,7 @@ void UZMMOGameInstance::Init()
 	ZeusNet->ConnectToZeusServer(ZeusServerHost, ZeusServerPort);
 }
 
-void UZMMOGameInstance::Shutdown()
+void UZeusGameInstance::Shutdown()
 {
 	if (UZeusNetworkSubsystem* ZeusNet = GetZeusNetwork())
 	{
@@ -43,55 +43,55 @@ void UZMMOGameInstance::Shutdown()
 	Super::Shutdown();
 }
 
-UZeusNetworkSubsystem* UZMMOGameInstance::GetZeusNetwork() const
+UZeusNetworkSubsystem* UZeusGameInstance::GetZeusNetwork() const
 {
 	return GetSubsystem<UZeusNetworkSubsystem>();
 }
 
-void UZMMOGameInstance::BindZeusDelegates(UZeusNetworkSubsystem* Zeus)
+void UZeusGameInstance::BindZeusDelegates(UZeusNetworkSubsystem* Zeus)
 {
 	if (!Zeus)
 	{
 		return;
 	}
-	Zeus->OnConnected.AddDynamic(this, &UZMMOGameInstance::HandleZeusConnected);
-	Zeus->OnConnectionFailed.AddDynamic(this, &UZMMOGameInstance::HandleZeusConnectionFailed);
-	Zeus->OnDisconnected.AddDynamic(this, &UZMMOGameInstance::HandleZeusDisconnected);
+	Zeus->OnConnected.AddDynamic(this, &UZeusGameInstance::HandleZeusConnected);
+	Zeus->OnConnectionFailed.AddDynamic(this, &UZeusGameInstance::HandleZeusConnectionFailed);
+	Zeus->OnDisconnected.AddDynamic(this, &UZeusGameInstance::HandleZeusDisconnected);
 	// OnNetworkLog: NAO assinamos. Plugin ja loga em LogZeusNetwork (console)
 	// + arquivo proprio em Saved/Logs/ZeusNetwork/. Forwarding em LogZMMO era
 	// diagnostico inicial (sessao 2026-05-07); agora gera duplicacao de cada
 	// linha. Remova esta nota e descomente abaixo se quiser ver no LogZMMO:
-	// Zeus->OnNetworkLog.AddDynamic(this, &UZMMOGameInstance::HandleZeusNetworkLog);
+	// Zeus->OnNetworkLog.AddDynamic(this, &UZeusGameInstance::HandleZeusNetworkLog);
 }
 
-void UZMMOGameInstance::UnbindZeusDelegates(UZeusNetworkSubsystem* Zeus)
+void UZeusGameInstance::UnbindZeusDelegates(UZeusNetworkSubsystem* Zeus)
 {
 	if (!Zeus)
 	{
 		return;
 	}
-	Zeus->OnConnected.RemoveDynamic(this, &UZMMOGameInstance::HandleZeusConnected);
-	Zeus->OnConnectionFailed.RemoveDynamic(this, &UZMMOGameInstance::HandleZeusConnectionFailed);
-	Zeus->OnDisconnected.RemoveDynamic(this, &UZMMOGameInstance::HandleZeusDisconnected);
+	Zeus->OnConnected.RemoveDynamic(this, &UZeusGameInstance::HandleZeusConnected);
+	Zeus->OnConnectionFailed.RemoveDynamic(this, &UZeusGameInstance::HandleZeusConnectionFailed);
+	Zeus->OnDisconnected.RemoveDynamic(this, &UZeusGameInstance::HandleZeusDisconnected);
 	// OnNetworkLog: nao foi assinado (ver BindZeusDelegates) — nada a remover.
 }
 
-void UZMMOGameInstance::HandleZeusConnected()
+void UZeusGameInstance::HandleZeusConnected()
 {
 	UE_LOG(LogZMMO, Log, TEXT("[Zeus] Connected to server %s:%d"), *ZeusServerHost, ZeusServerPort);
 }
 
-void UZMMOGameInstance::HandleZeusConnectionFailed(FString Reason)
+void UZeusGameInstance::HandleZeusConnectionFailed(FString Reason)
 {
 	UE_LOG(LogZMMO, Warning, TEXT("[Zeus] Connection failed: %s"), *Reason);
 }
 
-void UZMMOGameInstance::HandleZeusDisconnected()
+void UZeusGameInstance::HandleZeusDisconnected()
 {
 	UE_LOG(LogZMMO, Log, TEXT("[Zeus] Disconnected."));
 }
 
-void UZMMOGameInstance::HandleZeusNetworkLog(FString Message)
+void UZeusGameInstance::HandleZeusNetworkLog(FString Message)
 {
 	UE_LOG(LogZMMO, Log, TEXT("[Zeus] %s"), *Message);
 }

Source/ZMMO/Game/Modes/ZeusGameInstance.h

@@ -2,12 +2,12 @@
 
 #include "CoreMinimal.h"
 #include "Engine/GameInstance.h"
-#include "ZMMOGameInstance.generated.h"
+#include "ZeusGameInstance.generated.h"
 
 class UZeusNetworkSubsystem;
 
 /**
- *  UZMMOGameInstance
+ *  UZeusGameInstance
  *
  *  Game instance do cliente Zeus MMO. O `UZeusNetworkSubsystem` (do plugin
  *  `ZeusNetwork`) e um `UGameInstanceSubsystem` e portanto e criado
@@ -22,7 +22,7 @@ class UZeusNetworkSubsystem;
  *  overrides de configuracao por build (dev / staging / prod).
  */
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API UZMMOGameInstance : public UGameInstance
+class ZMMO_API UZeusGameInstance : public UGameInstance
 {
 	GENERATED_BODY()
 
@@ -36,20 +36,20 @@ public:
 	 *  dirigida pelo `UUIFrontEndFlowSubsystem` (fluxo Boot→Connecting→Login).
 	 *  Pôr `true` apenas para smoke test legado sem front-end.
 	 */
-	UPROPERTY(EditAnywhere, BlueprintReadWrite, Config, Category = "ZMMO|Network")
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Config, Category = "Zeus|Network")
 	bool bAutoConnectOnStart = false;
 
 	/** Host (IPv4 ou hostname) do servidor Zeus. */
-	UPROPERTY(EditAnywhere, BlueprintReadWrite, Config, Category = "ZMMO|Network")
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Config, Category = "Zeus|Network")
 	FString ZeusServerHost = TEXT("127.0.0.1");
 
 	/** Porta UDP do servidor Zeus (1..65535). */
-	UPROPERTY(EditAnywhere, BlueprintReadWrite, Config, Category = "ZMMO|Network", meta = (ClampMin = "1", ClampMax = "65535"))
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Config, Category = "Zeus|Network", meta = (ClampMin = "1", ClampMax = "65535"))
 	int32 ZeusServerPort = 27777;
 
 protected:
 	/** Devolve o subsystem Zeus desta game instance (criado automaticamente pelo plugin). */
-	UFUNCTION(BlueprintPure, Category = "ZMMO|Network")
+	UFUNCTION(BlueprintPure, Category = "Zeus|Network")
 	UZeusNetworkSubsystem* GetZeusNetwork() const;
 
 	void BindZeusDelegates(UZeusNetworkSubsystem* Zeus);

Source/ZMMO/Game/Modes/ZeusGameMode.cpp

@@ -0,0 +1,14 @@
+#include "ZeusGameMode.h"
+
+#include "ZeusHUD.h"
+#include "ZeusCharacter.h"
+#include "ZeusPlayerController.h"
+#include "ZeusPlayerState.h"
+
+AZeusGameMode::AZeusGameMode()
+{
+	DefaultPawnClass = AZeusCharacter::StaticClass();
+	PlayerControllerClass = AZeusPlayerController::StaticClass();
+	PlayerStateClass = AZeusPlayerState::StaticClass();
+	HUDClass = AZeusHUD::StaticClass();
+}

Source/ZMMO/Game/Modes/ZeusGameMode.h

@@ -2,24 +2,24 @@
 
 #include "CoreMinimal.h"
 #include "GameFramework/GameModeBase.h"
-#include "ZMMOGameMode.generated.h"
+#include "ZeusGameMode.generated.h"
 
 /**
- *  AZMMOGameMode
+ *  AZeusGameMode
  *
- *  Game mode do cliente Zeus MMO. Configura `AZMMOPlayerCharacter` como
- *  `DefaultPawnClass` e `AZMMOPlayerController` como `PlayerControllerClass`.
+ *  Game mode do cliente Zeus MMO. Configura `AZeusCharacter` como
+ *  `DefaultPawnClass` e `AZeusPlayerController` como `PlayerControllerClass`.
  *
  *  A classe e instanciavel directamente (apontada por
- *  `GlobalDefaultGameMode=/Script/ZMMO.ZMMOGameMode` em
+ *  `GlobalDefaultGameMode=/Script/ZMMO.ZeusGameMode` em
  *  `Config/DefaultEngine.ini`); um BP filho e opcional para overrides
  *  por mapa / build (skeletal mesh, AnimBP custom, etc.).
  */
 UCLASS(Blueprintable, BlueprintType)
-class ZMMO_API AZMMOGameMode : public AGameModeBase
+class ZMMO_API AZeusGameMode : public AGameModeBase
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOGameMode();
+	AZeusGameMode();
 };

Source/ZMMO/Game/Modes/ZeusHUD.cpp

@@ -1,16 +1,16 @@
-#include "ZMMOHUD.h"
+#include "ZeusHUD.h"
 
 #include "Engine/GameInstance.h"
 #include "ZMMO.h"
 #include "UI/InGame/UIInGameFlowSubsystem.h"
 
-AZMMOHUD::AZMMOHUD()
+AZeusHUD::AZeusHUD()
 {
 	// AHUD nao precisa tick — toda atualizacao vem via UMG (delegates +
 	// CommonUI). PrimaryActorTick default e' off; mantemos.
 }
 
-void AZMMOHUD::BeginPlay()
+void AZeusHUD::BeginPlay()
 {
 	Super::BeginPlay();
 
@@ -25,12 +25,12 @@ void AZMMOHUD::BeginPlay()
 		else
 		{
 			UE_LOG(LogZMMO, Warning,
-				TEXT("AZMMOHUD: UUIInGameFlowSubsystem nao encontrado — HUD nao sera spawnado"));
+				TEXT("AZeusHUD: UUIInGameFlowSubsystem nao encontrado — HUD nao sera spawnado"));
 		}
 	}
 }
 
-void AZMMOHUD::EndPlay(const EEndPlayReason::Type EndPlayReason)
+void AZeusHUD::EndPlay(const EEndPlayReason::Type EndPlayReason)
 {
 	// UUIInGameFlowSubsystem persiste no GameInstance entre OpenLevel — nao
 	// limpamos UI in-game aqui (o front-end flow vai tomar conta na proxima

Source/ZMMO/Game/Modes/ZeusHUD.h

@@ -2,7 +2,7 @@
 
 #include "CoreMinimal.h"
 #include "GameFramework/HUD.h"
-#include "ZMMOHUD.generated.h"
+#include "ZeusHUD.generated.h"
 
 /**
  *  HUD do MMO. Pattern UE5 idiomatico: o GameMode atribui `HUDClass`, o
@@ -14,21 +14,21 @@
  *  subsystem cuida do cleanup.
  *
  *  Separacao de responsabilidades:
- *   - AZMMOPlayerCharacter (Pawn) — movimento, input, AttributeComponent
- *   - AZMMOPlayerController       — input mapping, mouse
- *   - AZMMOHUD                    — UI lifecycle
- *   - AZMMOGameMode               — wires tudo via class slots
+ *   - AZeusCharacter (Pawn)        — movimento, input, AttributeComponent
+ *   - AZeusPlayerController        — input mapping, mouse
+ *   - AZeusHUD                     — UI lifecycle
+ *   - AZeusGameMode                — wires tudo via class slots
  *
  *  NAO desenha nada via canvas (AHUD::DrawHUD). UI inteira vive em UMG +
  *  CommonUI (UI.Layer.Game / GameMenu / Modal).
  */
 UCLASS()
-class ZMMO_API AZMMOHUD : public AHUD
+class ZMMO_API AZeusHUD : public AHUD
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOHUD();
+	AZeusHUD();
 
 protected:
 	virtual void BeginPlay() override;

Source/ZMMO/Game/Modes/ZeusPlayerState.cpp

@@ -0,0 +1,133 @@
+#include "ZeusPlayerState.h"
+
+#include "AbilitySystemComponent.h"
+#include "Components/ActorComponent.h"
+#include "Misc/ConfigCacheIni.h"
+#include "Net/UnrealNetwork.h"
+#include "ZMMO.h"
+#include "ZeusAbilitySystemComponent.h"
+#include "ZeusAttributeSet.h"
+#include "ZeusGASComponent.h"
+
+AZeusPlayerState::AZeusPlayerState()
+{
+	// Component Registry: instancia cada classe declarada em
+	// DefaultGame.ini::[/Script/ZMMO.ZeusPlayerState]+ComponentClasses=...
+	//
+	// Le manualmente via GConfig para evitar timing do UPROPERTY(Config),
+	// que requer LoadConfig() ja ter rodado no CDO antes da instance ser
+	// construida. Pra propriedades em arrays config com `+` syntax, lendo
+	// direto e mais previsivel.
+	if (ComponentClasses.Num() == 0 && GConfig)
+	{
+		TArray<FString> ClassPaths;
+		GConfig->GetArray(TEXT("/Script/ZMMO.ZeusPlayerState"),
+		                  TEXT("ComponentClasses"),
+		                  ClassPaths,
+		                  GGameIni);
+		for (const FString& Path : ClassPaths)
+		{
+			if (UClass* C = LoadClass<UActorComponent>(nullptr, *Path))
+			{
+				ComponentClasses.Add(C);
+			}
+			else
+			{
+				UE_LOG(LogZMMO, Warning,
+					TEXT("ZeusPlayerState: ComponentClasses path nao resolveu: %s"), *Path);
+			}
+		}
+	}
+
+	UE_LOG(LogZMMO, Log,
+		TEXT("AZeusPlayerState ctor: %d componente(s) no registry (instance=%s)"),
+		ComponentClasses.Num(), *GetName());
+
+	int32 SubobjectIndex = 0;
+	for (const TSubclassOf<UActorComponent>& CompClassRef : ComponentClasses)
+	{
+		UClass* CompClass = CompClassRef.Get();
+		if (!CompClass)
+		{
+			UE_LOG(LogZMMO, Warning,
+				TEXT("ZeusPlayerState: ComponentClass null em ComponentClasses[%d]"),
+				SubobjectIndex);
+			++SubobjectIndex;
+			continue;
+		}
+		const FName CompName = MakeUniqueObjectName(this, CompClass,
+			FName(*FString::Printf(TEXT("ZeusComp_%d_%s"), SubobjectIndex, *CompClass->GetName())));
+		// Overload runtime de CreateDefaultSubobject retorna UObject* (sem template) —
+		// precisa cast para UActorComponent.
+		UActorComponent* Comp = Cast<UActorComponent>(CreateDefaultSubobject(CompName, CompClass, CompClass,
+			/*bIsRequired*/ false, /*bIsTransient*/ false));
+		if (Comp)
+		{
+			UE_LOG(LogZMMO, Log,
+				TEXT("ZeusPlayerState: componente registrado [%d] %s"),
+				SubobjectIndex, *CompClass->GetName());
+		}
+		else
+		{
+			UE_LOG(LogZMMO, Warning,
+				TEXT("ZeusPlayerState: CreateDefaultSubobject falhou para %s"),
+				*CompClass->GetName());
+		}
+		++SubobjectIndex;
+	}
+}
+
+void AZeusPlayerState::GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const
+{
+	Super::GetLifetimeReplicatedProps(OutLifetimeProps);
+	DOREPLIFETIME(AZeusPlayerState, ZeusEntityId);
+	DOREPLIFETIME(AZeusPlayerState, CharId);
+	DOREPLIFETIME(AZeusPlayerState, CharName);
+	DOREPLIFETIME(AZeusPlayerState, BaseLevel);
+	DOREPLIFETIME(AZeusPlayerState, ClassId);
+	DOREPLIFETIME(AZeusPlayerState, GuildName);
+}
+
+void AZeusPlayerState::SetPublicIdentity(int64 InEntityId, const FString& InCharId,
+                                          int32 InBaseLevel, int32 InClassId)
+{
+	ZeusEntityId = InEntityId;
+	CharId = InCharId;
+	BaseLevel = InBaseLevel;
+	ClassId = InClassId;
+}
+
+void AZeusPlayerState::SetCharInfo(const FString& InCharName, const FString& InGuildName)
+{
+	CharName = InCharName;
+	GuildName = InGuildName;
+}
+
+UAbilitySystemComponent* AZeusPlayerState::GetAbilitySystemComponent() const
+{
+	// ASC vive como subobject do UZeusGASComponent (que esta no Component
+	// Registry). UE5 GAS nodes BP ("Get Ability System Component", "Apply
+	// Gameplay Effect To Target", etc.) chamam isto via IAbilitySystemInterface.
+	// O retorno e o ponteiro upcastado pra UAbilitySystemComponent (base) —
+	// mas em runtime e' UZeusAbilitySystemComponent (cast tipado via
+	// GetZeusAbilitySystemComponent abaixo).
+	return GetZeusAbilitySystemComponent();
+}
+
+UZeusAbilitySystemComponent* AZeusPlayerState::GetZeusAbilitySystemComponent() const
+{
+	if (UZeusGASComponent* GAS = GetZeusComponent<UZeusGASComponent>())
+	{
+		return GAS->AbilitySystemComponent.Get();
+	}
+	return nullptr;
+}
+
+UZeusAttributeSet* AZeusPlayerState::GetZeusAttributeSet() const
+{
+	if (UZeusGASComponent* GAS = GetZeusComponent<UZeusGASComponent>())
+	{
+		return GAS->AttributeSet.Get();
+	}
+	return nullptr;
+}

Source/ZMMO/Game/Modes/ZeusPlayerState.h

@@ -1,12 +1,15 @@
 #pragma once
 
+#include "AbilitySystemInterface.h"
 #include "CoreMinimal.h"
 #include "GameFramework/PlayerState.h"
 #include "Templates/SubclassOf.h"
-#include "ZMMOPlayerState.generated.h"
+#include "ZeusPlayerState.generated.h"
 
 class FLifetimeProperty;
 class UActorComponent;
+class UZeusAbilitySystemComponent;
+class UZeusAttributeSet;
 
 /**
  *  PlayerState do MMO. Pattern UE5 idiomatico: o GameMode atribui
@@ -28,29 +31,52 @@ class UActorComponent;
  *
  *  ## Component Registry (Open-Closed)
  *
- *  Cada modulo (ZMMOAttributes, ZMMOInventory, ZMMOSkills futuros) declara
+ *  Cada modulo (ZeusGAS, ZeusInventory, ZeusSkills futuros) declara
  *  sua component class em DefaultGame.ini:
  *
- *      [/Script/ZMMO.ZMMOPlayerState]
- *      +ComponentClasses=/Script/ZMMOAttributes.ZMMOAttributeComponent
- *      +ComponentClasses=/Script/ZMMOInventory.ZMMOInventoryComponent
- *      +ComponentClasses=/Script/ZMMOSkills.ZMMOSkillComponent
+ *      [/Script/ZMMO.ZeusPlayerState]
+ *      +ComponentClasses=/Script/ZeusGAS.ZeusGASComponent
+ *      +ComponentClasses=/Script/ZeusInventory.ZeusInventoryComponent
+ *      +ComponentClasses=/Script/ZeusSkills.ZeusSkillComponent
  *
- *  O construtor de AZMMOPlayerState le essa lista (Config) e instancia
+ *  O construtor de AZeusPlayerState le essa lista (Config) e instancia
  *  cada classe como subobject. PlayerState fica fechado pra modificacao,
  *  modulos abertos pra extensao — adicionar Inventory NAO requer
- *  recompilar/editar AZMMOPlayerState.
+ *  recompilar/editar AZeusPlayerState.
  *
- *  Acesso: `PlayerState->FindComponentByClass<UZMMOAttributeComponent>()`
- *  ou o helper `GetZMMOComponent<T>()`.
+ *  Acesso: `PlayerState->FindComponentByClass<UZeusGASComponent>()`
+ *  ou o helper `GetZeusComponent<T>()`.
  */
 UCLASS(Config = Game, BlueprintType)
-class ZMMO_API AZMMOPlayerState : public APlayerState
+class ZMMO_API AZeusPlayerState : public APlayerState, public IAbilitySystemInterface
 {
 	GENERATED_BODY()
 
 public:
-	AZMMOPlayerState();
+	AZeusPlayerState();
+
+	// === IAbilitySystemInterface (UE5 GAS) ===
+	//
+	// Padrao Lyra: PlayerState implementa a interface; o ASC vive como
+	// subobject do UZeusGASComponent (Component Registry). Isso permite que
+	// qualquer Actor que receba este PlayerState resolva o ASC via cast
+	// pra IAbilitySystemInterface OU via node BP "Get Ability System
+	// Component" (que faz o mesmo internamente).
+	//
+	// Acesso BP: "Get Ability System Component" + pin do PlayerState.
+	// Acesso C++: `Cast<IAbilitySystemInterface>(PlayerState)->GetAbilitySystemComponent()`.
+	virtual UAbilitySystemComponent* GetAbilitySystemComponent() const override;
+
+	/// Versao tipada do ASC custom — retorna direto UZeusAbilitySystemComponent
+	/// (os 12 overrides que falam com o servidor custom via opcodes ZeusNetwork).
+	/// Prefira este sobre o getter da interface no BP — evita cast + expoe a API
+	/// do ASC custom (RequestActivateAbility, etc.).
+	UFUNCTION(BlueprintPure, Category = "Zeus|GAS")
+	UZeusAbilitySystemComponent* GetZeusAbilitySystemComponent() const;
+
+	/// Helper BP-friendly pro AttributeSet tipado (template C++ nao expoe pra BP).
+	UFUNCTION(BlueprintPure, Category = "Zeus|GAS")
+	UZeusAttributeSet* GetZeusAttributeSet() const;
 
 	// === Identidade publica ===
 	//
@@ -60,51 +86,51 @@ public:
 	// passe a usar dedicated UE5 no futuro.
 
 	/** EntityId autoritativo do server. 0 ate o spawn local confirmar. */
-	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Identity")
-	int64 ZMMOEntityId = 0;
+	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Identity")
+	int64 ZeusEntityId = 0;
 
 	/** CharId (BIGINT no DB; FString pra preservar 64 bits em Blueprint). */
-	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Identity")
+	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Identity")
 	FString CharId;
 
 	/** Nome do char vindo do DB (`characters.name`). Setado por
-	 *  AZMMOPlayerCharacter::HandleLocalSpawnReady com o payload do
+	 *  AZeusCharacter::HandleLocalSpawnReady com o payload do
 	 *  S_SPAWN_PLAYER. UI prefere isto a APlayerState::GetPlayerName(). */
-	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Identity")
+	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Identity")
 	FString CharName;
 
 	// === Progressao publica ===
 
-	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Progress")
+	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Progress")
 	int32 BaseLevel = 1;
 
-	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Progress")
+	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Progress")
 	int32 ClassId = 0;
 
 	// === Guild (futuro) ===
 
-	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "ZMMO|Guild")
+	UPROPERTY(Replicated, VisibleInstanceOnly, BlueprintReadOnly, Category = "Zeus|Guild")
 	FString GuildName;
 
 	virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;
 
 	// === Helpers ===
 
-	/// Setado por AZMMOPlayerCharacter::HandleLocalSpawnReady (pose/EntityId)
+	/// Setado por AZeusCharacter::HandleLocalSpawnReady (pose/EntityId)
 	/// e atualizado por handlers de snapshot/level up para refletir dados
 	/// publicos do char no PlayerState.
-	UFUNCTION(BlueprintCallable, Category = "ZMMO|Identity")
+	UFUNCTION(BlueprintCallable, Category = "Zeus|Identity")
 	void SetPublicIdentity(int64 InEntityId, const FString& InCharId,
 	                       int32 InBaseLevel, int32 InClassId);
 
 	/// Setado pelo handler do S_CHAR_INFO (chega antes de S_SPAWN_PLAYER) —
 	/// metadados publicos do char vindos do servidor.
-	UFUNCTION(BlueprintCallable, Category = "ZMMO|Identity")
+	UFUNCTION(BlueprintCallable, Category = "Zeus|Identity")
 	void SetCharInfo(const FString& InCharName, const FString& InGuildName);
 
-	/// Template helper: PS->GetZMMOComponent<UZMMOAttributeComponent>()
+	/// Template helper: PS->GetZeusComponent<UZeusGASComponent>()
 	template <typename T>
-	T* GetZMMOComponent() const
+	T* GetZeusComponent() const
 	{
 		return Cast<T>(FindComponentByClass(T::StaticClass()));
 	}
@@ -119,6 +145,6 @@ protected:
 	 *  diretamente. Modulos C++ precisam estar carregados antes do CDO ser
 	 *  instanciado — garantido por LoadingPhase=PreDefault no .uproject.
 	 */
-	UPROPERTY(Config, EditDefaultsOnly, Category = "ZMMO|Components")
+	UPROPERTY(Config, EditDefaultsOnly, Category = "Zeus|Components")
 	TArray<TSubclassOf<UActorComponent>> ComponentClasses;
 };

Source/ZMMO/Game/Network/ZMMOWorldSubsystem.cpp

@@ -1,309 +0,0 @@
-#include "ZMMOWorldSubsystem.h"
-
-#include "Engine/GameInstance.h"
-#include "Engine/World.h"
-#include "ZMMO.h"
-#include "ZMMOEntity.h"
-#include "ZMMOEntityInterface.h"
-#include "ZMMOPlayerProxy.h"
-#include "ZeusNetworkSubsystem.h"
-
-void UZMMOWorldSubsystem::Initialize(FSubsystemCollectionBase& Collection)
-{
-	Super::Initialize(Collection);
-
-	if (RemoteEntityClasses.IsEmpty())
-	{
-		RemoteEntityClasses.Add(EZMMOEntityType::Player, AZMMOPlayerProxy::StaticClass());
-		RemoteEntityClasses.Add(EZMMOEntityType::Mob, AZMMOEntity::StaticClass());
-		RemoteEntityClasses.Add(EZMMOEntityType::NPC, AZMMOEntity::StaticClass());
-		RemoteEntityClasses.Add(EZMMOEntityType::Object, AZMMOEntity::StaticClass());
-	}
-	// Bind + replay vivem em OnWorldBeginPlay (mundo pronto). Initialize roda
-	// MUITO cedo no pipeline de LoadMap — antes do GameMode ser instanciado
-	// e antes do WorldPartition terminar de carregar cells. Spawns dinamicos
-	// feitos aqui podem ser perdidos durante a fase de setup posterior.
-}
-
-void UZMMOWorldSubsystem::OnWorldBeginPlay(UWorld& InWorld)
-{
-	Super::OnWorldBeginPlay(InWorld);
-
-	if (UZeusNetworkSubsystem* ZeusNet = ResolveZeusNetworkSubsystem())
-	{
-		ZeusNet->OnPlayerSpawned.AddDynamic(this, &UZMMOWorldSubsystem::HandlePlayerSpawned);
-		ZeusNet->OnPlayerDespawned.AddDynamic(this, &UZMMOWorldSubsystem::HandlePlayerDespawned);
-		ZeusNet->OnPlayerStateUpdate.AddDynamic(this, &UZMMOWorldSubsystem::HandlePlayerStateUpdate);
-		UE_LOG(LogZMMO, Log, TEXT("ZMMOWorldSubsystem bound to ZeusNetworkSubsystem delegates."));
-
-		// Catch-up race fix (Fase 3): broadcasts de proxies remotos chegam
-		// enquanto o cliente novo ainda esta em OpenLevel. UZeusNetworkSubsystem
-		// cacheia em PendingRemoteSpawnsByEntity. Aplicamos aqui — mundo ja
-		// esta pronto (GameMode ativo, WorldPartition cells inicializadas).
-		int32 ReplayCount = 0;
-		ZeusNet->ForEachPendingRemoteSpawn(
-			[this, &ReplayCount](const int64 EntityId, const FVector PosCm, const float YawDeg, const int64 ServerTimeMs)
-			{
-				HandlePlayerSpawned(EntityId, /*bIsLocal=*/false, PosCm, YawDeg, ServerTimeMs);
-				++ReplayCount;
-			});
-		if (ReplayCount > 0)
-		{
-			UE_LOG(LogZMMO, Log, TEXT("ZMMOWorldSubsystem: replay de %d proxy(ies) cacheados."), ReplayCount);
-		}
-	}
-	else
-	{
-		UE_LOG(LogZMMO, Warning, TEXT("ZMMOWorldSubsystem: ZeusNetworkSubsystem not found at OnWorldBeginPlay."));
-	}
-}
-
-void UZMMOWorldSubsystem::Deinitialize()
-{
-	if (UZeusNetworkSubsystem* ZeusNet = ResolveZeusNetworkSubsystem())
-	{
-		ZeusNet->OnPlayerSpawned.RemoveDynamic(this, &UZMMOWorldSubsystem::HandlePlayerSpawned);
-		ZeusNet->OnPlayerDespawned.RemoveDynamic(this, &UZMMOWorldSubsystem::HandlePlayerDespawned);
-		ZeusNet->OnPlayerStateUpdate.RemoveDynamic(this, &UZMMOWorldSubsystem::HandlePlayerStateUpdate);
-	}
-
-	RemoteEntities.Reset();
-	LocalEntityId = 0;
-	Super::Deinitialize();
-}
-
-void UZMMOWorldSubsystem::RegisterLocalEntity(const int64 EntityId, AActor* LocalActor)
-{
-	if (EntityId == 0 || LocalActor == nullptr)
-	{
-		return;
-	}
-
-	LocalEntityId = EntityId;
-	RemoteEntities.Add(EntityId, TWeakObjectPtr<AActor>(LocalActor));
-	UE_LOG(LogZMMO, Log, TEXT("ZMMOWorldSubsystem: local entity registered EntityId=%lld actor=%s"),
-		EntityId, *GetNameSafe(LocalActor));
-}
-
-void UZMMOWorldSubsystem::HandlePlayerSpawned(const int64 EntityId, const bool bIsLocal,
-	const FVector PosCm, const float YawDeg, const int64 ServerTimeMs)
-{
-	if (EntityId == 0)
-	{
-		return;
-	}
-
-	if (bIsLocal)
-	{
-		// O proprio AZMMOPlayerCharacter cuida da sua identidade quando recebe o
-		// delegate por outro caminho. Aqui apenas memorizamos para filtrar
-		// snapshots locais (cliente solto, sem reconciliacao em V0).
-		LocalEntityId = EntityId;
-		return;
-	}
-
-	if (RemoteEntities.Contains(EntityId))
-	{
-		// Ja existe um proxy: tenta reactivar e re-snap. Se o weak ptr ficou
-		// stale (actor coletado pelo GC, stream-out do World Partition, etc.),
-		// remove a entry orfa e cai no caminho de spawn novo — evita SPAWN
-		// silenciosamente ignorado depois de oscilacoes na AOI.
-		if (AActor* Existing = RemoteEntities[EntityId].Get())
-		{
-			if (IZMMOEntityInterface* AsEntity = Cast<IZMMOEntityInterface>(Existing))
-			{
-				AsEntity->SetEntityRelevant(true);
-			}
-			Existing->SetActorLocationAndRotation(PosCm, FRotator(0.0f, YawDeg, 0.0f));
-			UE_LOG(LogZMMO, Verbose, TEXT("ZMMOWorldSubsystem: re-snap EntityId=%d"), EntityId);
-			return;
-		}
-		// weak ptr stale — limpa entry e cai pro spawn novo abaixo.
-		RemoteEntities.Remove(EntityId);
-		UE_LOG(LogZMMO, Log, TEXT("ZMMOWorldSubsystem: stale entry para EntityId=%d, respawnando"), EntityId);
-	}
-
-	UWorld* World = GetWorld();
-	if (!World)
-	{
-		return;
-	}
-
-	UClass* ProxyClass = ResolveActorClass(EZMMOEntityType::Player);
-	if (!ProxyClass)
-	{
-		UE_LOG(LogZMMO, Warning, TEXT("ZMMOWorldSubsystem: no class registered for Player; spawn aborted."));
-		return;
-	}
-
-	FActorSpawnParameters Params;
-	Params.SpawnCollisionHandlingOverride = ESpawnActorCollisionHandlingMethod::AlwaysSpawn;
-	const FRotator SpawnRot(0.0f, YawDeg, 0.0f);
-	AActor* SpawnedActor = World->SpawnActor<AActor>(ProxyClass, PosCm, SpawnRot, Params);
-	if (!SpawnedActor)
-	{
-		UE_LOG(LogZMMO, Warning, TEXT("ZMMOWorldSubsystem: SpawnActor failed for EntityId=%d"), EntityId);
-		return;
-	}
-
-	if (IZMMOEntityInterface* AsEntity = Cast<IZMMOEntityInterface>(SpawnedActor))
-	{
-		// Inject identity via dedicated setter when the spawned actor exposes one.
-		if (AZMMOPlayerProxy* Proxy = Cast<AZMMOPlayerProxy>(SpawnedActor))
-		{
-			Proxy->SetZMMOIdentity(EntityId, EZMMOEntityType::Player);
-		}
-		else if (AZMMOEntity* Entity = Cast<AZMMOEntity>(SpawnedActor))
-		{
-			Entity->SetZMMOIdentity(EntityId, EZMMOEntityType::Player);
-		}
-		AsEntity->SetEntityRelevant(true);
-	}
-
-	RemoteEntities.Add(EntityId, TWeakObjectPtr<AActor>(SpawnedActor));
-	UE_LOG(LogZMMO, Log, TEXT("ZMMOWorldSubsystem: spawned remote EntityId=%d at (%s) yaw=%.1f t=%lld"),
-		EntityId, *PosCm.ToString(), YawDeg, ServerTimeMs);
-}
-
-void UZMMOWorldSubsystem::HandlePlayerDespawned(const int64 EntityId)
-{
-	const TWeakObjectPtr<AActor>* Entry = RemoteEntities.Find(EntityId);
-	if (!Entry)
-	{
-		return;
-	}
-
-	// Destruir o actor pra valer + remover do mapa. Antes, despawn apenas
-	// fazia SetActorHiddenInGame(true) via SetEntityRelevant(false), o que
-	// deixava o entry no mapa apontando pra um actor escondido. SPAWN
-	// subsequente do mesmo entityId era detectado como "duplicate" e nada
-	// acontecia — pawn ficava invisivel ate' o weak ptr ser GC'd. Bug
-	// confirmado nos logs do AOI ao oscilar entrada/saida da ZI/ZD.
-	if (AActor* Actor = Entry->Get())
-	{
-		if (IZMMOEntityInterface* AsEntity = Cast<IZMMOEntityInterface>(Actor))
-		{
-			AsEntity->SetEntityRelevant(false);
-		}
-		Actor->Destroy();
-	}
-	RemoteEntities.Remove(EntityId);
-
-	UE_LOG(LogZMMO, Log, TEXT("ZMMOWorldSubsystem: despawn EntityId=%d (destroyed)"), EntityId);
-}
-
-void UZMMOWorldSubsystem::HandlePlayerStateUpdate(const int64 EntityId, const int32 InputSeq,
-	const FVector PosCm, const FVector VelCmS, const bool bGrounded, const int64 ServerTimeMs)
-{
-	if (EntityId == 0)
-	{
-		return;
-	}
-
-	if (LocalEntityId != 0 && static_cast<int64>(EntityId) == LocalEntityId)
-	{
-		// Cliente local solto: ignoramos snapshots autoritativos para o nosso
-		// proprio personagem em V0 (ADR 0038). Reconciliacao opcional pode ser
-		// activada por flag em `AZMMOPlayerCharacter` quando colisao de objetos
-		// chegar.
-		return;
-	}
-
-	const TWeakObjectPtr<AActor>* Entry = RemoteEntities.Find(EntityId);
-	if (!Entry)
-	{
-		// Snapshot antes de spawn: o spawn vira em `OnPlayerSpawned` em breve.
-		return;
-	}
-
-	AActor* Actor = Entry->Get();
-	if (!Actor)
-	{
-		RemoteEntities.Remove(EntityId);
-		return;
-	}
-
-	IZMMOEntityInterface* AsEntity = Cast<IZMMOEntityInterface>(Actor);
-	if (!AsEntity)
-	{
-		return;
-	}
-
-	FZMMOEntitySnapshot Snapshot;
-	Snapshot.EntityId = EntityId;
-	Snapshot.EntityType = AsEntity->GetZMMOEntityType();
-	Snapshot.LastProcessedInputSeq = InputSeq;
-	Snapshot.PositionCm = PosCm;
-	Snapshot.VelocityCmS = VelCmS;
-
-	// Etapa 7 (server-side networking refactor): yaw agora chega no
-	// snapshot quantizado v3. Buscamos via TryGetLastPlayerStateExtended
-	// (cache local do plugin). Se PSF_HasYaw nao estiver set ou se o cache
-	// nao tiver entrada, caimos no fallback antigo (derivar do XY da
-	// velocidade ou manter rotacao do ator).
-	bool bYawFromSnapshot = false;
-	if (UZeusNetworkSubsystem* ZeusNet = ResolveZeusNetworkSubsystem())
-	{
-		int32 CachedInputSeq = 0;
-		FVector CachedPos = FVector::ZeroVector;
-		FVector CachedVel = FVector::ZeroVector;
-		float CachedYawDeg = 0.f;
-		int32 CachedFlags = 0;
-		int64 CachedServerTimeMs = 0;
-		if (ZeusNet->TryGetLastPlayerStateExtended(
-				EntityId, CachedInputSeq, CachedPos, CachedVel,
-				CachedYawDeg, CachedFlags, CachedServerTimeMs))
-		{
-			constexpr int32 PSF_HasYaw = 1 << 5;
-			if ((CachedFlags & PSF_HasYaw) != 0)
-			{
-				Snapshot.YawDeg = CachedYawDeg;
-				bYawFromSnapshot = true;
-			}
-		}
-	}
-	if (!bYawFromSnapshot)
-	{
-		// Fallback: deriva yaw do XY da velocidade quando significativo;
-		// caso contrario mantem rotacao do ator (comportamento pre-Etapa 7).
-		if (!FVector(VelCmS.X, VelCmS.Y, 0.0f).IsNearlyZero(1.0f))
-		{
-			Snapshot.YawDeg = FMath::RadiansToDegrees(FMath::Atan2(VelCmS.Y, VelCmS.X));
-		}
-		else
-		{
-			Snapshot.YawDeg = Actor->GetActorRotation().Yaw;
-		}
-	}
-	Snapshot.bGrounded = bGrounded;
-	Snapshot.ServerTimeMs = ServerTimeMs;
-
-	AsEntity->ApplyEntitySnapshot(Snapshot);
-}
-
-UClass* UZMMOWorldSubsystem::ResolveActorClass(const EZMMOEntityType EntityType) const
-{
-	if (const TSubclassOf<AActor>* Found = RemoteEntityClasses.Find(EntityType))
-	{
-		if (Found->Get())
-		{
-			return Found->Get();
-		}
-	}
-	return AZMMOEntity::StaticClass();
-}
-
-UZeusNetworkSubsystem* UZMMOWorldSubsystem::ResolveZeusNetworkSubsystem() const
-{
-	const UWorld* World = GetWorld();
-	if (!World)
-	{
-		return nullptr;
-	}
-	UGameInstance* GI = World->GetGameInstance();
-	if (!GI)
-	{
-		return nullptr;
-	}
-	return GI->GetSubsystem<UZeusNetworkSubsystem>();
-}

Source/ZMMO/Game/Network/ZeusAOIComponent.cpp

@@ -0,0 +1,346 @@
+// Copyright Zeus Server Engine. All rights reserved.
+
+#include "ZeusAOIComponent.h"
+
+#include "ZeusNetworkingClientSubsystem.h" // V1 canonico: OnDebugAoiInfo (6161) + EmitDebugAoiRequest (6160)
+#include "ZeusFrontierOverlayActor.h"      // ator que desenha as paredes de fronteira
+#include "ZMMONetLog.h"           // Batch 2.5: LogZeusAOI (categoria do modulo ZMMO)
+
+#include "DrawDebugHelpers.h"
+#include "Engine/GameInstance.h"
+#include "Engine/World.h"
+#include "GameFramework/Actor.h"
+
+// Console vars — espelham as flags do painel (overlay liga se flag OU CVar).
+static TAutoConsoleVariable<int32> CVarShowAOI(
+	TEXT("zeus.debug.aoi"), 0, TEXT("Desenha a Zona de Interesse (esfera do raio AOI)."), ECVF_Default);
+static TAutoConsoleVariable<int32> CVarShowDespawn(
+	TEXT("zeus.debug.despawn"), 0, TEXT("Desenha a Zona de Despawn (esfera externa do AOI)."), ECVF_Default);
+static TAutoConsoleVariable<int32> CVarShowCell(
+	TEXT("zeus.debug.cell"), 0, TEXT("Desenha os bounds da celula (placeholder)."), ECVF_Default);
+static TAutoConsoleVariable<int32> CVarShowProxy(
+	TEXT("zeus.debug.proxy"), 0, TEXT("Desenha labels de proxy (TODO)."), ECVF_Default);
+static TAutoConsoleVariable<int32> CVarShowHandoff(
+	TEXT("zeus.debug.handoff"), 0, TEXT("Desenha a linha de handoff (placeholder)."), ECVF_Default);
+static TAutoConsoleVariable<int32> CVarShowDrift(
+	TEXT("zeus.debug.drift"), 0, TEXT("Desenha o drift autoritativo (TODO)."), ECVF_Default);
+static TAutoConsoleVariable<int32> CVarShowFrontier(
+	TEXT("zeus.debug.frontier"), 0, TEXT("Desenha as paredes das fronteiras do mesh (own<->neighbor)."), ECVF_Default);
+
+namespace
+{
+	const FColor kColorInterest(93, 213, 255);  // cyan — Zona de Interesse
+	const FColor kColorDespawn(255, 140, 90);   // laranja — Zona de Despawn (externa)
+	const FColor kColorCell(232, 192, 96);
+	const FColor kColorHandoff(255, 155, 190);
+
+	// Resolucao das esferas de overlay. 32 segments deixavam a "bolha" facetada
+	// (poucas linhas) num raio de 60-80m; 48 deixa o circulo bem mais denso/legivel.
+	constexpr int32 kSphereSegments = 48;
+	// Clamp visual defensivo: se o raio vier absurdo (config corrompida), nao desenha
+	// uma esfera gigante que engole o mapa. 500m cobre qualquer AOI real (max=800m,
+	// mas overlay > 500m ja' nao ajuda a leitura). So' afeta o desenho, nao o gameplay.
+	constexpr float kMaxOverlayRadiusCm = 50000.0f;
+}
+
+UZeusAOIComponent::UZeusAOIComponent()
+{
+	PrimaryComponentTick.bCanEverTick = true;
+	PrimaryComponentTick.bStartWithTickEnabled = true;
+	SetIsReplicatedByDefault(false); // debug/cliente; gameplay AOI real entra depois
+}
+
+void UZeusAOIComponent::BeginPlay()
+{
+	Super::BeginPlay();
+
+	// Bind do feed de config de AOI (servidor -> cliente) pelo transporte V1
+	// canonico. O legacy (UZeusNetworkSubsystem) esta desativado no V1 -> usava
+	// SendDebugAoiRequest que logava "ignorado: nao conectado" e o overlay nunca
+	// recebia a config. Agora via UZeusNetworkingClientSubsystem (OnDebugAoiInfo 6161).
+	if (UWorld* World = GetWorld())
+	{
+		if (UGameInstance* GI = World->GetGameInstance())
+		{
+			if (UZeusNetworkingClientSubsystem* NetC = GI->GetSubsystem<UZeusNetworkingClientSubsystem>())
+			{
+				AoiConfigHandle_ = NetC->OnDebugAoiInfo.AddUObject(this, &UZeusAOIComponent::HandleAoiConfig);
+					FrontierConfigHandle_ = NetC->OnDebugFrontierInfo.AddUObject(this, &UZeusAOIComponent::HandleFrontierConfig);
+			}
+		}
+	}
+
+	// Best-effort: ja' pede a config (no-op se ainda nao conectado — o request
+	// e' re-disparado ao ligar um overlay em SetOverlayEnabled).
+	RequestAoiConfig();
+}
+
+void UZeusAOIComponent::EndPlay(const EEndPlayReason::Type EndPlayReason)
+{
+	if (AoiConfigHandle_.IsValid() || FrontierConfigHandle_.IsValid())
+	{
+		if (UWorld* World = GetWorld())
+		{
+			if (UGameInstance* GI = World->GetGameInstance())
+			{
+				if (UZeusNetworkingClientSubsystem* NetC = GI->GetSubsystem<UZeusNetworkingClientSubsystem>())
+				{
+					if (AoiConfigHandle_.IsValid())      { NetC->OnDebugAoiInfo.Remove(AoiConfigHandle_); }
+					if (FrontierConfigHandle_.IsValid()) { NetC->OnDebugFrontierInfo.Remove(FrontierConfigHandle_); }
+				}
+			}
+		}
+		AoiConfigHandle_.Reset();
+		FrontierConfigHandle_.Reset();
+	}
+	if (FrontierActor_)
+	{
+		FrontierActor_->Destroy();
+		FrontierActor_ = nullptr;
+	}
+	Super::EndPlay(EndPlayReason);
+}
+
+void UZeusAOIComponent::TickComponent(float DeltaTime, ELevelTick TickType,
+                                      FActorComponentTickFunction* ThisTickFunction)
+{
+	Super::TickComponent(DeltaTime, TickType, ThisTickFunction);
+
+	// Frontier: sincroniza o overlay com o estado atual. Pega o liga/desliga via
+	// CVar zeus.debug.frontier (que nao passa por SetOverlayEnabled) e garante que
+	// ao desligar as paredes sejam REMOVIDAS (UpdateFrontierOverlay -> ClearOverlay).
+	if (ResolveOverlay(EZeusAOIOverlay::FrontierCells) != bFrontierApplied_)
+	{
+		UpdateFrontierOverlay();
+	}
+
+	// Re-pede o frontier periodicamente enquanto ligado -> o overlay reflete
+	// split/merge da topologia dinamica (debug client-side, baixa freq, so' ON).
+	if (ResolveOverlay(EZeusAOIOverlay::FrontierCells))
+	{
+		FrontierRepollAccumSec_ += DeltaTime;
+		if (FrontierRepollAccumSec_ >= FrontierRepollIntervalSec)
+		{
+			FrontierRepollAccumSec_ = 0.0f;
+			RequestFrontierConfig();
+		}
+	}
+
+	if (AnyOverlayActive())
+	{
+		DrawOverlays();
+	}
+}
+
+void UZeusAOIComponent::RequestAoiConfig()
+{
+	if (UWorld* World = GetWorld())
+	{
+		if (UGameInstance* GI = World->GetGameInstance())
+		{
+			if (UZeusNetworkingClientSubsystem* NetC = GI->GetSubsystem<UZeusNetworkingClientSubsystem>())
+			{
+				NetC->EmitDebugAoiRequest(); // V1: no-op se ainda nao Accepted
+			}
+		}
+	}
+}
+
+void UZeusAOIComponent::HandleAoiConfig(float InterestCm, float DespawnCm)
+{
+	InterestRadiusCm = InterestCm;
+	DespawnRadiusCm  = DespawnCm;
+	// K4: log AOI cfg recebido do server (paridade com Net.AOI server-side
+	// "config_applied ZI=... ZD=..."). Cold path (1 por sessao).
+	UE_LOG(LogZeusAOI, Display,
+		TEXT("AOI cfg recv interestCm=%.0f (%.0fm) despawnCm=%.0f (%.0fm)"),
+		InterestCm, InterestCm / 100.0f,
+		DespawnCm, DespawnCm / 100.0f);
+}
+
+void UZeusAOIComponent::RequestFrontierConfig()
+{
+	if (UWorld* World = GetWorld())
+	{
+		if (UGameInstance* GI = World->GetGameInstance())
+		{
+			if (UZeusNetworkingClientSubsystem* NetC = GI->GetSubsystem<UZeusNetworkingClientSubsystem>())
+			{
+				NetC->EmitDebugFrontierRequest(); // V1: no-op se ainda nao Accepted
+			}
+		}
+	}
+}
+
+void UZeusAOIComponent::HandleFrontierConfig(const ZeusV1::FDebugFrontierInfo& Info)
+{
+	FrontierInfo_ = Info;
+	bFrontierReceived_ = true;
+	UE_LOG(LogZeusAOI, Display,
+		TEXT("Frontier cfg recv own=%d neighbors=%d"),
+		Info.OwnedCells.Num(), Info.NeighborCells.Num());
+	UpdateFrontierOverlay();
+}
+
+AZeusFrontierOverlayActor* UZeusAOIComponent::EnsureFrontierActor()
+{
+	if (FrontierActor_) { return FrontierActor_; }
+	UWorld* World = GetWorld();
+	if (!World) { return nullptr; }
+	FActorSpawnParameters Params;
+	Params.Owner = GetOwner();
+	Params.SpawnCollisionHandlingOverride = ESpawnActorCollisionHandlingMethod::AlwaysSpawn;
+	FrontierActor_ = World->SpawnActor<AZeusFrontierOverlayActor>(
+		AZeusFrontierOverlayActor::StaticClass(), FVector::ZeroVector, FRotator::ZeroRotator, Params);
+	return FrontierActor_;
+}
+
+void UZeusAOIComponent::UpdateFrontierOverlay()
+{
+	const bool bOn = ResolveOverlay(EZeusAOIOverlay::FrontierCells);
+	bFrontierApplied_ = bOn;
+	if (!bOn)
+	{
+		if (FrontierActor_) { FrontierActor_->ClearOverlay(); }
+		return;
+	}
+	if (!bFrontierReceived_)
+	{
+		// Ainda nao temos as cells; pede e espera o 6163 (HandleFrontierConfig re-chama).
+		RequestFrontierConfig();
+		return;
+	}
+	AZeusFrontierOverlayActor* Actor = EnsureFrontierActor();
+	if (!Actor) { return; }
+	const float AnchorZ = GetOwner() ? GetOwner()->GetActorLocation().Z : 0.0f;
+	Actor->RebuildFromFrontier(FrontierInfo_, AnchorZ);
+}
+
+bool UZeusAOIComponent::ResolveOverlay(EZeusAOIOverlay Overlay) const
+{
+	switch (Overlay)
+	{
+	case EZeusAOIOverlay::AOIRadius:   return bShowAOIRadius    || CVarShowAOI.GetValueOnGameThread()     > 0;
+	case EZeusAOIOverlay::DespawnZone: return bShowDespawnZone  || CVarShowDespawn.GetValueOnGameThread() > 0;
+	case EZeusAOIOverlay::CellBounds:  return bShowCellBounds   || CVarShowCell.GetValueOnGameThread()    > 0;
+	case EZeusAOIOverlay::ProxyLabels: return bShowProxyLabels  || CVarShowProxy.GetValueOnGameThread()   > 0;
+	case EZeusAOIOverlay::HandoffLine: return bShowHandoffLine  || CVarShowHandoff.GetValueOnGameThread() > 0;
+	case EZeusAOIOverlay::AuthDrift:   return bShowAuthDrift    || CVarShowDrift.GetValueOnGameThread()   > 0;
+	case EZeusAOIOverlay::FrontierCells: return bShowFrontier  || CVarShowFrontier.GetValueOnGameThread() > 0;
+	default: return false;
+	}
+}
+
+bool UZeusAOIComponent::AnyOverlayActive() const
+{
+	return ResolveOverlay(EZeusAOIOverlay::AOIRadius)
+		|| ResolveOverlay(EZeusAOIOverlay::DespawnZone)
+		|| ResolveOverlay(EZeusAOIOverlay::CellBounds)
+		|| ResolveOverlay(EZeusAOIOverlay::ProxyLabels)
+		|| ResolveOverlay(EZeusAOIOverlay::HandoffLine)
+		|| ResolveOverlay(EZeusAOIOverlay::AuthDrift)
+		|| ResolveOverlay(EZeusAOIOverlay::FrontierCells);
+}
+
+void UZeusAOIComponent::DrawOverlays()
+{
+	const AActor* Owner = GetOwner();
+	UWorld* World = GetWorld();
+	if (!Owner || !World) { return; }
+
+	const FVector Loc = Owner->GetActorLocation();
+
+	// Zona de Interesse (interna) — raio real do servidor. Sem o raio (==0),
+	// ainda nao chegou a config: nao desenha (loading).
+	if (ResolveOverlay(EZeusAOIOverlay::AOIRadius) && InterestRadiusCm > 0.0f)
+	{
+		const float R = FMath::Min(InterestRadiusCm, kMaxOverlayRadiusCm);
+		DrawDebugSphere(World, Loc, R, kSphereSegments, kColorInterest, false, -1.0f, 0, LineThickness);
+	}
+	// Zona de Despawn (externa, > interesse = histerese) — raio real do servidor.
+	if (ResolveOverlay(EZeusAOIOverlay::DespawnZone) && DespawnRadiusCm > 0.0f)
+	{
+		const float R = FMath::Min(DespawnRadiusCm, kMaxOverlayRadiusCm);
+		DrawDebugSphere(World, Loc, R, kSphereSegments, kColorDespawn, false, -1.0f, 0, LineThickness);
+	}
+	if (ResolveOverlay(EZeusAOIOverlay::CellBounds))
+	{
+		// PLACEHOLDER: box grande centrada no player. TODO bounds reais da cell.
+		DrawDebugBox(World, Loc, FVector(CellBoundsExtentCm, CellBoundsExtentCm, 2000.0f),
+			kColorCell, false, -1.0f, 0, LineThickness);
+	}
+	if (ResolveOverlay(EZeusAOIOverlay::HandoffLine))
+	{
+		// PLACEHOLDER: vetor pra frente. TODO apontar pro centro da cell vizinha.
+		const float Len = InterestRadiusCm > 0.0f ? InterestRadiusCm : 3000.0f;
+		const FVector End = Loc + Owner->GetActorForwardVector() * Len;
+		DrawDebugDirectionalArrow(World, Loc, End, 200.0f, kColorHandoff, false, -1.0f, 0, LineThickness);
+	}
+	// ProxyLabels / AuthDrift: TODO (precisam do registry de proxies/snapshots).
+}
+
+void UZeusAOIComponent::SetOverlayEnabled_Implementation(EZeusAOIOverlay Overlay, bool bEnabled)
+{
+	switch (Overlay)
+	{
+	case EZeusAOIOverlay::AOIRadius:   bShowAOIRadius   = bEnabled; break;
+	case EZeusAOIOverlay::DespawnZone: bShowDespawnZone = bEnabled; break;
+	case EZeusAOIOverlay::CellBounds:  bShowCellBounds  = bEnabled; break;
+	case EZeusAOIOverlay::ProxyLabels: bShowProxyLabels = bEnabled; break;
+	case EZeusAOIOverlay::HandoffLine: bShowHandoffLine = bEnabled; break;
+	case EZeusAOIOverlay::AuthDrift:   bShowAuthDrift   = bEnabled; break;
+	case EZeusAOIOverlay::FrontierCells: bShowFrontier  = bEnabled; break;
+	default: break;
+	}
+
+	// Ao ligar uma zona de AOI sem ter os raios ainda, pede a config (loading).
+	const bool bAoiZone = (Overlay == EZeusAOIOverlay::AOIRadius || Overlay == EZeusAOIOverlay::DespawnZone);
+	if (bEnabled && bAoiZone && InterestRadiusCm <= 0.0f)
+	{
+		RequestAoiConfig();
+	}
+
+	// Frontier: ao ligar pede as cells (6162) e reconstroi; ao desligar limpa as paredes.
+	if (Overlay == EZeusAOIOverlay::FrontierCells)
+	{
+		if (bEnabled) { RequestFrontierConfig(); }
+		UpdateFrontierOverlay();
+	}
+}
+
+void UZeusAOIComponent::SetAllOverlays_Implementation(bool bEnabled)
+{
+	bShowAOIRadius = bShowDespawnZone = bShowCellBounds = bEnabled;
+	bShowProxyLabels = bShowHandoffLine = bShowAuthDrift = bEnabled;
+	bShowFrontier = bEnabled;
+
+	if (bEnabled && InterestRadiusCm <= 0.0f)
+	{
+		RequestAoiConfig();
+	}
+	if (bEnabled) { RequestFrontierConfig(); }
+	UpdateFrontierOverlay();
+}
+
+bool UZeusAOIComponent::IsOverlayEnabled_Implementation(EZeusAOIOverlay Overlay) const
+{
+	// Reflete o estado real (flag OU CVar) p/ a UI mostrar o que esta' desenhando.
+	return ResolveOverlay(Overlay);
+}
+
+float UZeusAOIComponent::GetInterestRadiusCm_Implementation() const
+{
+	return InterestRadiusCm; // 0 = config do servidor ainda nao chegou (loading)
+}
+
+float UZeusAOIComponent::GetDespawnRadiusCm_Implementation() const
+{
+	return DespawnRadiusCm;
+}
+
+int32 UZeusAOIComponent::GetEnabledOverlayCount() const
+{
+	return (bShowAOIRadius ? 1 : 0) + (bShowDespawnZone ? 1 : 0) + (bShowCellBounds ? 1 : 0)
+		+ (bShowProxyLabels ? 1 : 0) + (bShowHandoffLine ? 1 : 0) + (bShowAuthDrift ? 1 : 0)
+		+ (bShowFrontier ? 1 : 0);
+}

Source/ZMMO/Game/Network/ZeusAOIComponent.h

@@ -0,0 +1,111 @@
+// Copyright Zeus Server Engine. All rights reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Components/ActorComponent.h"
+#include "ZeusAOIDebugTarget.h" // plugin ZeusAdminToolsRuntime: interface + EZeusAOIOverlay
+#include "ZeusV1Protocol.h"     // ZeusV1::FDebugFrontierInfo (overlay de fronteira)
+#include "ZeusAOIComponent.generated.h"
+
+class AZeusFrontierOverlayActor;
+
+/**
+ *  UZeusAOIComponent (cliente / jogo)
+ *
+ *  Componente de gameplay do player local. Dominio principal: Area of Interest
+ *  do cliente (proxies, despawn coordenado, interpolacao — ver
+ *  [[project_aoi_client_component]]). AQUI, alem disso, expoe um "plus" de
+ *  DEBUG: overlays via DrawDebug* dirigidos pelo painel admin (plugin) atraves
+ *  de IZeusAOIDebugTarget, e/ou por console vars (zeus.debug.aoi etc.).
+ *
+ *  As DUAS zonas do AOI (Interesse interna + Despawn externa = histerese) vem do
+ *  SERVIDOR: ao ligar um overlay (ou no BeginPlay) o componente pede a config via
+ *  C_DEBUG_AOI_REQUEST e recebe S_DEBUG_AOI_INFO (delegate OnDebugAoiInfo do
+ *  UZeusNetworkSubsystem) com interestRadiusCm + despawnRadiusCm. Enquanto nao
+ *  chega (raio == 0), nao desenha (loading).
+ *
+ *  Vive na src do ZMMO (nao no plugin): e' um componente do JOGO. O plugin
+ *  ZeusAdminTools apenas COMUNICA com ele via a interface — direcao da
+ *  dependencia: ZMMO -> plugin (implementa a interface).
+ */
+UCLASS(ClassGroup = (Zeus), meta = (BlueprintSpawnableComponent), DisplayName = "Zeus AOI Component")
+class ZMMO_API UZeusAOIComponent : public UActorComponent, public IZeusAOIDebugTarget
+{
+	GENERATED_BODY()
+
+public:
+	UZeusAOIComponent();
+
+	virtual void BeginPlay() override;
+	virtual void EndPlay(const EEndPlayReason::Type EndPlayReason) override;
+	virtual void TickComponent(float DeltaTime, ELevelTick TickType,
+	                           FActorComponentTickFunction* ThisTickFunction) override;
+
+	// === IZeusAOIDebugTarget (dirigido pelo painel admin) ===
+	virtual void SetOverlayEnabled_Implementation(EZeusAOIOverlay Overlay, bool bEnabled) override;
+	virtual void SetAllOverlays_Implementation(bool bEnabled) override;
+	virtual bool IsOverlayEnabled_Implementation(EZeusAOIOverlay Overlay) const override;
+	virtual float GetInterestRadiusCm_Implementation() const override;
+	virtual float GetDespawnRadiusCm_Implementation() const override;
+
+	// === Flags de debug por overlay ===
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Overlays") bool bShowAOIRadius = false;    // Zona de Interesse
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Overlays") bool bShowDespawnZone = false;  // Zona de Despawn
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Overlays") bool bShowCellBounds = false;
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Overlays") bool bShowProxyLabels = false;
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Overlays") bool bShowHandoffLine = false;
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Overlays") bool bShowAuthDrift = false;
+	// Fronteiras do mesh: paredes own<->neighbor com label "Cell <id>", renderizadas
+	// por AZeusFrontierOverlayActor a partir do DEBUG_FRONTIER_INFO (6163).
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Overlays") bool bShowFrontier = false;
+
+	// === Parametros ===
+	// Raios reais vem do servidor (S_DEBUG_AOI_INFO). 0 = ainda nao recebido (loading).
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Zeus|AOI Debug|Params") float InterestRadiusCm = 0.0f;
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Zeus|AOI Debug|Params") float DespawnRadiusCm = 0.0f;
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Params") float CellBoundsExtentCm = 50000.0f;
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Zeus|AOI Debug|Params") float LineThickness = 2.0f;
+
+	UFUNCTION(BlueprintPure, Category = "Zeus|AOI Debug")
+	int32 GetEnabledOverlayCount() const;
+
+private:
+	void DrawOverlays();
+	bool ResolveOverlay(EZeusAOIOverlay Overlay) const;
+	bool AnyOverlayActive() const;
+
+	/** Pede a config de AOI ao servidor (C_DEBUG_AOI_REQUEST). No-op se ja' temos
+	 *  os raios ou se nao houver UZeusNetworkSubsystem conectado. */
+	void RequestAoiConfig();
+
+	/** Bind de UZeusNetworkSubsystem::OnDebugAoiInfo: armazena os raios reais. */
+	void HandleAoiConfig(float InterestCm, float DespawnCm);
+
+	/** Pede o frontier do mesh ao servidor (DEBUG_FRONTIER_REQUEST 6162). */
+	void RequestFrontierConfig();
+	/** Bind de OnDebugFrontierInfo: guarda as cells e (se overlay on) reconstroi as paredes. */
+	void HandleFrontierConfig(const ZeusV1::FDebugFrontierInfo& Info);
+	/** Spawna (lazy) o ator que desenha as paredes + labels. */
+	AZeusFrontierOverlayActor* EnsureFrontierActor();
+	/** Liga / reconstroi / limpa o overlay de fronteira conforme bShowFrontier + dados. */
+	void UpdateFrontierOverlay();
+
+	/** Handle do bind do OnDebugAoiInfo (pra remover no EndPlay). */
+	FDelegateHandle AoiConfigHandle_;
+
+	/** Handle do bind do OnDebugFrontierInfo (frontier overlay). */
+	FDelegateHandle FrontierConfigHandle_;
+	/** Ultimo frontier recebido do server (own cells + neighbors). */
+	ZeusV1::FDebugFrontierInfo FrontierInfo_;
+	bool bFrontierReceived_ = false;
+	/** Estado do overlay JA aplicado (paredes desenhadas). O TickComponent compara
+	 *  com ResolveOverlay p/ pegar liga/desliga via CVar tambem (nao so' o toggle). */
+	bool bFrontierApplied_ = false;
+	/** Re-poll periodico do frontier enquanto ligado -> overlay reflete split/merge
+	 *  da topologia dinamica (o 6163 traz o estado atual do topology:current). */
+	float FrontierRepollIntervalSec = 2.0f;
+	float FrontierRepollAccumSec_ = 0.0f;
+	/** Ator que desenha as paredes + labels (spawn lazy ao ligar o overlay). */
+	UPROPERTY() TObjectPtr<AZeusFrontierOverlayActor> FrontierActor_ = nullptr;
+};

Source/ZMMO/Game/Network/ZeusFrontierOverlayActor.cpp

@@ -0,0 +1,205 @@
+// Copyright Zeus Server Engine. All rights reserved.
+
+#include "ZeusFrontierOverlayActor.h"
+
+#include "ZMMONetLog.h" // LogZeusAOI (categoria do modulo ZMMO)
+
+#include "ProceduralMeshComponent.h"
+#include "Materials/MaterialInterface.h"
+#include "Engine/World.h"
+#include "DrawDebugHelpers.h"
+#include "UObject/ConstructorHelpers.h"
+
+namespace
+{
+	const TCHAR* kWallMaterialPath =
+		TEXT("/Game/ZMMO/Materials/VFX/Portal/GridBoundary/Instancia/MI_VFX_Portal_GridBoundary_01.MI_VFX_Portal_GridBoundary_01");
+
+	const FColor kLabelAlive(93, 213, 255); // ciano  -- server online
+	const FColor kLabelDead(255, 90, 90);   // vermelho -- server offline / cell vazia
+
+	// Offset do cellId de filha de split (espelha CHILD_CELLID_OFFSET do server).
+	constexpr uint32 kChildCellIdOffset = 1000000u;
+
+	// Decodifica o cellId int na notacao de quadtree: raiz -> "0".."3"; filha ->
+	// "<pai>,<quadrante>" (ex "0,2"); neto -> "0,2,1" (recursivo). Espelha
+	// childCellId = offset + pai*4 + quadrante do SplitCoordinator.
+	FString DecodeCellPath(uint32 CellId)
+	{
+		if (CellId < kChildCellIdOffset)
+		{
+			return FString::Printf(TEXT("%u"), CellId);
+		}
+		const uint32 Rel = CellId - kChildCellIdOffset;
+		return DecodeCellPath(Rel / 4u) + FString::Printf(TEXT(",%u"), Rel % 4u);
+	}
+
+	// Aresta compartilhada entre dois retangulos axis-aligned (no plano XY).
+	bool SharedEdge(float aMinX, float aMinY, float aMaxX, float aMaxY,
+	                float bMinX, float bMinY, float bMaxX, float bMaxY,
+	                float Eps, FVector2D& OutA, FVector2D& OutB)
+	{
+		const float yLo = FMath::Max(aMinY, bMinY), yHi = FMath::Min(aMaxY, bMaxY);
+		const float xLo = FMath::Max(aMinX, bMinX), xHi = FMath::Min(aMaxX, bMaxX);
+
+		if (FMath::Abs(aMaxX - bMinX) <= Eps && yHi > yLo) { OutA = {aMaxX, yLo}; OutB = {aMaxX, yHi}; return true; }
+		if (FMath::Abs(aMinX - bMaxX) <= Eps && yHi > yLo) { OutA = {aMinX, yLo}; OutB = {aMinX, yHi}; return true; }
+		if (FMath::Abs(aMaxY - bMinY) <= Eps && xHi > xLo) { OutA = {xLo, aMaxY}; OutB = {xHi, aMaxY}; return true; }
+		if (FMath::Abs(aMinY - bMaxY) <= Eps && xHi > xLo) { OutA = {xLo, aMinY}; OutB = {xHi, aMinY}; return true; }
+		return false;
+	}
+}
+
+AZeusFrontierOverlayActor::AZeusFrontierOverlayActor()
+{
+	PrimaryActorTick.bCanEverTick = true;
+	PrimaryActorTick.bStartWithTickEnabled = true;
+
+	WallMesh = CreateDefaultSubobject<UProceduralMeshComponent>(TEXT("WallMesh"));
+	SetRootComponent(WallMesh);
+	WallMesh->bUseAsyncCooking = false;
+	WallMesh->SetCollisionEnabled(ECollisionEnabled::NoCollision);
+	WallMesh->SetCastShadow(false);
+
+	static ConstructorHelpers::FObjectFinder<UMaterialInterface> MatFinder(kWallMaterialPath);
+	if (MatFinder.Succeeded())
+	{
+		WallMaterial = MatFinder.Object;
+	}
+}
+
+void AZeusFrontierOverlayActor::RebuildFromFrontier(const ZeusV1::FDebugFrontierInfo& Info, float AnchorZCm)
+{
+	if (!WallMesh) { return; }
+	AnchorZ_ = AnchorZCm;
+
+	// 1) Junta own + neighbors numa lista unica de cells (grid inteiro). Dedup por cellId.
+	Cells_.Reset();
+	auto AddCell = [this](uint32 CellId, int32 MinX, int32 MinY, int32 MaxX, int32 MaxY,
+	                      const FString& InOwner, bool bIsDead)
+	{
+		for (const FCellView& Ex : Cells_) { if (Ex.CellId == CellId) { return; } }
+		FCellView V;
+		V.CellId = CellId;
+		V.MinX = static_cast<float>(MinX); V.MinY = static_cast<float>(MinY);
+		V.MaxX = static_cast<float>(MaxX); V.MaxY = static_cast<float>(MaxY);
+		V.Owner = InOwner; V.bDead = bIsDead;
+		Cells_.Add(MoveTemp(V));
+	};
+	for (const ZeusV1::FFrontierOwnCell& C : Info.OwnedCells)
+	{
+		AddCell(C.CellId, C.MinXCm, C.MinYCm, C.MaxXCm, C.MaxYCm, C.OwnerName, false);
+	}
+	for (const ZeusV1::FFrontierNeighborCell& Nb : Info.NeighborCells)
+	{
+		AddCell(Nb.CellId, Nb.MinXCm, Nb.MinYCm, Nb.MaxXCm, Nb.MaxYCm, Nb.OwnerName, Nb.bDead);
+	}
+
+	// 2) Paredes: 1 quad por aresta compartilhada entre QUALQUER par (i<j -> dedup).
+	const float BaseZ = AnchorZCm - WallHeightCm * 0.5f;
+	const float TopZ  = AnchorZCm + WallHeightCm * 0.5f;
+
+	TArray<FVector> Verts;
+	TArray<int32> Tris;
+	TArray<FVector> Normals;
+	TArray<FVector2D> UVs;
+	TArray<FProcMeshTangent> Tangents;
+	TArray<FLinearColor> Colors;
+
+	for (int32 i = 0; i < Cells_.Num(); ++i)
+	{
+		for (int32 j = i + 1; j < Cells_.Num(); ++j)
+		{
+			const FCellView& A = Cells_[i];
+			const FCellView& B = Cells_[j];
+			FVector2D P0, P1;
+			if (!SharedEdge(A.MinX, A.MinY, A.MaxX, A.MaxY,
+			                B.MinX, B.MinY, B.MaxX, B.MaxY, EdgeEpsilonCm, P0, P1))
+			{
+				continue;
+			}
+
+			const int32 Base = Verts.Num();
+			Verts.Add(FVector(P0.X, P0.Y, BaseZ));
+			Verts.Add(FVector(P1.X, P1.Y, BaseZ));
+			Verts.Add(FVector(P1.X, P1.Y, TopZ));
+			Verts.Add(FVector(P0.X, P0.Y, TopZ));
+
+			const FVector2D Dir2D = (P1 - P0).GetSafeNormal();
+			const FVector N(-Dir2D.Y, Dir2D.X, 0.f);
+			Normals.Add(N); Normals.Add(N); Normals.Add(N); Normals.Add(N);
+
+			UVs.Add(FVector2D(0.f, 1.f));
+			UVs.Add(FVector2D(1.f, 1.f));
+			UVs.Add(FVector2D(1.f, 0.f));
+			UVs.Add(FVector2D(0.f, 0.f));
+
+			const FProcMeshTangent Tan(FVector(Dir2D.X, Dir2D.Y, 0.f), false);
+			Tangents.Add(Tan); Tangents.Add(Tan); Tangents.Add(Tan); Tangents.Add(Tan);
+
+			const FLinearColor C = (A.bDead || B.bDead) ? FLinearColor(kLabelDead) : FLinearColor(kLabelAlive);
+			Colors.Add(C); Colors.Add(C); Colors.Add(C); Colors.Add(C);
+
+			Tris.Add(Base + 0); Tris.Add(Base + 1); Tris.Add(Base + 2);
+			Tris.Add(Base + 0); Tris.Add(Base + 2); Tris.Add(Base + 3);
+			Tris.Add(Base + 0); Tris.Add(Base + 2); Tris.Add(Base + 1);
+			Tris.Add(Base + 0); Tris.Add(Base + 3); Tris.Add(Base + 2);
+		}
+	}
+
+	WallMesh->ClearAllMeshSections();
+	WallMesh->SetVisibility(true);
+	if (Verts.Num() > 0)
+	{
+		WallMesh->CreateMeshSection_LinearColor(
+			/*SectionIndex=*/0, Verts, Tris, Normals, UVs, Colors, Tangents, /*bCreateCollision=*/false);
+		if (WallMaterial) { WallMesh->SetMaterial(0, WallMaterial); }
+	}
+	bHasOverlay_ = (Cells_.Num() > 0);
+
+	UE_LOG(LogZeusAOI, Display,
+		TEXT("Frontier overlay rebuilt: cells=%d walls=%d anchorZ=%.0f%s"),
+		Cells_.Num(), Verts.Num() / 4, AnchorZCm,
+		WallMaterial ? TEXT("") : TEXT(" [WARN: material nula]"));
+}
+
+void AZeusFrontierOverlayActor::ClearOverlay()
+{
+	if (WallMesh)
+	{
+		WallMesh->ClearAllMeshSections();
+		WallMesh->SetVisibility(false);
+	}
+	Cells_.Reset();
+	bHasOverlay_ = false;
+}
+
+void AZeusFrontierOverlayActor::DrawCellLabels()
+{
+	if (!bHasOverlay_ || Cells_.Num() == 0) { return; }
+	UWorld* World = GetWorld();
+	if (!World) { return; }
+
+	for (const FCellView& C : Cells_)
+	{
+		const float Cx = (C.MinX + C.MaxX) * 0.5f;
+		const float Cy = (C.MinY + C.MaxY) * 0.5f;
+		const FVector Pos(Cx, Cy, AnchorZ_ + LabelHeightCm);
+
+		// "Cell 0" / "Cell 0,2" (notacao da quadtree) + nome do server dono.
+		FString Txt = FString::Printf(TEXT("Cell %s"), *DecodeCellPath(C.CellId));
+		if (!C.Owner.IsEmpty()) { Txt += TEXT("\n") + C.Owner; }
+		const FColor Col = C.bDead ? kLabelDead : kLabelAlive;
+
+		// DrawDebugString: billboard de tela (visivel de qualquer lado, nao gira,
+		// tamanho de tela constante). Re-desenhado a cada frame (Duration 0).
+		DrawDebugString(World, Pos, Txt, /*TestBaseActor=*/nullptr, Col,
+		                /*Duration=*/0.0f, /*bDrawShadow=*/true, LabelFontScale);
+	}
+}
+
+void AZeusFrontierOverlayActor::Tick(float DeltaSeconds)
+{
+	Super::Tick(DeltaSeconds);
+	DrawCellLabels();
+}

Source/ZMMO/Game/Network/ZeusFrontierOverlayActor.h

@@ -0,0 +1,70 @@
+// Copyright Zeus Server Engine. All rights reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameFramework/Actor.h"
+#include "ZeusV1Protocol.h" // ZeusV1::FDebugFrontierInfo (plugin ZeusNetwork)
+#include "ZeusFrontierOverlayActor.generated.h"
+
+class UProceduralMeshComponent;
+class UMaterialInterface;
+
+/**
+ *  AZeusFrontierOverlayActor (cliente / debug)
+ *
+ *  Desenha no MUNDO as "paredes" de TODAS as fronteiras do grid de server-meshing
+ *  (todas as arestas compartilhadas entre quaisquer duas cells, com dedup), usando
+ *  a material de portal MI_VFX_Portal_GridBoundary_01. As cells vem do
+ *  DEBUG_FRONTIER_INFO (6163), que reflete a topologia DINAMICA (split/merge).
+ *
+ *  Label: no CENTRO de cada cell, um texto via DrawDebugString (billboard de tela,
+ *  visivel de qualquer lado, nao gira). Mostra a notacao da cell:
+ *    raiz   -> "Cell 0", "Cell 1", ...
+ *    split  -> "Cell 0,0", "Cell 0,1", ... (pai,quadrante) -- reflete a quadtree.
+ *  + o nome do servidor dono. NAO e' replicado: visual no cliente local.
+ */
+UCLASS()
+class ZMMO_API AZeusFrontierOverlayActor : public AActor
+{
+	GENERATED_BODY()
+
+public:
+	AZeusFrontierOverlayActor();
+
+	virtual void Tick(float DeltaSeconds) override;
+
+	/** (Re)constroi as paredes do grid + guarda as cells pros labels.
+	 *  AnchorZCm ancora a altura das paredes/labels (tipicamente o Z do player). */
+	void RebuildFromFrontier(const ZeusV1::FDebugFrontierInfo& Info, float AnchorZCm);
+
+	/** Limpa a geometria (overlay desligado). */
+	void ClearOverlay();
+
+	// === Parametros das paredes ===
+	UPROPERTY(EditAnywhere, Category = "Zeus|Frontier") float WallHeightCm  = 12000.0f; // 120m
+	UPROPERTY(EditAnywhere, Category = "Zeus|Frontier") float EdgeEpsilonCm = 4.0f;     // tolerancia "compartilha aresta"
+
+	// === Label "Cell X,Y" no centro de cada cell (DrawDebugString) ===
+	UPROPERTY(EditAnywhere, Category = "Zeus|Frontier|Label") float LabelFontScale = 1.4f; // tamanho na tela (screen-space)
+	UPROPERTY(EditAnywhere, Category = "Zeus|Frontier|Label") float LabelHeightCm  = 250.0f; // altura do label acima do anchor
+
+private:
+	UPROPERTY() UProceduralMeshComponent* WallMesh = nullptr;
+	UPROPERTY() UMaterialInterface* WallMaterial = nullptr;
+
+	/// Snapshot leve das cells (own + neighbors) pros labels.
+	struct FCellView
+	{
+		uint32  CellId = 0;
+		float   MinX = 0.f, MinY = 0.f, MaxX = 0.f, MaxY = 0.f;
+		FString Owner;          // "Server1" (ou vazio)
+		bool    bDead = false;
+	};
+	TArray<FCellView> Cells_;
+	float AnchorZ_ = 0.0f;
+	bool  bHasOverlay_ = false;
+
+	/// Desenha "Cell X,Y\n<server>" no centro de cada cell (chamado no Tick).
+	void DrawCellLabels();
+};

Source/ZMMO/Game/Network/ZeusWorldSubsystem.cpp

@@ -0,0 +1,598 @@
+#include "ZeusWorldSubsystem.h"
+
+#include "Engine/GameInstance.h"
+#include "Engine/World.h"
+#include "GameFramework/GameStateBase.h"
+#include "ZMMO.h"
+#include "ZeusEntity.h"
+#include "ZeusEntityInterface.h"
+#include "ZeusGASComponent.h"
+#include "ZeusPlayerProxy.h"
+#include "ZeusPlayerState.h"
+#include "ZeusNetworkSubsystem.h"
+#include "ZeusNetworkingClientSubsystem.h"
+
+void UZeusWorldSubsystem::Initialize(FSubsystemCollectionBase& Collection)
+{
+	Super::Initialize(Collection);
+
+	if (RemoteEntityClasses.IsEmpty())
+	{
+		RemoteEntityClasses.Add(EZeusEntityType::Player, AZeusPlayerProxy::StaticClass());
+		RemoteEntityClasses.Add(EZeusEntityType::Mob, AZeusEntity::StaticClass());
+		RemoteEntityClasses.Add(EZeusEntityType::NPC, AZeusEntity::StaticClass());
+		RemoteEntityClasses.Add(EZeusEntityType::Object, AZeusEntity::StaticClass());
+	}
+	// Bind + replay vivem em OnWorldBeginPlay (mundo pronto). Initialize roda
+	// MUITO cedo no pipeline de LoadMap — antes do GameMode ser instanciado
+	// e antes do WorldPartition terminar de carregar cells. Spawns dinamicos
+	// feitos aqui podem ser perdidos durante a fase de setup posterior.
+}
+
+void UZeusWorldSubsystem::OnWorldBeginPlay(UWorld& InWorld)
+{
+	Super::OnWorldBeginPlay(InWorld);
+
+	// Sistema de rede novo (canonico) -- substitui o ZeusNetworkSubsystem legacy
+	// para spawn/despawn/movimento de proxies. O legacy fica so' com o que ainda
+	// nao tem equivalente (CHAR_INFO/nome, tratado em AZeusCharacter).
+	if (UZeusNetworkingClientSubsystem* Net = ResolveNetClientSubsystem())
+	{
+		Net->OnEntitySpawned.AddDynamic(this, &UZeusWorldSubsystem::OnNetEntitySpawned);
+		Net->OnEntityDespawned.AddDynamic(this, &UZeusWorldSubsystem::OnNetEntityDespawned);
+		Net->OnEntityDeltaApplied.AddDynamic(this, &UZeusWorldSubsystem::OnNetEntityDelta);
+		Net->OnSelfEntityAssigned.AddDynamic(this, &UZeusWorldSubsystem::OnNetSelfEntityAssigned);
+		Net->OnCharInfo.AddDynamic(this, &UZeusWorldSubsystem::OnNetCharInfo);
+		UE_LOG(LogZMMO, Log, TEXT("ZeusWorldSubsystem bound to network client subsystem delegates."));
+
+		// O subsystem de rede e' per-GameInstance e sobrevive ao OpenLevel, entao
+		// o self-entity e os ENT_SPAWN podem ter chegado ANTES deste bind. Puxa o
+		// self cacheado + faz replay dos proxies ja conhecidos (anti-race).
+		if (const int64 CachedSelf = Net->GetLocalEntityId())
+		{
+			OnNetSelfEntityAssigned(CachedSelf);
+		}
+		int32 ReplayCount = 0;
+		Net->ForEachRemoteEntity(
+			[this, &ReplayCount](int64 EntityId, FVector PosCm, float YawDeg)
+			{
+				// Catch-up local: ForEachRemoteEntity nao expoe vel/serverTimeMs ->
+				// ZeroVector + grounded + ts=0 (seed nao roda; o 1o delta ancora o relogio).
+				OnNetEntitySpawned(EntityId, /*Kind=*/1 /*Player*/, PosCm, YawDeg,
+					FVector::ZeroVector, /*bGrounded=*/true, /*ServerTimeMs=*/0);
+				++ReplayCount;
+			});
+		if (ReplayCount > 0)
+		{
+			UE_LOG(LogZMMO, Log, TEXT("ZeusWorldSubsystem: replay de %d proxy(ies) ja conhecidos."), ReplayCount);
+		}
+	}
+	else
+	{
+		UE_LOG(LogZMMO, Warning, TEXT("ZeusWorldSubsystem: network client subsystem not found at OnWorldBeginPlay."));
+	}
+}
+
+void UZeusWorldSubsystem::Deinitialize()
+{
+	if (UZeusNetworkingClientSubsystem* Net = ResolveNetClientSubsystem())
+	{
+		Net->OnEntitySpawned.RemoveDynamic(this, &UZeusWorldSubsystem::OnNetEntitySpawned);
+		Net->OnEntityDespawned.RemoveDynamic(this, &UZeusWorldSubsystem::OnNetEntityDespawned);
+		Net->OnEntityDeltaApplied.RemoveDynamic(this, &UZeusWorldSubsystem::OnNetEntityDelta);
+		Net->OnSelfEntityAssigned.RemoveDynamic(this, &UZeusWorldSubsystem::OnNetSelfEntityAssigned);
+		Net->OnCharInfo.RemoveDynamic(this, &UZeusWorldSubsystem::OnNetCharInfo);
+	}
+
+	RemoteEntities.Reset();
+	PendingCharInfo.Reset();
+	LocalEntityId = 0;
+	Super::Deinitialize();
+}
+
+void UZeusWorldSubsystem::RegisterLocalEntity(const int64 EntityId, AActor* LocalActor)
+{
+	if (EntityId == 0 || LocalActor == nullptr)
+	{
+		return;
+	}
+
+	LocalEntityId = EntityId;
+
+	// Caso de borda: se o ENT_SPAWN do proprio chegou antes do self-entity, ja
+	// existe um proxy-fantasma com esta chave. Destroi antes de registrar o pawn
+	// real, senao o RemoteEntities.Add sobrescreve a entry e o fantasma fica
+	// orfao no mundo (sem ninguem pra despawna-lo).
+	if (TWeakObjectPtr<AActor>* Existing = RemoteEntities.Find(EntityId))
+	{
+		if (AActor* Ghost = Existing->Get())
+		{
+			if (Ghost != LocalActor && Ghost->IsA(AZeusPlayerProxy::StaticClass()))
+			{
+				HandlePlayerDespawned(EntityId);
+				UE_LOG(LogZMMO, Log,
+					TEXT("ZeusWorldSubsystem: ghost proxy do proprio limpo no RegisterLocalEntity EntityId=%lld"),
+					EntityId);
+			}
+		}
+	}
+
+	RemoteEntities.Add(EntityId, TWeakObjectPtr<AActor>(LocalActor));
+	// V1-CHARINFO: o nome do proprio char pode ter chegado antes do pawn local
+	// existir (CHAR_INFO vem logo apos ENT_SELF); aplica agora.
+	FlushPendingCharInfo(EntityId);
+	UE_LOG(LogZMMO, Log, TEXT("ZeusWorldSubsystem: local entity registered EntityId=%lld actor=%s"),
+		EntityId, *GetNameSafe(LocalActor));
+}
+
+void UZeusWorldSubsystem::HandlePlayerSpawned(const int64 EntityId, const bool bIsLocal,
+	const FVector PosCm, const float YawDeg, const int64 ServerTimeMs)
+{
+	if (EntityId == 0)
+	{
+		return;
+	}
+
+	// P10-FIX-LEGACY (workflow wcyeqgrad finding): server pode reenviar
+	// S_SPAWN_PLAYER com bIsLocal=false do PROPRIO entityId via AOI re-emit
+	// (catch-up cross-server, SetOnEnter callback recomputando InterestSet,
+	// handoff em flight). Sem guard, o segundo spawn cria proxy fantasma do
+	// proprio player; GAS/HUD passa a rotear via proxy fantasma e o pawn real
+	// perde vinculo. Sintoma observado: player ve 2 pawns sobrepostos, ou
+	// outros players nao veem o autoritativo.
+	if (LocalEntityId != 0 && EntityId == LocalEntityId)
+	{
+		UE_LOG(LogZMMO, Verbose,
+			TEXT("ZeusWorldSubsystem: ignoring S_SPAWN_PLAYER for own LocalEntityId=%lld (bIsLocal=%d)"),
+			LocalEntityId, bIsLocal ? 1 : 0);
+		return;
+	}
+
+	if (bIsLocal)
+	{
+		// O proprio AZeusCharacter cuida da sua identidade quando recebe o
+		// delegate por outro caminho. Aqui apenas memorizamos para filtrar
+		// snapshots locais (cliente solto, sem reconciliacao em V0).
+		LocalEntityId = EntityId;
+		return;
+	}
+
+	if (RemoteEntities.Contains(EntityId))
+	{
+		// Ja existe um proxy: tenta reactivar e re-snap. Se o weak ptr ficou
+		// stale (actor coletado pelo GC, stream-out do World Partition, etc.),
+		// remove a entry orfa e cai no caminho de spawn novo — evita SPAWN
+		// silenciosamente ignorado depois de oscilacoes na AOI.
+		if (AActor* Existing = RemoteEntities[EntityId].Get())
+		{
+			if (IZeusEntityInterface* AsEntity = Cast<IZeusEntityInterface>(Existing))
+			{
+				AsEntity->SetEntityRelevant(true);
+			}
+			Existing->SetActorLocationAndRotation(PosCm, FRotator(0.0f, YawDeg, 0.0f));
+			UE_LOG(LogZMMO, Verbose, TEXT("ZeusWorldSubsystem: re-snap EntityId=%d"), EntityId);
+			return;
+		}
+		// weak ptr stale — limpa entry e cai pro spawn novo abaixo.
+		RemoteEntities.Remove(EntityId);
+		UE_LOG(LogZMMO, Log, TEXT("ZeusWorldSubsystem: stale entry para EntityId=%d, respawnando"), EntityId);
+	}
+
+	UWorld* World = GetWorld();
+	if (!World)
+	{
+		return;
+	}
+
+	UClass* ProxyClass = ResolveActorClass(EZeusEntityType::Player);
+	if (!ProxyClass)
+	{
+		UE_LOG(LogZMMO, Warning, TEXT("ZeusWorldSubsystem: no class registered for Player; spawn aborted."));
+		return;
+	}
+
+	FActorSpawnParameters Params;
+	Params.SpawnCollisionHandlingOverride = ESpawnActorCollisionHandlingMethod::AlwaysSpawn;
+	const FRotator SpawnRot(0.0f, YawDeg, 0.0f);
+	AActor* SpawnedActor = World->SpawnActor<AActor>(ProxyClass, PosCm, SpawnRot, Params);
+	if (!SpawnedActor)
+	{
+		UE_LOG(LogZMMO, Warning, TEXT("ZeusWorldSubsystem: SpawnActor failed for EntityId=%d"), EntityId);
+		return;
+	}
+
+	if (IZeusEntityInterface* AsEntity = Cast<IZeusEntityInterface>(SpawnedActor))
+	{
+		// Inject identity via dedicated setter when the spawned actor exposes one.
+		if (AZeusPlayerProxy* Proxy = Cast<AZeusPlayerProxy>(SpawnedActor))
+		{
+			Proxy->SetZeusIdentity(EntityId, EZeusEntityType::Player);
+		}
+		else if (AZeusEntity* Entity = Cast<AZeusEntity>(SpawnedActor))
+		{
+			Entity->SetZeusIdentity(EntityId, EZeusEntityType::Player);
+		}
+		AsEntity->SetEntityRelevant(true);
+	}
+
+	// === PlayerState pra proxies (Batch 2.5+) ===
+	//
+	// Sem PlayerState, o proxy fica fora do GameState->PlayerArray. Daqui pra
+	// cima, qualquer sistema que itera PlayerArray (UZeusGASNetworkHandler::
+	// FindGASComponentForEntity, HUD, chat, friend list) NAO consegue achar o
+	// proxy -> fallback ao local player -> efeito apareceria no char errado
+	// (bug do cue do Dash). Criar PS replicado-fake permite que o pipeline GAS
+	// trate proxies igual a local players.
+	//
+	// PlayerState tem o UZeusGASComponent via DefaultGame.ini Component Registry,
+	// entao GASComp e' auto-instanciado. So' precisamos seed o EntityId.
+	if (APawn* ProxyPawn = Cast<APawn>(SpawnedActor))
+	{
+		FActorSpawnParameters PSParams;
+		PSParams.SpawnCollisionHandlingOverride = ESpawnActorCollisionHandlingMethod::AlwaysSpawn;
+		PSParams.Owner = ProxyPawn;
+		AZeusPlayerState* ProxyPS = World->SpawnActor<AZeusPlayerState>(
+			AZeusPlayerState::StaticClass(), FVector::ZeroVector, FRotator::ZeroRotator, PSParams);
+		if (ProxyPS)
+		{
+			ProxyPawn->SetPlayerState(ProxyPS);  // tambem chama ProxyPS->SetPawn(ProxyPawn)
+
+			// Add ao PlayerArray do GameState (replicacao UE faria isso automatico,
+			// mas no nosso pipeline custom o PS local-fake precisa ser inserido).
+			if (AGameStateBase* GS = World->GetGameState())
+			{
+				GS->AddPlayerState(ProxyPS);
+			}
+
+			// Seed EntityId no GASComp do PS (criado via Component Registry).
+			// FindGASComponentForEntity vai resolver via PS->FindComponentByClass.
+			if (UZeusGASComponent* GASComp = ProxyPS->FindComponentByClass<UZeusGASComponent>())
+			{
+				GASComp->SeedEntityId(EntityId);
+			}
+
+			UE_LOG(LogZMMO, Log,
+				TEXT("ZeusWorldSubsystem: PlayerState criado p/ proxy EntityId=%lld PS=%s"),
+				EntityId, *ProxyPS->GetName());
+		}
+		else
+		{
+			UE_LOG(LogZMMO, Warning,
+				TEXT("ZeusWorldSubsystem: SpawnActor<AZeusPlayerState> falhou pra proxy EntityId=%lld"),
+				EntityId);
+		}
+	}
+
+	RemoteEntities.Add(EntityId, TWeakObjectPtr<AActor>(SpawnedActor));
+	// V1-CHARINFO: o nome chega ANTES do ator (server emite ENT_CHAR_INFO antes
+	// do ENT_SPAWN); aplica agora que o proxy + PlayerState ja existem.
+	FlushPendingCharInfo(EntityId);
+	UE_LOG(LogZMMO, Log, TEXT("ZeusWorldSubsystem: spawned remote EntityId=%d at (%s) yaw=%.1f t=%lld"),
+		EntityId, *PosCm.ToString(), YawDeg, ServerTimeMs);
+}
+
+void UZeusWorldSubsystem::OnNetCharInfo(const int64 EntityId, const FString& CharName, const FString& GuildName)
+{
+	if (EntityId == 0)
+	{
+		return;
+	}
+	// Aplica direto se o ator/PlayerState ja existe; senao guarda pra aplicar no spawn.
+	if (!ApplyCharInfoToEntity(EntityId, CharName, GuildName))
+	{
+		PendingCharInfo.Add(EntityId, FZeusPendingCharInfo{ CharName, GuildName });
+	}
+}
+
+bool UZeusWorldSubsystem::ApplyCharInfoToEntity(const int64 EntityId, const FString& CharName, const FString& GuildName)
+{
+	const TWeakObjectPtr<AActor>* Found = RemoteEntities.Find(EntityId);
+	if (!Found || !Found->IsValid())
+	{
+		return false;
+	}
+	APawn* Pawn = Cast<APawn>(Found->Get());
+	if (!Pawn)
+	{
+		return false;
+	}
+	AZeusPlayerState* PS = Pawn->GetPlayerState<AZeusPlayerState>();
+	if (!PS)
+	{
+		return false;
+	}
+	PS->SetCharInfo(CharName, GuildName);
+	UE_LOG(LogZMMO, Log,
+		TEXT("ZeusWorldSubsystem: CHAR_INFO aplicado EntityId=%lld name='%s' guild='%s'"),
+		EntityId, *CharName, *GuildName);
+	return true;
+}
+
+void UZeusWorldSubsystem::FlushPendingCharInfo(const int64 EntityId)
+{
+	const FZeusPendingCharInfo* Pending = PendingCharInfo.Find(EntityId);
+	if (!Pending)
+	{
+		return;
+	}
+	if (ApplyCharInfoToEntity(EntityId, Pending->CharName, Pending->GuildName))
+	{
+		PendingCharInfo.Remove(EntityId);
+	}
+}
+
+void UZeusWorldSubsystem::HandlePlayerDespawned(const int64 EntityId)
+{
+	const TWeakObjectPtr<AActor>* Entry = RemoteEntities.Find(EntityId);
+	if (!Entry)
+	{
+		return;
+	}
+
+	// Destruir o actor pra valer + remover do mapa. Antes, despawn apenas
+	// fazia SetActorHiddenInGame(true) via SetEntityRelevant(false), o que
+	// deixava o entry no mapa apontando pra um actor escondido. SPAWN
+	// subsequente do mesmo entityId era detectado como "duplicate" e nada
+	// acontecia — pawn ficava invisivel ate' o weak ptr ser GC'd. Bug
+	// confirmado nos logs do AOI ao oscilar entrada/saida da ZI/ZD.
+	if (AActor* Actor = Entry->Get())
+	{
+		if (IZeusEntityInterface* AsEntity = Cast<IZeusEntityInterface>(Actor))
+		{
+			AsEntity->SetEntityRelevant(false);
+		}
+		// Destrui PS proxy linkado (Batch 2.5+). Sem isso o GameState->PlayerArray
+		// fica com PS orfa apos o proxy ser destruido.
+		if (APawn* Pawn = Cast<APawn>(Actor))
+		{
+			if (APlayerState* PS = Pawn->GetPlayerState())
+			{
+				if (UWorld* World = GetWorld())
+				{
+					if (AGameStateBase* GS = World->GetGameState())
+					{
+						GS->RemovePlayerState(PS);
+					}
+				}
+				PS->Destroy();
+			}
+		}
+		Actor->Destroy();
+	}
+	RemoteEntities.Remove(EntityId);
+
+	UE_LOG(LogZMMO, Log, TEXT("ZeusWorldSubsystem: despawn EntityId=%d (destroyed)"), EntityId);
+}
+
+void UZeusWorldSubsystem::HandlePlayerStateUpdate(const int64 EntityId, const int32 InputSeq,
+	const FVector PosCm, const FVector VelCmS, const bool bGrounded, const int64 ServerTimeMs)
+{
+	if (EntityId == 0)
+	{
+		return;
+	}
+
+	if (LocalEntityId != 0 && static_cast<int64>(EntityId) == LocalEntityId)
+	{
+		// Cliente local solto: ignoramos snapshots autoritativos para o nosso
+		// proprio personagem em V0 (ADR 0038). Reconciliacao opcional pode ser
+		// activada por flag em `AZeusCharacter` quando colisao de objetos
+		// chegar.
+		return;
+	}
+
+	const TWeakObjectPtr<AActor>* Entry = RemoteEntities.Find(EntityId);
+	if (!Entry)
+	{
+		// Snapshot antes de spawn: o spawn vira em `OnPlayerSpawned` em breve.
+		return;
+	}
+
+	AActor* Actor = Entry->Get();
+	if (!Actor)
+	{
+		RemoteEntities.Remove(EntityId);
+		return;
+	}
+
+	IZeusEntityInterface* AsEntity = Cast<IZeusEntityInterface>(Actor);
+	if (!AsEntity)
+	{
+		return;
+	}
+
+	FZeusEntitySnapshot Snapshot;
+	Snapshot.EntityId = EntityId;
+	Snapshot.EntityType = AsEntity->GetZeusEntityType();
+	Snapshot.LastProcessedInputSeq = InputSeq;
+	Snapshot.PositionCm = PosCm;
+	Snapshot.VelocityCmS = VelCmS;
+
+	// Etapa 7 (server-side networking refactor): yaw agora chega no
+	// snapshot quantizado v3. Buscamos via TryGetLastPlayerStateExtended
+	// (cache local do plugin). Se PSF_HasYaw nao estiver set ou se o cache
+	// nao tiver entrada, caimos no fallback antigo (derivar do XY da
+	// velocidade ou manter rotacao do ator).
+	bool bYawFromSnapshot = false;
+	if (UZeusNetworkSubsystem* ZeusNet = ResolveZeusNetworkSubsystem())
+	{
+		int32 CachedInputSeq = 0;
+		FVector CachedPos = FVector::ZeroVector;
+		FVector CachedVel = FVector::ZeroVector;
+		float CachedYawDeg = 0.f;
+		int32 CachedFlags = 0;
+		int64 CachedServerTimeMs = 0;
+		if (ZeusNet->TryGetLastPlayerStateExtended(
+				EntityId, CachedInputSeq, CachedPos, CachedVel,
+				CachedYawDeg, CachedFlags, CachedServerTimeMs))
+		{
+			constexpr int32 PSF_HasYaw = 1 << 5;
+			if ((CachedFlags & PSF_HasYaw) != 0)
+			{
+				Snapshot.YawDeg = CachedYawDeg;
+				bYawFromSnapshot = true;
+			}
+		}
+	}
+	if (!bYawFromSnapshot)
+	{
+		// Fallback: deriva yaw do XY da velocidade quando significativo;
+		// caso contrario mantem rotacao do ator (comportamento pre-Etapa 7).
+		if (!FVector(VelCmS.X, VelCmS.Y, 0.0f).IsNearlyZero(1.0f))
+		{
+			Snapshot.YawDeg = FMath::RadiansToDegrees(FMath::Atan2(VelCmS.Y, VelCmS.X));
+		}
+		else
+		{
+			Snapshot.YawDeg = Actor->GetActorRotation().Yaw;
+		}
+	}
+	Snapshot.bGrounded = bGrounded;
+	Snapshot.ServerTimeMs = ServerTimeMs;
+
+	AsEntity->ApplyEntitySnapshot(Snapshot);
+}
+
+void UZeusWorldSubsystem::OnNetEntitySpawned(int64 EntityId, int32 /*Kind*/, FVector PosCm, float YawDeg,
+	FVector VelCmS, bool bGrounded, int64 ServerTimeMs)
+{
+	// O sistema novo nao manda bIsLocal: derivamos do LocalEntityId (setado por
+	// ENT_SELF). Se ainda for 0 e este ENT_SPAWN for do proprio char, o
+	// OnNetSelfEntityAssigned destruira o fantasma quando o ENT_SELF chegar.
+	const bool bIsLocal = (LocalEntityId != 0 && EntityId == LocalEntityId);
+	HandlePlayerSpawned(EntityId, bIsLocal, PosCm, YawDeg, ServerTimeMs);
+
+	// V1-SPAWN-KEYFRAME(-TS): o ENT_SPAWN carrega vel + grounded + serverTimeMs. Aplica
+	// esse keyframe INICIAL no proxy recem-criado pelo mesmo caminho do delta (semeia o
+	// SnapshotBuffer + ANCORA o ServerClockOffsetMs com o tempo CERTO). Antes o seed usava
+	// ServerTimeMs=0 -> bootstrap do relogio de interpolacao errado -> proxy preso/flutuando
+	// ate' o EMA convergir. Agora com o serverTimeMs real o proxy interpola desde o frame 1.
+	if (!bIsLocal && ServerTimeMs > 0)
+	{
+		HandlePlayerStateUpdate(EntityId, /*InputSeq=*/0, PosCm, VelCmS, bGrounded, ServerTimeMs);
+	}
+}
+
+void UZeusWorldSubsystem::OnNetEntityDespawned(int64 EntityId, int32 /*Reason*/)
+{
+	// NUNCA despawnar o proprio char local via rede (ex: ENT_DESPAWN do proprio
+	// disparado por timeout do server). Destruir o pawn local quebraria o jogo
+	// do dono. O proprio so' sai quando o cliente realmente desconecta.
+	if (LocalEntityId != 0 && EntityId == LocalEntityId)
+	{
+		return;
+	}
+	HandlePlayerDespawned(EntityId);
+}
+
+void UZeusWorldSubsystem::OnNetEntityDelta(int64 EntityId, FVector PosCm, FVector VelCmS,
+	float YawDeg, bool bGrounded, int64 ServerTimeMs)
+{
+	if (EntityId == 0)
+	{
+		return;
+	}
+	if (LocalEntityId != 0 && EntityId == LocalEntityId)
+	{
+		return; // movimento do proprio char e' local; ignora snapshot autoritativo
+	}
+
+	const TWeakObjectPtr<AActor>* Entry = RemoteEntities.Find(EntityId);
+	if (!Entry)
+	{
+		return; // spawn chega em breve via ENT_SPAWN
+	}
+	AActor* Actor = Entry->Get();
+	if (!Actor)
+	{
+		RemoteEntities.Remove(EntityId);
+		return;
+	}
+	IZeusEntityInterface* AsEntity = Cast<IZeusEntityInterface>(Actor);
+	if (!AsEntity)
+	{
+		return;
+	}
+
+	FZeusEntitySnapshot Snapshot;
+	Snapshot.EntityId     = EntityId;
+	Snapshot.EntityType   = AsEntity->GetZeusEntityType();
+	Snapshot.PositionCm   = PosCm;
+	Snapshot.YawDeg       = YawDeg;
+	// V1-REPL-FULL (2026-06-12): velocidade + grounded + serverTimeMs -> o proxy
+	// anima (AnimBP ShouldMove via Acceleration!=0 derivada da vel), cola no chao
+	// (MOVE_Walking quando grounded) e interpola com a timeline autoritativa.
+	Snapshot.VelocityCmS  = VelCmS;
+	Snapshot.bGrounded    = bGrounded;
+	Snapshot.ServerTimeMs = ServerTimeMs;
+	AsEntity->ApplyEntitySnapshot(Snapshot);
+}
+
+void UZeusWorldSubsystem::OnNetSelfEntityAssigned(int64 EntityId)
+{
+	if (EntityId == 0 || LocalEntityId == EntityId)
+	{
+		return;
+	}
+	LocalEntityId = EntityId;
+	UE_LOG(LogZMMO, Log, TEXT("ZeusWorldSubsystem: self entity assigned EntityId=%lld"), EntityId);
+
+	// Re-filtragem tardia: se o ENT_SPAWN do proprio chegou ANTES do ENT_SELF,
+	// ja existe um proxy-fantasma do proprio char. Destroi agora -- mas NUNCA o
+	// pawn local real (o RegisterLocalEntity do AZeusCharacter registra o pawn
+	// com a mesma chave; so destruimos se a entry for um AZeusPlayerProxy).
+	if (TWeakObjectPtr<AActor>* Entry = RemoteEntities.Find(EntityId))
+	{
+		if (AActor* Ghost = Entry->Get())
+		{
+			if (Ghost->IsA(AZeusPlayerProxy::StaticClass()))
+			{
+				HandlePlayerDespawned(EntityId);
+				UE_LOG(LogZMMO, Log,
+					TEXT("ZeusWorldSubsystem: ghost proxy do proprio destruido EntityId=%lld"), EntityId);
+			}
+		}
+	}
+}
+
+UClass* UZeusWorldSubsystem::ResolveActorClass(const EZeusEntityType EntityType) const
+{
+	if (const TSubclassOf<AActor>* Found = RemoteEntityClasses.Find(EntityType))
+	{
+		if (Found->Get())
+		{
+			return Found->Get();
+		}
+	}
+	return AZeusEntity::StaticClass();
+}
+
+UZeusNetworkSubsystem* UZeusWorldSubsystem::ResolveZeusNetworkSubsystem() const
+{
+	const UWorld* World = GetWorld();
+	if (!World)
+	{
+		return nullptr;
+	}
+	UGameInstance* GI = World->GetGameInstance();
+	if (!GI)
+	{
+		return nullptr;
+	}
+	return GI->GetSubsystem<UZeusNetworkSubsystem>();
+}
+
+UZeusNetworkingClientSubsystem* UZeusWorldSubsystem::ResolveNetClientSubsystem() const
+{
+	const UWorld* World = GetWorld();
+	if (!World)
+	{
+		return nullptr;
+	}
+	UGameInstance* GI = World->GetGameInstance();
+	if (!GI)
+	{
+		return nullptr;
+	}
+	return GI->GetSubsystem<UZeusNetworkingClientSubsystem>();
+}

Source/ZMMO/Game/Network/ZeusWorldSubsystem.h

@@ -2,16 +2,17 @@
 
 #include "CoreMinimal.h"
 #include "Subsystems/WorldSubsystem.h"
-#include "ZMMOEntityTypes.h"
-#include "ZMMOWorldSubsystem.generated.h"
+#include "ZeusEntityTypes.h"
+#include "ZeusWorldSubsystem.generated.h"
 
 class AActor;
-class AZMMOPlayerCharacter;
-class AZMMOPlayerProxy;
+class AZeusCharacter;
+class AZeusPlayerProxy;
 class UZeusNetworkSubsystem;
+class UZeusNetworkingClientSubsystem;
 
 /**
- *  UZMMOWorldSubsystem
+ *  UZeusWorldSubsystem
  *
  *  Subsistema por-mundo que orquestra a aplicacao de pacotes de replicacao
  *  recebidos do servidor (`S_SPAWN_PLAYER`, `S_DESPAWN_PLAYER`,
@@ -26,19 +27,19 @@ class UZeusNetworkSubsystem;
  *      conexao UDP e dos delegates; este subsistema apenas escuta os
  *      delegates e materializa atores na cena atual.
  *
- *  Resolucao de classe por `EZMMOEntityType`:
+ *  Resolucao de classe por `EZeusEntityType`:
  *    - `RemoteEntityClasses` e um TMap configuravel (BlueprintReadWrite)
  *      com defaults seguros em `Initialize`. Permite trocar
- *      `AZMMOPlayerProxy` por um BP filho com mesh customizada sem
+ *      `AZeusPlayerProxy` por um BP filho com mesh customizada sem
  *      recompilar C++.
  *
  *  Despawn:
- *    - V0: chama `IZMMOEntityInterface::SetEntityRelevant(false)` (preserva
+ *    - V0: chama `IZeusEntityInterface::SetEntityRelevant(false)` (preserva
  *      o ator para futuro pooling).
  *    - V1: pool real por `EntityType`, limites de memoria, expiracao.
  */
 UCLASS()
-class ZMMO_API UZMMOWorldSubsystem : public UWorldSubsystem
+class ZMMO_API UZeusWorldSubsystem : public UWorldSubsystem
 {
 	GENERATED_BODY()
 
@@ -48,27 +49,27 @@ public:
 	virtual void Deinitialize() override;
 
 	/**
-	 *  Regista o jogador local no registry. Chamado por `AZMMOPlayerCharacter`
+	 *  Regista o jogador local no registry. Chamado por `AZeusCharacter`
 	 *  apos receber o `EntityId` autoritativo do servidor (delegate
 	 *  `OnPlayerSpawned` com `bIsLocal=true`).
 	 */
-	UFUNCTION(BlueprintCallable, Category = "ZMMO|World")
+	UFUNCTION(BlueprintCallable, Category = "Zeus|World")
 	void RegisterLocalEntity(int64 EntityId, AActor* LocalActor);
 
 	/** Numero de entidades remotas actualmente trackeadas. Util em debug overlays. */
-	UFUNCTION(BlueprintPure, Category = "ZMMO|World")
+	UFUNCTION(BlueprintPure, Category = "Zeus|World")
 	int32 GetTrackedEntityCount() const { return RemoteEntities.Num(); }
 
 protected:
 	/**
-	 *  Mapa configuravel de classe a usar por `EZMMOEntityType`. Caso vazio,
-	 *  usamos defaults seguros (`AZMMOPlayerProxy` para Player, `AZMMOEntity`
+	 *  Mapa configuravel de classe a usar por `EZeusEntityType`. Caso vazio,
+	 *  usamos defaults seguros (`AZeusPlayerProxy` para Player, `AZeusEntity`
 	 *  para Mob/NPC/Object — actualizado quando classes especificas existirem).
 	 *
 	 *  Pode ser preenchido via Blueprint subclassing ou em runtime.
 	 */
-	UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "ZMMO|World")
-	TMap<EZMMOEntityType, TSubclassOf<AActor>> RemoteEntityClasses;
+	UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Zeus|World")
+	TMap<EZeusEntityType, TSubclassOf<AActor>> RemoteEntityClasses;
 
 private:
 	UFUNCTION()
@@ -80,8 +81,39 @@ private:
 	UFUNCTION()
 	void HandlePlayerStateUpdate(int64 EntityId, int32 InputSeq, FVector PosCm, FVector VelCmS, bool bGrounded, int64 ServerTimeMs);
 
-	UClass* ResolveActorClass(EZMMOEntityType EntityType) const;
+	// Sistema de rede novo (canonico) -- recebe spawn/despawn/delta + self-entity.
+	// Adaptam a assinatura nova para os handlers de spawn/despawn/delta acima.
+	UFUNCTION()
+	void OnNetEntitySpawned(int64 EntityId, int32 Kind, FVector PosCm, float YawDeg,
+		FVector VelCmS, bool bGrounded, int64 ServerTimeMs);
+
+	UFUNCTION()
+	void OnNetEntityDespawned(int64 EntityId, int32 Reason);
+
+	UFUNCTION()
+	void OnNetEntityDelta(int64 EntityId, FVector PosCm, FVector VelCmS, float YawDeg,
+		bool bGrounded, int64 ServerTimeMs);
+
+	UFUNCTION()
+	void OnNetSelfEntityAssigned(int64 EntityId);
+
+	// V1-CHARINFO: nome/guild do char (opcode ENT_CHAR_INFO 6045). Chega ANTES
+	// do ENT_SPAWN do proxy / do RegisterLocalEntity do self, entao se o ator
+	// ainda nao existe o dado fica em PendingCharInfo e e' aplicado no spawn.
+	UFUNCTION()
+	void OnNetCharInfo(int64 EntityId, const FString& CharName, const FString& GuildName);
+
+	UClass* ResolveActorClass(EZeusEntityType EntityType) const;
 	UZeusNetworkSubsystem* ResolveZeusNetworkSubsystem() const;
+	UZeusNetworkingClientSubsystem* ResolveNetClientSubsystem() const;
+
+	// Aplica nome/guild no AZeusPlayerState do EntityId (self ou proxy). Retorna
+	// false se o ator/PlayerState ainda nao existe (caller deve cachear).
+	bool ApplyCharInfoToEntity(int64 EntityId, const FString& CharName, const FString& GuildName);
+
+	// Aplica (e consome) o char info pendente de EntityId, se houver. Chamado
+	// quando o ator passa a existir (spawn de proxy / RegisterLocalEntity).
+	void FlushPendingCharInfo(int64 EntityId);
 
 	/**
 	 *  Registry de proxies remotos. Chave = `EntityId` autoritativo do servidor.
@@ -93,4 +125,12 @@ private:
 
 	/** Cached id do jogador local, para ignorar snapshots dele (cliente solto). */
 	int64 LocalEntityId = 0;
+
+	/** V1-CHARINFO: nome/guild recebido antes do ator existir. Chave = EntityId. */
+	struct FZeusPendingCharInfo
+	{
+		FString CharName;
+		FString GuildName;
+	};
+	TMap<int64, FZeusPendingCharInfo> PendingCharInfo;
 };

Source/ZMMO/Game/UI/Common/UIDraggableWindow_Base.cpp

@@ -20,7 +20,7 @@ void UUIDraggableWindow_Base::ApplySavedPosition()
 	const FName Id = GetWindowId();
 	if (Id.IsNone()) return;
 
-	UZMMOUISaveGame* Save = UZMMOUISaveGame::LoadOrCreate();
+	UZeusUISaveGame* Save = UZeusUISaveGame::LoadOrCreate();
 	FVector2D Pos;
 	if (Save && Save->TryGetWindowPosition(Id, Pos))
 	{
@@ -33,10 +33,10 @@ void UUIDraggableWindow_Base::PersistCurrentPosition()
 	const FName Id = GetWindowId();
 	if (Id.IsNone()) return;
 
-	UZMMOUISaveGame* Save = UZMMOUISaveGame::LoadOrCreate();
+	UZeusUISaveGame* Save = UZeusUISaveGame::LoadOrCreate();
 	if (!Save) return;
 	Save->SetWindowPosition(Id, GetRenderTransform().Translation);
-	UZMMOUISaveGame::SaveNow(Save);
+	UZeusUISaveGame::SaveNow(Save);
 }
 
 bool UUIDraggableWindow_Base::IsDragHandleHit(const FPointerEvent& MouseEvent) const