Components

// Constructor-time: prepare_CSTR_* creates all components for the base class.
UCInitializerComponent::prepare_CSTR_CCHARACTER_ONLY(this);

// Player classes call complete_CSTR_* to add camera, input, etc.
UCInitializerComponent::complete_CSTR_CPLAYER_FIRST_PERSON_ONLY(this,
    cameraInit, cameraTick, cameraReset,
    springArmInit, springArmTick, springArmReset);

// Runtime: init(advIdx) cascades to all components.
// advIdx == -1 means player (reads from PlayerSpawner).
// advIdx >= 0 means NPC/actor (reads from ActorSpawner).
ICInitializerComponent_::Execute_init(component, advIdx);

// Damage flow:
// 1. OnTakeAnyDamage fires
// 2. UCDamageReceptionContainer is created with damage, armor, etc.
// 3. executeDamagedSkill is consumed
// 4. Damaged animation plays if damage > 0
// 5. currentLife is reduced
// 6. If currentLife <= 0, whatIfDeath() triggers death sequence

// Death sequence:
// 1. executeDeathSkill is consumed
// 2. Killed montage plays
// 3. After 50% of anim: collision disabled, ragdoll enabled
// 4. After 200% of anim: physics disabled, skeleton frozen

// Interaction flow:
// 1. OnBeginOverlap: finds closest interactable, checks canInteractWith
// 2. Consumes beginOverlapInteractionSkill
// 3. On explicit interaction (E key): consumes executeInteractionSkill
// 4. OnEndOverlap: consumes endOverlapInteractionSkill, finds next closest

// Team attitude logic:
// NoTeam (255) on either side => Neutral
// Same team => Friendly
// Different teams => Hostile

// Melee attack state machine:
// S_NOT_ATTACKING -> (user click) -> S_ATTACKING -> (montage end) -> S_ATTACK_FINISHED
//                                 -> (can combo) -> S_COMBO_WINDOW -> (user click) -> S_ATTACKING

// Range attack state machine:
// S_BOW_NOT_DRAWING -> S_PREPARE_BOW_DRAW -> S_BOW_DRAWING -> S_BOW_SHOT -> S_ATTACK_FINISHED

// Block state machine:
// S_NOT_BLOCKING -> S_PREPARE_BLOCKING -> S_BLOCKING -> (end block) -> S_NOT_BLOCKING

UCSelectComponent::deselectAllBut(GetWorld());
UCSelectComponent::retrieveAllSelectedActorBut(GetWorld());

skillComponent->addSkill(FName("Fireball"));
skillComponent->removeSkill(FName("Fireball"));
skillComponent->runSkill(0); // trigger first skill via widget

// ECInputActionType enum values:
// MOVE, ROTATE, JUMP, TOUCH_CLICK, LMB_CLICK, CTRL_LMB_CLICK, RMB_CLICK,
// TOUCH_PINCH, SCROLL, CTRL_SCROLL, BLOCK, INTERACT, CHANGE_VIEW,
// DISPLAY_RESOURCE, DISPLAY_MAP

// Default key bindings:
// MOVE: ZQSD / Arrow keys / Gamepad Left Stick
// ROTATE: Mouse XY / Gamepad Right Stick
// JUMP: SpaceBar
// LMB_CLICK: Left Mouse Button
// INTERACT: F
// BLOCK: Tab
// CHANGE_VIEW: V
// DISPLAY_RESOURCE: I
// DISPLAY_MAP: M

// Each FCInputStruct<T> provides 5 callbacks:
// onTriggered, onStarted, onGoing, onCanceled, onCompleted
// Signature: (T value, float elapsedSec, float triggeredSec, const UInputAction*)

moveEvent.onTriggered = [this](FVector2D v, float e, float t, const UInputAction*) {
    AddMovementInput(GetActorForwardVector(), v.X);
    AddMovementInput(GetActorRightVector(), v.Y);
};

// Requires in DefaultGame.ini:
// [/Script/AIModule.AISense_Sight]
// bAutoRegisterAllPawnsAsSources=false

// Automatically managed by UCInitializerComponent lifecycle

// UCAutomation stores commands as (FName, FCVariantType) pairs
// Supported commands: LOCATION (FName), WAIT (float)
// The AI behavior tree reads commands via ICAutomationComponent_ interface

// Callbacks are set by UCInitializerComponent::complete_CSTR_CPLAYER_FIRST_PERSON_ONLY
// providing player-specific camera behavior

// Capsule radius = max(X, Y extent) * 0.25
// Capsule half-height = Z extent * 0.5
// Also considers skeletalMeshChildArray for modular characters

// Jump state machine:
// S_NOT_JUMPING -> (E_USER_CLICK_START_JUMP && !blocking && !attacking) -> S_JUMPING
// S_JUMPING -> (E_USER_CLICK_END_JUMP) -> S_NOT_JUMPING

movementComponent->updateSpeed(1.5f); // 150% speed

// Automatically managed by UCInitializerComponent lifecycle
// Tracks all activated actors that have character metadata
// Sends per-actor data to the compass widget each tick:
// position, distance, alpha, z-order, visibility

// Used for flying/floating pawns that need to follow terrain
// MaxSpeed is set from maker.maxWalkSpeed * scale

// FOW is tick-driven, refresh rate from maker.fogOfWarRefreshRate
// Complex ray mode: casts rays in a circle to detect occlusion
// Simple mode: draws a single brush circle for revealed area

// Captures FinalColorLDR with most visual features disabled
// Only Translucency is enabled (for fog of war overlay)
// Widget provides the render target via ICMinimapWidget_::currentMinimapData

// Generation radius = navigationRadius * 1.0 * scale * 0.5
// Removal radius = navigationRadius * 1.7 * scale * 0.5
// Deactivated actors don't generate navmesh

// Used by UCCombotterComponent::whatIfProjectileLaunch
// Speed is read from the bendTimeToSpeed curve based on bow draw time

// Reset flow:
// 1. Set skeletal mesh from maker (or null if deactivated)
// 2. Create child skeletal meshes with SetLeaderPoseComponent for modular characters
// 3. Set anim class and physics asset
// 4. Configure animation priorities on UCAnimInstance
// 5. Update meshBound on actorInformation
// 6. Toggle actor visibility

// Callbacks are set by UCInitializerComponent::complete_CSTR_CPLAYER_FIRST_PERSON_ONLY
// Probe size, arm length, location and offset are configured in reset()

// Used for non-skeletal actors (props, interactables)
// Collision: BlockAll profile, Visibility=Block, Camera=Ignore

// State machine workflow:
// S_END_OF_TURN_BY_TURN -> S_ORDERING_ACTOR -> S_CHOOSE_TARGET
//   -> S_MOVE_ACTOR_TO_TARGET -> S_ATTACK -> S_CHOOSE_NEXT_ACTOR
//   -> (loop back to S_CHOOSE_TARGET or S_ORDERING_ACTOR)

// During combat:
// - Player is possessed by an AI controller with the basic enemy BT
// - Camera switches to a fly pawn that orbits the battle
// - Hexagonal tiles in the battle area are banned from spawning

// Created internally by UCLifeComponent::internalOnTakeADamage
// Passed to the executeDamagedSkill for custom damage processing

// Accessed internally by UCActionMappingComponent::setup
// Ensures the old mapping context is removed before adding the new one

// UCDebugComponent is created automatically by UCInitializerComponent.
// On init, it retrieves the W_DEBUG widget class from the coordinator,
// creates the widget, and configures its display mode:
//   - If the widget implements ICWorldWidget_: world-space with transform, drawSize, material
//   - Otherwise: screen-space positioned at capsule half-height

// Adding custom debug text:
ICDebugComponent_* debug = Cast<ICDebugComponent_>(debugComponent);
debug->addDebugWidgetWith([](AActor* actor) {
    return FText::FromString(FString::Printf(TEXT("HP: %d"), GetLife(actor)));
});