Base Classes

// ACActor is the simplest base. Use it for static objects, props, interactables.
// Components are created automatically in the constructor.
// At runtime, UCInitializerComponent::init() wires everything from a FCCharacterDetailMaker row.

ACActor(const FObjectInitializer& ObjectInitializer) : Super(ObjectInitializer) {
    UCInitializerComponent::prepare_CSTR_CACTOR_ONLY(this);
}

// ACPawn adds combat, life, AI and movement on top of ACActor components.
// Root is a UCCapsuleComponent for physics and floating movement.

ACPawn(const FObjectInitializer& ObjectInitializer) : Super(ObjectInitializer) {
    UCInitializerComponent::prepare_CSTR_CPAWN_ONLY(this);
}

// ACCharacter uses ObjectInitializer to replace default UE subobjects with Cdryx variants.

ACCharacter(const FObjectInitializer& ObjectInitializer) : Super(ObjectInitializer
    .SetDefaultSubobjectClass<UCCapsuleComponent>(CapsuleComponentName)
    .SetDefaultSubobjectClass<UCSkeletalMeshComponent>(MeshComponentName)
    .SetDefaultSubobjectClass<UCCharacterMovementComponent>(CharacterMovementComponentName)
) {
    UCInitializerComponent::prepare_CSTR_CCHARACTER_ONLY(this);
}

// ACProjectile is spawned by UCCombotterComponent during range attacks.
// The sphere root uses BlockAll collision profile.

ACProjectile() {
    UCInitializerComponent::prepare_CSTR_CPROJECTILE_ONLY(this);
}

// ACPlayer1STCharacter is the main playable character.
// Fight mode is driven by fightReasonSet: any system can add/remove fight reasons.
updateFightReason(advIdx, true);  // enter fight mode against advIdx
updateFightReason(advIdx, false); // leave fight mode against advIdx
cleanFightReason();               // clear all fight reasons

// View switching:
changeView(); // toggles between top-view and first-person
bool top = isTopView(); // check current view mode

// ACPlayerFLYPawn is a strategy-style flying camera.
// It tracks terrain Z and supports box selection of actors.
// Left click + drag: translate. Right click + drag: rotate.
// Right click + Ctrl + drag: box select. Scroll: zoom.

// ACSun computes pitch and yaw each tick using a sine-based curve.
ACSun sun;
sun.zenithAngle = 75;         // max elevation
sun.dayDelayInSecond = 120.0;  // 2 minutes = 1 full day
sun.nightRation = 0.5;         // night covers half the pitch range
sun.startedSinceSecond = 60;   // start at midday

// ACPortrait sets up a complete portrait studio.
// The skeletal mesh is SetVisibleInSceneCaptureOnly(true).
// All lights use lighting channel 2 to avoid affecting the game world.
// The scene capture ShowOnlyComponent targets the skeletal mesh.