Fix: Restore unified Topics folder and reorganize specialized category folders

2026-05-02 23:25:02 +09:00
parent b71a0b82d3
commit fdfbc83535
6241 changed files with 147626 additions and 194 deletions
@@ -0,0 +1,22 @@
+# [LOG] Skybound Weapon Behavior Engine Migration & Tuning
+
+- **Timestamp**: 2026-04-24 01:28 (KST)
+- **Status**: Completed
+- **Lead**: Antigravity
+
+## 1. 작업 개요 (Task Summary)
+- **WeaponBehaviorEngine 전면 도입**: 기존 `ModularWeaponSystem`에 남아있던 하드코딩된 레거시 무기 로직(`missile_pod`, `DIMENSION_SLAYER` 등)을 완벽히 제거하고 데이터 기반(Data-Driven) 엔진으로 마이그레이션 완료.
+- **수치 및 발사 좌표 동기화 (Tuning)**: `missile_pod` 스킬이 렌더러 파이프라인의 시각적 부착점(Attachment Point)과 일치하도록 발사 좌표(spawnX, spawnY)를 기체 양쪽 날개(x: -30, +30)로 재조정.
+
+## 2. 주요 버그 해결 (Bug Fixes)
+- **미사일 중복 발사 문제 해결**: 구버전 레거시 로직과 신버전 데이터 주도 로직이 동시에 실행되며 중앙과 양측에서 미사일이 중복 발사되는 구조적 충돌을 `DATA_DRIVEN_WEAPONS` 배열 편입을 통해 완벽 해결.
+- **착시 현상(연속 발사) 진단**: 유저가 체감한 '초당 4~5발의 연속 발사'는 미사일 스킬의 오류가 아닌, **기본 무기(Falcon)가 3레벨에 도달했을 때 발동하는 '소형 유도 미사일(Homing Micro-Missiles)' 2발이 15프레임 단위로 발사되는 정상적인 시스템 기믹**임을 논리적 수치 분석으로 규명함. 
+- **EXP Gem 투명도 버그 수정**: `SpriteUtils`의 투명도 제거 알고리즘 예외 목록(`trueTransparencyAssets`)에 `orb.png`를 명시하여 렌더링 무결성 확보.
+
+## 3. 코드 설계 (Architectural Impact)
+- 무기별 고유 상태(`WeaponState`)는 `weaponStates` Map 객체를 통해 격리 관리되어 간섭 방지.
+- 스킬의 레벨업에 따른 발사체 쿨다운 단축 로직을 엔진 단에서 독립적으로 연산하여 확장성 부여.
+
+## 4. 관련 토픽 (Linked Topics)
+- Skybound: 무기 아키텍처 및 렌더링 파이프라인.
+- Design & Experience: 시각적 피드백과 로직의 일치화.