2nd/10_Wiki/Topics/Skybound/Skybound_Enemy_Orientation_Fix.md

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by

id	title	category	status	canonical_id	aliases	duplicate_of	source_trust_level	confidence_score	tags	raw_sources	last_reinforced	github_commit	inferred_by
wiki-2026-0508-skybound-enemy-orientation-fix	Skybound Enemy Orientation Fix	10_Wiki/Topics_GD	needs_review	self		none	A	0.92	uncategorized		2026-05-08	pending	Claude Opus 4.7 (auto-normalize 2026-05-08)

[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: 스프라이트 회전 행렬 최적화.

📌 한 줄 통찰 (The Karpathy Summary)

(TODO: 한 문장으로 핵심 통찰을 작성. "X는 Y 조건에서 Z 효과를 낸다" 구조 권장.)

📖 구조화된 지식 (Synthesized Content)

추출된 패턴:

(TODO)

세부 내용:

• (TODO)

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

• (TODO)

언제 쓰면 안 되는가:

• (TODO)

🧪 검증 상태 (Validation)

• 정보 상태: needs_review
• 출처 신뢰도: A
• 검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

• 기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
• 처리 방식: UPDATE (자동 정규화)
• 처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

⚠️ 모순 및 업데이트 (Contradictions & Updates)

• 과거 데이터와의 충돌: 없음
• 정책 변화: 없음

🔗 지식 연결 (Graph)

• Parent: 10_Wiki/Topics
• Related: (TODO: 최소 2개)
• Opposite / Trade-off: (TODO)
• Raw Source: 직접 입력

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A