From de6200e7be9696ed6a2e846e18c49df68cac6270 Mon Sep 17 00:00:00 2001 From: g1nation Date: Thu, 23 Apr 2026 17:16:52 +0900 Subject: [PATCH] docs: add skybound v13.1 update and engine stabilization notes --- ...1 - 시스템 안정화 및 전술적 경계 고도화.md | 43 +++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 Skybound v13.1 - 시스템 안정화 및 전술적 경계 고도화.md diff --git a/Skybound v13.1 - 시스템 안정화 및 전술적 경계 고도화.md b/Skybound v13.1 - 시스템 안정화 및 전술적 경계 고도화.md new file mode 100644 index 00000000..75ffb139 --- /dev/null +++ b/Skybound v13.1 - 시스템 안정화 및 전술적 경계 고도화.md @@ -0,0 +1,43 @@ +# 🛡️ Skybound Protocol: 시스템 안정화 및 전술적 경계 고도화 (v13.1) + +📌 **Brief Summary** +Skybound 엔진의 초기 구동 안정성을 확보하고, 게임의 정체성을 '전통적 슈팅'에서 '전략 생존 슈터'로 강화하기 위해 핵심 시스템을 재설계한 대규모 업데이트입니다. + +--- + +📖 **Core Content** + +## 1. 엔진 구동 안정화 (Engine Stability) +게임 시작 시 발생하는 상태 데드락과 무한 레벨업 모달 루프를 해결했습니다. + +* **시간 기반 가드 (Time-based Guards):** `StageDirectorSystem`에서 초기화 시점의 급격한 이벤트 발동을 방지하기 위해 15초/30초의 최소 동작 가드를 도입했습니다. +* **이벤트 중복 발동 방지:** `processedEventSeconds` 셋을 활용하여 동일 시간대의 이벤트가 중복 트리거되지 않도록 락(Lock) 메커니즘을 강화했습니다. + +## 2. 상태 동기화의 단일 진실 원천 (Single Source of Truth) +엔진 내부 로직과 UI(Zustand) 간의 레벨 정보 불일치를 제거했습니다. + +* **Zustand 중심 설계:** `ProgressionSystem`에서 엔진이 직접 레벨을 올리던 중복 로직을 제거하고, 모든 성장은 Zustand 스토어를 통해서만 이루어지도록 강제했습니다. +* **UI 피드백 분리:** `LevelUpModal`에 `isChest` 플래그를 추가하여 일반 레벨업과 긴급 보급품(Emergency Supply Drop) 보상을 시각적으로 명확히 분리했습니다. + +## 3. 전술적 경계 가드 (Tactical Boundary Clamping) +적기가 화면 밖으로 이탈하여 플레이어의 대응 권한을 박탈하는 문제를 해결했습니다. + +* **물리적 클램핑:** `CombatSystem`에서 적기의 이동 허용 범위를 화면 하단 `height - 40`으로 제한했습니다. +* **전략적 전환:** 적은 피해야 할 장애물이 아닌, 반드시 격파해야 할 '전술적 목표'로 재정의되었습니다. + +## 4. 고도화된 AI 이동 패턴 +화면 경계 내에서 유기적으로 움직이는 새로운 이동 로직을 도입했습니다. + +| 패턴명 | 상세 설명 | 시각적 흐름 | +| :--- | :--- | :--- | +| **Ping-pong Zigzag** | 화면 경계 충돌 시 반대 방향으로 반전하여 화면 내 상주 시간을 극대화함. | `Left -> Right (Collision) -> Left` | +| **Recursive Striker** | 하단 돌격 후 소멸하지 않고 다시 상단으로 복귀하여 순찰 모드로 전환됨. | `Top -> Bottom (Dive) -> Top (Return)` | +| **Chase Guard** | 플레이어를 추격하는 동안에도 화면 경계를 넘지 않도록 위치 보정 로직이 상시 작동함. | `Player Tracking + Clamp` | + +--- + +🔗 **Knowledge Connections** + +- **Related Topics:** [[Skybound Protocol 시스템 아키텍처 및 데이터 흐름 분석]], [[Skybound Protocol 데이터 및 제어 흐름 (Control Flow)]] +- **Issue Log:** `Issue_2026-04-23_Engine_Stabilization_and_Tactical_Boundary.md` +- **Keywords:** `State Synchronization`, `Boundary Clamping`, `Tactical Shooter`, `Zustand SSOT`