2nd/10_Wiki/Topics_GD/Skybound_Enemy_Orientation_Fix.md

[LOG] Skybound Enemy Orientation Fix (Crab Movement Bug)

• Timestamp: 2026-04-23 23:13 (KST)
• Status: Resolved
• Lead: Steve (Executive Director)

1. 버그 내용 (Bug Description)

• 현상: 적기가 화면 상단에서 등장할 때 정면(아래)을 보지 않고 오른쪽을 바라본 채 하강하는 '꽃게 이동' 현상 발생.
• 원인: 적기 생성 시 rotation 초기값이 0이었으며, 등장 단계(Entrance)에서 플레이어를 조준하는 로직이 조기 종료(Early Return)로 인해 실행되지 않아 렌더링 오프셋(+PI/2)만 적용되어 오른쪽을 바라보게 됨.

2. 해결 방법 (Resolution)

• 초기화 강화: SpawnerSystem에서 적기 생성 시 rotation: Math.PI / 2를 기본값으로 명시적 할당.
• 로직 순서 재조정: CombatSystem의 업데이트 루프에서 회전값 계산을 등장 단계 분기점 이전으로 전진 배치하여, 어떤 상태에서도 적기가 플레이어 방향(또는 아래 방향)을 유지하도록 보장.

3. 결과 (Expected Result)

• 적기가 생성되는 즉시 플레이어를 향해 정면을 유지하며 하강함.
• 시각적 직관성 및 전투 몰입도 향상.

4. 관련 토픽 (Linked Topics)

• Skybound: 엔진 렌더링 무결성 확보.
• Graphics & Performance: 스프라이트 회전 행렬 최적화.