2nd/10_Wiki/Topics/2026-04-23_Engine_Stabilization_Report.md

ISSUE REPORT: [v13.1] Engine Stabilization & Tactical Boundary Overhaul

1. 개요

Skybound 엔진의 초기 구동 안정성을 확보하고, 게임의 장르적 성향(전략 슈터)을 강화하기 위한 적기 이동 로직 및 레벨업 시스템의 결함을 해결함.

2. 해결된 결함 (Level-Up Loop)

2.1 현상

• 게임 시작 직후 TAC LEVEL UP 모달이 무한 반복 출력되어 조작 불능 상태 발생.
• 엔진 내부 레벨과 Zustand 스토어 레벨 간의 동기화 불일치.

2.2 원인 분석

• StageDirectorSystem: 타임라인 이벤트가 최소 시간 가드 없이 초기화 시점에 조기 발동.
• ProgressionSystem: 스킬 선택 시 Zustand 구독과 엔진 로직 양쪽에서 레벨을 이중 증가시킴.

2.3 수정 사항

• StageDirectorSystem: 15초/30초 최소 시간 가드 및 processed[[Events|Events]]econds 중복 발동 방지 락 도입.
• ProgressionSystem: 이중 증가 로직 제거 및 Zustand [Single_Source_of_Truth|Single Source of Truth] 강화.
• UI: LevelUpModal에 isChest 플래그를 추가하여 일반 레벨업과 보급품(Supply Drop) 보상을 시각적으로 분리.

3. 기능 개선 (Enemy Tactical Boundary)

3.1 현상

• 적기가 격파되지 않은 상태에서 화면 하단으로 유유히 사라짐 (전통적 슈팅 게임 방식).
• 플레이어의 전략적 대응 영역 및 경험치 수급 기회 상실.

3.2 수정 사항 (CombatSystem)

• Boundary Clamp: 적기의 이동 허용 범위를 height + 300에서 height - 40으로 타이트하게 조정.
• Chase Pattern: 플레이어 추격 시 화면 하단 경계를 인식하도록 가드 추가.
• Zigzag Pattern: 화면 하단 도달 시 방향을 반전시키는 '핑퐁(Ping-pong)' 패턴으로 업그레이드.
• Striker AI: 하단 돌진 후 상단으로 복귀하는 순찰 로직 추가.

4. 기대 효과

• 안정성: 게임 초기화 및 재개 시 발생하는 상태 데드락 원천 차단.
• 전략성: 모든 적이 화면 내에 유지됨으로써 플레이어의 통제권 강화 및 생존 슈터로서의 긴장감 극대화.
• 경제: 경험치 젬 및 루트 아이템의 화면 밖 유실 방지.