ACPlayer1STCharacter

// Spring Arm Tick — adaptive Z target offset formula:
// val = a + pow(x + c * d, P) * -(a / pow(c, P))
// where a = defaultTargetOffset.Z, x = camera pitch, c = 40, d = 0.333, P = 2
// Result is clamped and smoothed: TargetOffset.Z = (current + val) * 0.5

// Spring Arm Tick — auto-pitch (mobile gyroscope):
// defaultArmPitch = Lerp(50, -25, Clamp(gravity.Z, 0, 1))
// newPitch = FInterpTo(currentPitch, slope - defaultArmPitch, deltaTime, interpSpeed)
// interpSpeed = 5 if moving fast, 0.5 if slow

// Spring Arm Reset — view-dependent configuration:
// Top view: rotation(-89, 0, 0), armLength = (max - min) * 0.5, socketOffset = (0,0,0)
// First person: rotation(-30, 0, 0), armLength = meshBound.Z * 2.3, socketOffset = (0,80,0)

// PossessedBy sequence:
// 1. SetShowMouseCursor(true)
// 2. SetInputMode(GameAndUI, HideCursorDuringCapture = !isTopView())
// 3. UCSkillComponent::displaySkillWidget()
// 4. boundDynamic() — binds to ActorUtility::onActorEvent + PlayerController events
// 5. Broadcast perspectiveTypeChange (after boundDynamic)

// UnPossessed sequence:
// 1. UCSkillComponent::removeSkillWidget()
// 2. unboundDynamic()
// 3. Super::UnPossessed() — called last

// innerUpdateFighMode — rotation configuration:
// FIGHTING:
//   CDRYX_FIGHTING = true
//   bUseControllerRotationYaw = false
//   bOrientRotationToMovement = false
//   bUseControllerDesiredRotation = false
//   RotationRate = (0, 270, 0)
//
// NOT FIGHTING:
//   CDRYX_FIGHTING = false
//   bUseControllerRotationYaw = false
//   bOrientRotationToMovement = true
//   bUseControllerDesiredRotation = false
//   RotationRate = (0, 540, 0)
//
// Always notifies turnByTurnComponent->fightReasonUpdated()

// AddControllerYawInput — fight mode turn-in-place:
// If blocking + stationary: suppress rotation entirely
// If stationary (speed near 0) and yawDiff > 66°: play turnLeft/turnRight montage, delay 0.45s
// If moving (speed > 0) and yawDiff > 25°: set bUseControllerDesiredRotation = true, delay 0.22s
// If yawDiff near 0: set bUseControllerDesiredRotation = false
// Montages stop as soon as speed > 0 (via CANIMBUILDER stopAsSoonAs)

// changeView() — switching to TOP VIEW:
// HideCursorDuringCapture = false
// bInheritPitch = false, bInheritYaw = false, bUsePawnControlRotation = false
// customReset()
// cleanFightReason() — exits fight mode

// changeView() — switching to FIRST PERSON:
// HideCursorDuringCapture = true
// bInheritPitch = !runningOnMobile(), bInheritYaw = true, bUsePawnControlRotation = true
// customReset()
// SetControlRotation(GetActorRotation())
// initSpeedFactor()

// Both directions broadcast:
// perspectiveTypeChange(TOP_VIEW or FIRT_VIEW)

// Click-to-move in top view (LMBEvent.onTriggered):
// 1. Ray cast from mouse position
// 2. If hit actor is attackable (collisionTestIfAttack): makeMeAttack(false, actor)
// 3. Else: compute speedFactor = Clamp(distance / capsuleHeight, 0, 5)
//    If speedFactor > 0.33: AddMovementInput toward destination
// 4. On release (< 0.5s): SimpleMoveToLocation(cachedDestination)

// Mobile 1-stick movement (moveEvent, non-fighting):
// Forward: AddMovementInput(forward * max(value.X, 0))
// Steering: AddControllerYawInput based on stick deflection
//   value.X >= 0: yaw = value.Y
//   value.X < 0, value.Y > 0: yaw = 1 - value.X
//   value.X < 0, value.Y <= 0: yaw = -1 + value.X

// onActorEvent — removes fight reason when adversary deactivates:
// If retrieveActor(advIdx)->isActivated() == false:
//   updateFightReason(advIdx, false)

// onFightReasonChange — bridges ACPlayerController fight events:
// advIdx = actor->UCInitializerComponent->actorId
// updateFightReason(advIdx, fightReason == ON)