2nd/10_Wiki/Topics/2026-04-22_Boss_Spawn_Logic_Fix.md

📝 [Technical Report] 보스 스폰 시스템 안정화 및 AI 교전 로직 개선

1. 개요 (Overview)

본 문서는 Skybound 프로젝트의 최종 보스 미출현 이슈 해결 및 적기 AI의 공격성 강화를 위한 기술적 수정 사항을 기록합니다.

2. 적기 AI 개선 (Enemy AI Overhaul)

기존의 '낙엽 효과(Wobble)'와 '회피(Avoidance)' 로직을 제거하고 공격적 교전 패턴을 도입했습니다.

• 낙엽 효과 제거: CombatSystem 내 Math.sin 기반 좌우 흔들림 로직 삭제.
• 회피 로직 삭제: 플레이어 근접 시 발생하는 기피력(Repulsion) 제거.
• 예측 요격(Predictive Interception): 플레이어의 현재 속도(v_x, v_y)를 기반으로 12프레임 뒤의 위치를 타격하는 로직 적용.
• 근접전 페널티: 플레이어와 거리 250px 이내에서 연사력 2배 부스트 적용.

3. 보스 스폰 안정화 (Boss Spawn Fix)

트리거와 페이즈 전환 간의 동기화 오류를 해결했습니다.

• 트리거 선행 배치: CombatTimeline의 보스 스폰 트리거를 페이즈 시작 10초 전으로 앞당김 (870s -> 860s).
• 시퀀스 가속:
  • FINAL_BOSS -> BOSS_WARNING: 180프레임 -> 60프레임 (1초)
  • BOSS_WARNING -> BOSS: 300프레임 -> 120프레임 (2초)
• 응답성 개선: 보스 경고 발생 후 실제 등장까지의 체감 대기 시간을 총 8초에서 3초로 단축.

4. 엔진 무결성 점검 (Integrity Check)

• StageDirectorSystem.ts의 코드 단절(Truncation) 여부를 확인하고 정상 작동을 검증함.
• CombatSystem.ts의 타입 안전성 확보 및 AI 역할별 이동 패턴 정상화 확인.

---

Status: Green (Operational) Author: Antigravity (AI Dev Director 'Kodari') Date: 2026-04-22