PD 명시 (2026-05-08):
1. 가장자리 좌우 반복 잔존
2. 모든 Enemy의 PatrolPath 제거 + 자동 알고리즘만
정정 (BT95):
1. Scene Ingame.unity Enemy 인스턴스 path 영역 m_Modifications 12건 제거
- Python 자동 영역 (PrefabInstance 영역에서 propertyPath: path 영역 삭제)
- PatrolPath GameObject 영역은 Scene 잔존 (영향 X·EnemyController 영역 미참조)
2. EnemyController.cs:
- PHASE_COOLDOWN 0.5 → 1.0 (긴 영역·좌우 반복 영구 차단)
- 절벽·벽 검출 시 velocity.x = 0 → velocity.x = -moveDir * maxSpeed (즉시 반대 방향 큰 속도)
- control.move.x = -moveDir 직접 (1 frame 지연 차단)
효과:
- velocity 영역 즉시 반대 방향 큰 속도 → 가장자리에서 빠르게 멀어짐
- 1초 cooldown = 충분 영역 멀어진 후 검출 활성 → 좌우 반복 X
- PatrolPath path 영역 m_Modifications 제거 = 자동 patrol 영역만 사용 (PD 명시)
PD 보고 (2026-05-08): 1) 벽 가장자리 좌우 반복 / 2) 좁은 영역 생성 Enemy 떨어짐
진단:
- 좌우 반복: phase 전환 직후 1~2 frame 미세 정지 → stuckTimer 트리거 → 또 phase+2 → 매 frame 반복
- 좁은 영역: patrol 거리 50~75m > 시작 위치 ↔ 절벽 거리 → 시작 즉시 절벽 영역 도달 → 떨어짐
정정 (BT94):
1. _phaseCooldown 영역 신규 (0.5초)
- phase 전환 직후 절벽·벽 검출 비활성
- cooldown 동안 Enemy 영역 반대 방향 이동 (충분 영역) → 안정
2. 시작 시 좌·우 walk 영역 안전 거리 측정 (MeasureSafeWalkDistance)
- Awake 시점 0.5m 간격 Raycast 영역 절벽 검출까지 거리 측정
- patrol 거리 = min(설정 거리, 측정 거리 - 1.5m 안전 margin)
- _maxRightRange·_maxLeftRange 영역
3. SetNextPatrolTarget — _maxRightRange/_maxLeftRange cap 적용
효과:
- 좌우 반복 = phase cooldown 0.5초 = phase 전환 직후 검출 X → 안정
- 좁은 영역 = 시작 시 안전 거리 측정 → patrol 영역 절벽 영역 도달 X
- 일반 영역 = 영향 X (안전 거리 측정 ≥ patrolMaxRange)
PD 보고 (2026-05-08): 가장자리 밀림·갑자기 바닥 떨어짐·낭떠러지 돌진
진단:
- BT92 transform.position += 직접 set = KinematicObject body.position 영역과 충돌
- = body.position ↔ transform.position 비동기 → 비정상 위치 → 갑자기 떨어짐
- BT92 stuckThresholdTime 0.3 = 가장자리 밀림 누적 영역 발생
정정 (BT93):
1. transform.position push 폐기 (cliffSafePushDistance Inspector 영역도 폐기)
2. 절벽·벽 검출 시 control.velocity = (0, velocity.y) 강제
- velocity.x 영역 즉시 0 = 관성 차단 = 발 절벽 진입 X
- velocity.y 보존 (gravity·점프 영역)
3. stuckThresholdTime: 0.3 → 0.15 (150ms·밀림 누적 차단)
효과:
- KinematicObject body 영역 정합 (transform 직접 set X)
- 절벽 영역 = velocity.x 즉시 0 + 반대 방향 control.move.x → 다음 frame 반대 이동
- 벽 가장자리 = 150ms 정지 후 phase+2 + velocity.x 0
- 이상 떨어짐 영역 차단
PD 보고 (2026-05-08): 1) 벽 가장자리 좌우 반복 / 2) 낭떠러지 돌진 떨어짐
진단:
- 좌우 반복: stuckTimer 50ms 영역이 phase 전환 직후 1 frame 정지를 정지로 인식 → 매번 트리거 → 부들부들
- 낭떠러지: cliffCheckDistance 0.8m + 1 frame 지연으로 발 영역 절벽 진입 → KinematicObject 영역 발 아래 충돌 X → gravity 떨어짐
정정 (BT92):
1. stuckThresholdTime: 0.05 → 0.3 (300ms — phase 전환 직후 미세 정지 영역 무시)
2. cliffCheckDistance: 0.8 → 1.0 (1m 일찍 검출)
3. cliffSafePushDistance Inspector 영역 신규 (기본 0.15m)
4. 절벽 검출 시: transform.position += (-moveDir * 0.15m) 즉시 안전 영역 push
- 1 frame 지연 영역에서 발 영역 절벽 진입 차단
- 이후 phase+2 + control.move.x = 반대 방향
효과:
- 벽 가장자리 = stuckTimer 300ms 임계값 → phase 전환 후 안정 → 좌우 반복 X
- 절벽 영역 = 1m 앞 검출 + transform 즉시 안전 push → 발 영역 절벽 X → 떨어짐 X
- arrive·일반 patrol 영역 그대로
PD 보고 (2026-05-08): 1) 낭떠러지 떨어짐 잔존 / 2) 부들부들 / 3) 자연스러운 patrol
진단:
- BT86 cliffCheckDistance 0.3 = 발 외부 0.017m → 너무 가까움
- 절벽 영역 도달 직전 검출 → 다음 frame 발 영역 절벽 진입 + waitTimer 1~3초 정지 → gravity로 떨어짐
- 벽 영역 = stuckTimer 50ms → phase+2 + waitTimer 정지 → 부들부들
정정 (BT91):
1. cliffCheckDistance: 0.3 → 0.8 (더 일찍 검출·발 외부 0.5m)
2. cliffCheckDepth: 1.5 → 2.0 (더 깊게)
3. 절벽 검출 시: phase+2 + 즉시 반대 방향 이동 (waitTimer X)
- control.move.x = Mathf.Clamp(dx_new, -1, 1) 즉시 적용
4. 벽 정지 (stuckTimer 50ms) 시: phase+2 + 즉시 반대 방향 이동 (waitTimer X)
5. patrol arrive 시점만 waitTimer 1~3초 대기 (안전 영역만 정지)
효과:
- 절벽 영역 = 더 일찍 검출 + 즉시 반대 이동 (정지 X·떨어짐 X)
- 벽 영역 = 즉시 반대 이동 (부들부들 X)
- arrive 시점만 자연스러운 1~3초 대기
- patrol 사이클: 이동 → arrive → 1~3초 idle → 이동 → arrive → idle (자연스러움)
- 위험 영역 (벽·절벽) = 즉시 반응 (정지 X)
PD 보고 (2026-05-08): "몬스터들이 전혀 이동하지 않고 있어"
진단:
- BT89 수평 Raycast = bounds 외부 0.05+0.1m = 같은 Tile cell (1m) 영역 검출 → 거짓 양성
- 매 frame phase+2 + waitTimer 1~3초 → 영구 대기 사이클 → 정지
정정 (BT90):
- 수평 벽 Raycast 영역 폐기 (BT85 영역 회복)
- wallCheckDistance Inspector 영역 폐기
- stuckThresholdTime 0.1 → 0.05 (50ms·거의 즉시)
- stuckTimer 영역 = 벽 정지 50ms 후 phase+2 + waitTimer 1~3초
- 절벽 검출·waitTimer 영역 그대로
효과:
- 정상 이동 시 stuckTimer 누적 X (frame당 ~0.058m > 0.02m 임계값)
- 벽 정지 시 50ms 후 phase+2 (거의 즉시)
- 절벽 영역 = 즉시 phase+2 + 대기
- arrive·벽·절벽 = 1~3초 대기 후 다음 phase
PD 보고 (2026-05-08):
1. 벽 영역 버벅대다 밀림 → 즉시 반대 방향 의무
2. patrol 1회 후 1~3초 대기 패턴
정정 (BT89):
1. UpdatePatrol() 영역 분리 — patrol·벽·절벽·대기 통합
2. 수평 벽 Raycast 부활:
- bounds 외부 (halfWidth + 0.05m) 시작
- distance 0.1m (총 0.15m·인접 Tile X)
- 검출 시 phase+2 즉시 전환 (stuckTimer 100ms 영역 폐기 — 즉시)
3. 절벽 검출:
- 검출 시 phase+2 즉시 전환
4. _waitTimer 영역 신규:
- patrol arrive 시 Random.Range(1, 3)초 대기
- 벽 검출 시 동일 (대기 후 반대 방향 patrol)
- 절벽 검출 시 동일
- 대기 중 control.move.x = 0
5. stuckTimer 보조 영역 잔존 (수평 Raycast 미감지 fallback)
6. Inspector 노출: wallCheckDistance·waitMinTime·waitMaxTime
효과:
- 벽 영역 = 즉시 반대 방향 (Raycast 검출 frame에 phase+2)
- 절벽 영역 = 즉시 반대 방향
- patrol arrive·벽·절벽 = 1~3초 random 대기 후 다음 phase
- 대기 중 = control.move.x = 0 (Idle)
- 시각상 자연스러운 patrol 패턴
PD 보고 (2026-05-08): "이번에는 몬스터들이 다시 낭떠러지로 떨어져버렸어 (이전 버전은 떨어지지 않음)"
진단:
- BT86 절벽 검출 = phase+1 (= 시작 위치 복귀)
- BT87 patrol 거리 절반 (50~75) → 시작 위치 ↔ 절벽 거리 작아짐
- 시작 위치 복귀 도중 = 절벽 영역 도달 → 떨어짐
정정 (BT88):
- 절벽 검출 시: phase+2 (반대 방향 patrol·시작 위치 복귀 폐기)
- 벽 정지(stuckTimer) 시: phase+2 (동일·즉시 반대 방향)
phase 전환 영역:
- phase 0 (우측 out) → phase 2 (좌측 out)
- phase 1 (시작 복귀·우측에서) → phase 3 (시작 복귀·좌측에서)
- phase 2 (좌측 out) → phase 0 (우측 out)
- phase 3 (시작 복귀·좌측에서) → phase 1 (시작 복귀·우측에서)
효과:
- 절벽 영역 = 즉시 반대 방향 patrol (시작 위치 영역 X)
- 벽 충돌 = 동일 (즉시 반대 방향)
- 시작 위치 절벽 근처 영역 = 안전
PD 보고 (2026-05-08):
1. 벽 충돌 후 움찔거리다 방향 전환 어색
2. 순찰 거리 너무 멀어 절반으로
정정 (BT87):
1. stuckThresholdTime: 0.3 → 0.1 (100ms·움찔 차단·즉시 방향 전환)
2. patrolMinRange: 100 → 50 / patrolMaxRange: 150 → 75 (절반)
효과:
- 벽 충돌 시 100ms 정지 → 즉시 다음 phase (반대 방향 patrol)
- 순찰 거리 = 시작 위치 기준 좌/우 random 50~75 왕복
PD 보고 (2026-05-08):
1. 몬스터 이동속도 너무 빨라 2배 느리게
2. 벽 가장자리 미세 밀림 → 낭떠러지 떨어짐
3. 낭떠러지 근처 생성 Enemy 이동 중 떨어짐
정정 (BT86):
1. AnimationController maxSpeed 7 → 3.5 (Enemy.prefab):
- frame당 이동 거리 ~0.117m → ~0.058m (2배 느림)
2. stuckTimer 영역 임계값 정정:
- 거리: |transform.x - _lastX| < 0.01 → 0.02 (미세 밀림 검출)
- 시간: stuckThresholdTime 0.5 → 0.3 (빠른 phase 전환)
- stuckMoveThreshold Inspector 영역 신규
3. 절벽 검출 영역 정정:
- cliffCheckDistance: 0.6 → 0.3 (더 빠른 검출·낭떠러지 근처 보호)
- 시작 위치 복귀 영역 폐기 → 다음 phase 강제 (시작 위치도 절벽 가능 가설)
효과:
- Enemy 이동속도 2배 느림
- 미세 밀림 (< 0.02m/frame) = stuckTimer 누적 → 0.3초 후 phase 전환
- 절벽 영역 = 즉시 다음 phase (반대 방향 patrol) — 시작 위치 복귀 X
- 낭떠러지 근처 생성 Enemy = 절벽 영역 검출 → 즉시 반대 방향
PD 보고 (2026-05-08):
1. 몬스터 바닥 뚫고 나옴 (이미지 첨부)
2. 몬스터 여전히 이동 X
진단:
- 버그 1: sprite 발 영역(transform.y - 0.63·sprite half) ↔ Capsule bounds.min.y(transform.y - 0.39) = 0.24m 차이. Capsule 영역 위 Tile 표면 → sprite 영역 발이 0.24m 침투 → 시각상 침투
- 버그 2: BT83/BT84 수평 벽 Raycast 영역(bounds 외부 + 0.5m)도 옆 Tile (평지 인접) 검출 → 거짓 양성 → 매 frame phase 강제 → 모든 Enemy 정지
정정 (BT85):
1. transform.y 추가 +0.3 (Enemy.prefab 1.532→1.832 + Scene 인스턴스 19건 +0.3)
2. EnemyController.cs:
- 수평 벽 Raycast (BT83/BT84 영역) 폐기
- wallCheckDistance Inspector 영역 폐기
- stuckThresholdTime: 0.3→0.5 (BT81 영역 회복·정상 이동 미세 영역 거짓 양성 차단)
- 절벽 검출 영역 그대로
- stuckTimer 영역 그대로 (벽 정지 시 0.5초 후 다음 phase 강제)
효과:
- 시각상 발 영역 침투 X (transform.y +0.3 → 총 +0.8 from 원본)
- 정상 patrol 영역 = stuckTimer 영역 0 (frame당 transform.x 변경 큰 영역)
- 벽 영역 정지 시 = stuckTimer 영역 0.5초 누적 → 다음 phase 강제
- 절벽 영역 = footAhead Raycast 영역 (Layer 0+16) 검출 → 시작 위치 복귀
후속 의무:
- PD Refresh+Play 시각 검증
PD 보고 (2026-05-08): "이제는 모든 몬스터가 이동(순찰 패턴)하지 않고 있어"
근본 원인:
- BT83 wallOrigin = bounds.center.x + moveDir * 0.05 = Capsule bounds 내부
- Enemy가 Foreground Tile 위 영역에 서있을 때 = 인접 Tile (같은 Layer 16) Raycast 검출
- = 거짓 양성 → 즉시 다음 phase 강제 → 매 frame 반복 → patrol X
정정 (BT84):
- wallOrigin.x = bounds.center.x + moveDir * (halfWidth + 0.05f)
- = Capsule bounds 외부 영역 시작 → 자기 영역(또는 같은 Tile) 검출 X
- 절벽 검출 영역 그대로 (footAhead 영역은 발 앞 cliffCheckDistance·다른 영역)
효과:
- Enemy 영역 자기 검출 X = 거짓 양성 차단
- 벽 영역 정상 검출 (외부 영역만)
- patrol 정상 작동
후속 의무:
- PD Refresh+Play 시각 검증
PD 보고 (2026-05-08): "몬스터가 벽 가장자리에서 이동하지 못하게 되면 밀려나면서 결국 낭떠러지로 떨어지고 있어"
진단:
- 벽 가장자리 정지 시 미세 밀림(< 0.01 영역) → stuckTimer 누적 X
- 다음 phase 전환 X → 미세 밀림 누적 → 결국 절벽 영역 도달 → 떨어짐
- BT81 stuckTimer 영역만으로 부족 (정지 임계값 0.01 미달 미세 밀림 미감지)
정정 (BT83):
1. wallCheckDistance 영역 신규 (Inspector 노출·기본 0.5)
2. 수평 벽 Raycast 검출 추가:
- 발 영역 horizontal (moveDir 방향) Raycast Layer 0+16
- 벽 검출 시 즉시 다음 phase 강제 (stuckTimer 영역과 분리)
3. stuckThresholdTime: 0.5 → 0.3 (빠른 영역 전환)
효과:
- 벽 영역 즉시 검출 + 다음 phase = 정지·밀림 영역 도달 X
- 절벽 영역 도달 X = 떨어짐 차단
- stuckTimer 영역 = 보조 (벽 검출 + 미감지 fallback)
후속 의무:
- PD Refresh+Play 시각 검증
PD 보고 (2026-05-08): "여전히 몬스터가 낭떠러지로 사라졌어"
근본 원인:
- BT66 R2 영역에서 PD Foreground TilemapCollider2D Object.Destroy
- = PD 직접 그린 발판 영역 위에 Enemy 배치 시 발 아래 충돌 X = 떨어짐
- BT81 절벽 검출 영역 = footAhead Raycast Layer 0+16. PD Foreground = TilemapCollider X = Raycast 검출 X = 절벽 영역 인식 X = 떨어짐
정정 (BT82):
- BT66 R2 영역의 PD Foreground TilemapCollider2D Destroy 영역 폐기
- TilemapCollider2D 부착 회복 + Layer 16 강제 (AutoForeground와 동일)
효과:
- Player ↔ PD Foreground = Drop-Through 패턴 영역 정상 (통과·착지 분기)
- Enemy ↔ PD Foreground = 충돌 ON (Layer 14 ↔ Layer 16) = 떨어짐 X
- Enemy 절벽 검출 = PD Foreground·AutoForeground 모두 Layer 16 + TilemapCollider = 정합
후속 의무:
- PD Refresh+Play 시각 검증 (Enemy 떨어짐 X·Player 통과 영역 그대로)
PD 보고 (2026-05-08):
1. 벽에 닿은 후 멈춰있음 (이동 거리 미달 + 벽 충돌 → dx 영역 큰 값 잔존 → 영구 정지)
2. 낭떠러지 떨어짐 (절벽 검출 거짓 양성 또는 미검출)
진단:
- 버그 1: BT80 코드는 dx<arriveThreshold 시점만 다음 phase. 벽 충돌 시 KinematicObject body.Cast 차단 → transform.x 정지 → dx 영역 잔존 → phase 전환 X
- 버그 2: groundLayerMask=~0 (모든 layer) = Enemy/Player Collider 거짓 양성 → 절벽 영역 미검출
정정 (BT81):
1. stuckTimer 영역 신규:
- _lastX·_stuckTimer 추가
- 매 frame |transform.x - _lastX| < 0.01 시 _stuckTimer 누적
- _stuckTimer > 0.5초 시 = 벽 정지 → 다음 phase 강제
2. groundLayerMask: ~0 → (1 << 0) | (1 << 16) — Layer 0 (지면) + Layer 16 (발판)만
3. cliffCheckDepth: 0.8 → 1.5 — 지면 검출 깊이 증가
4. Inspector 노출: stuckThresholdTime 신규 (기본 0.5초)
효과:
- 벽 정지 시 0.5초 후 자동 phase 전환 (다음 patrol 방향 시도)
- 절벽 검출 = Layer 0/16만 = Enemy/Player 거짓 양성 차단
- 시작 위치 복귀 영역 그대로
후속 의무:
- PD Refresh+Play 시각 검증
PD 명시 (2026-05-08):
1. 몬스터 바닥 살짝 뚫고 들어감 → y +0.5 (Enemy.prefab + Scene 인스턴스)
2. PatrolPath 폐기 → 생성 위치 기준 좌/우 random 100~150 왕복 자동 patrol
3. 절벽 검출 → 낭떠러지 떨어지지 않도록
변경:
1. Enemy.prefab transform.y: 1.032 → 1.532
2. Scene Ingame.unity Enemy 인스턴스 16개 m_LocalPosition.y override 영역 +0.5 일괄 (19건)
3. EnemyController.cs:
- patrol 4-phase 영역 (0: 우측 random / 1: 시작 복귀 / 2: 좌측 random / 3: 시작 복귀)
- SetNextPatrolTarget — Random.Range(100, 150) 영역 + phase별 _targetX 계산
- Update 영역 자동 patrol 로직 (PatrolPath path 영역 폐기·legacy 호환만)
- 절벽 검출 — 발 앞 0.6 + 발 아래 0.8 Raycast 영역 지면 X 시 시작 위치 즉시 복귀
- Inspector 노출: patrolMinRange·patrolMaxRange·patrolArriveThreshold·cliffCheckDistance·cliffCheckDepth·groundLayerMask
- BT17 marker Debug.Log 영역 폐기 (시행착오 정리)
효과:
- 모든 Enemy 인스턴스 (path 미설정 영역 포함) 자동 patrol 작동
- 시작 위치 기준 ±100~150 random 왕복 패턴
- 절벽 영역 검출 시 시작 위치 즉시 복귀 (낭떠러지 X)
- y +0.5 = 발 영역 지면 위 정합
PD 명시 (2026-05-08): "몬스터도 캐릭터와 같이 리소스를 반대로 재생시켜야 해"
근본 원인:
- AnimationController.cs (Enemy 영역) flipX 영역:
- 우측 이동 시 flipX = false
- 좌측 이동 시 flipX = true
- PlayerController.cs (Hero1 영역) flipX 영역:
- 우측 이동 시 flipX = true
- 좌측 이동 시 flipX = false
- = 반대 영역. M001 sprite (좌측 향함) 기준 Enemy 영역 우측 이동 시 sprite 그대로 = 후방 이동 영역.
정정 (true·false 반전):
- 우측 이동 시 spriteRenderer.flipX = true
- 좌측 이동 시 spriteRenderer.flipX = false
- = PlayerController·Hero1 영역과 동일 영역 정합
PD 추가 보고 진단 (첫 번째 등장 몬스터 정지):
- Scene Enemy prefab 인스턴스 16개 중 5개 path 미설정 (#3·#9·#11·#13·#14)
- path null = mover null = move.x = 0 = 정지
- pos.x 카탈로그: #13(7.79·path=0) #3(24.49·NO_PATH) #14(42.91·NO_PATH) #11(82.28·NO_PATH) #9(139.27·NO_PATH)
- = PD 시각 첫 번째 등장 = pos.x 가장 작은 영역 가설 (#13 또는 #3)
- 정정 영역 = PD가 Editor에서 path 영역 직접 부여 의무 (PatrolPath GameObject Inspector 영역 drag·drop)
PD 명시 (2026-05-08): "1차 2차 모두 순차적으로 일괄 진행"
2차 = 4개 .anim 영역 sprite reference 영역 M001 순환 매핑 (Python 자동):
- EnemyIdle.anim: 48 keyframes → M001_idle 4 frames (4-cycle, 12회 반복)
- EnemyRun.anim: 15 keyframes → M001_run 5 frames (5-cycle, 3회 반복)
- EnemyHurt.anim: 9 keyframes → M001_hit 2 frames (2-cycle)
- EnemyDeath.anim: 8 keyframes → M001_death 4 frames (4-cycle, 2회 반복)
매핑 알고리즘:
- m_PPtrCurves 영역 keyframe별 sprite reference 영역 (fileID, guid, type)
- keyframe_index % m001_frame_count → M001 frame 순환 매핑
- fileID = 21300000 (Multiple sprite mode 첫 sprite)
1차 (BT76 commit 020a220) + 2차 (본 commit) = 일괄 진행 결과:
- Enemy.prefab 정지 sprite = M001_idle01 (BT76)
- 4 모션 애니메이션 = M001 frames 순환 (BT77)
attack 영역 후속 권고:
- Enemy.controller 영역 attack state 미존재 (현재 4 motion만 — Idle·Run·Hurt·Death)
- attack 영역 추가 시 신규 .anim 영역 + controller 영역 state·transition 신규 의무 (큰 분량)
- PD 결정 영역
PD 명시 (2026-05-08): "게임 내 모든 몬스터를 늑대로"
1차 단순 진행 (정지 시점 sprite만 교체):
- Enemy.prefab m_Sprite = EnemyIdle.png(fe68c6e1...) → M001_idle01.png(f7b7e5d5...)
- 시각상 정지 시점 = 늑대 idle 첫 frame
2차 후속 권고 (PD 결정 영역):
- EnemyIdle/Run/Hurt/Death .anim 영역 sprite reference 영역 교체
- EnemyIdle.png GUID(fe68c6e1...) → M001_idle 4 frames
- EnemyRun.png 영역 → M001_run 5 frames
- EnemyHurt.png 영역 → M001_hit 2 frames
- EnemyDeath.png 영역 → M001_death 4 frames
- attack 영역 신규 .anim 영역 작성 가능 (M001_attack 4 frames)
- Enemy.controller 영역 .anim 참조 영역 변경 또는 AnimatorOverrideController 영역 신규
M001 sprite GUID 카탈로그 (.anim 교체 시 사용):
- idle: f7b7e5d5d35e8ea4a9574fc970089486 / eb4754ac8816180459f43ea0d2be515d / f8a4b8c30ad9dc0479c2a21f635975c0 / f8519f10c50debc448559483e0af1b42
- run: 87e0e7df.. / bff83363.. / f70891b2.. / 8b2f5697.. / 4d71cfb9..
- hit: 37b18867.. / 0e93511696..
- death: 5e56e0e8.. / 8d913271.. / e9529e37.. / 17c76eeb..
- attack: c0df76ac.. / eff1bf43.. / 2b3fa48e.. / 23f76537..
후속 의무:
- PD Refresh+Play 시각 검증 (정지 sprite = M001_idle01 정합)
- 2차 .anim·controller 영역 교체 결정 (PD 명시)
PD 명시 (2026-05-08): "플레이어 조작 시스템 완성. 시행착오로 불필요하게 생성된 코드·작업물 제거 + 최신 상태로만 깔끔하게"
정리 영역:
1. GameOptimizer.cs (Write 전체 재작성):
- 헤더 주석 — BT5-Dev 발판 시스템 영구 영역 명시 + 동작 요약 5단계
- BT34·BT46·BT66·BT67·BT48·BT63·BT68 시행착오 주석 영역 통합 정리
- Debug.Log 영역 통합 1행 ([GameOptimizer] 출력)
- IsSmallAirPlatform 헬퍼 영역 보존 (BT48 휴리스틱 사용 중)
2. PlayerController.cs (Edit 부분 정리):
- dropThroughTimer·jumpAscentTimer 변수 영역 주석 정리
- OnCollisionEnter2D BT30-Collide 진단 Debug.Log 영역 폐기 (시행착오)
- BT69·BT70·BT71·BT72·BT73·BT74 시행착오 주석 영역 통합 정리
- UpdateContactFilterForDropThrough 영역 메서드 docstring 추가
3. KinematicObject.cs (Edit 부분 정리):
- BT68 X·Y 분리 영역 주석 정리
영구 채택 영역:
- R2 (BT66): AutoForeground GameObject 분리 + PD Foreground = 가림막 시각만
- BT67: AutoForeground transform 동기화 (PD Foreground·Level 영역과 동일)
- BT68: KinematicObject X·Y 분리 + GameOptimizer TileGround* 자동 분류 제외
- BT69~BT74: Drop-Through (Down + Jump) Input 패턴 + 가장자리 jitter 차단
플레이어 조작 시스템 완성:
- 발판 위 착지·점프 통과·자유 이동
- Down + Jump = Drop-Through (발판 위만)
- 전진 점프 시 앞 벽 hit + 위로 점프 보존
- 대각선 벽 통과 X (TileGround* Level 잔존)
- 발판 가장자리 jitter 차단 (3점 Raycast + 밀림 강제 Drop-Through)
PD 권고 (2026-05-08): "한번이라도 밀리면 아래로 강제로 떨구어야하지 않을까?"
진단:
- BT73 후 footHit 3점 안정화에도 특수 영역 잔존
- 점프 정점(velocity.y ≈ 0) + 수평 이동 시도 + 발판 가장자리 = 발판 일시 검출
- = standingOnPlatform=true → mask ON → body.Cast 충돌 → 수평·수직 정지
- = '밀린 상태 고정'
정정 (BT74 — UpdateContactFilterForDropThrough 영역 추가):
밀림 상태 검출 4조건 AND 결합:
1. standingOnPlatform=true (footHit 3점 검출)
2. inAir = jumpState == Jumping || jumpState == InFlight (점프·낙하 중)
3. nearApex = velocity.y > -1.5f (정점·낙하 초기)
4. horizontalIntent = Mathf.Abs(move.x) > 0.1f (수평 이동 시도)
검출 시 강제 Drop-Through:
- dropThroughTimer = DROP_THROUGH_DURATION (0.3초 mask 강제 OFF)
- standingOnPlatform = false (즉시 해제)
- = Player 발판 통과 + 자연 낙하 시작
효과:
- 발판 가장자리 정점 + 수평 이동 시 = 강제 통과 (밀림 X)
- 정상 착지 (velocity.y < -1.5 빠른 descending) = 영역 외 → 그대로 착지
- 발판 위 정지 (Grounded·수평 입력 X) = 영역 외 → 그대로
- ascending·Drop-Through·일반 점프 = 그대로
후속 의무:
- PD Refresh+Play 시각 검증 (특수 재현 경로 + 다양한 점프 영역)
PD 보고 (2026-05-08): "발판 끝에서 내려오기 직전 아래 방향 유지 + 발판방향 이동 시 밀려남"
진단:
- BT72 후도 descending 시 standingOnPlatform 검사 활성
- footHit Raycast 단일 (중앙) 영역 = 발판 가장자리 진입 시 검출 X·검출 O frame 교차
- = jitter (mask ON·OFF 진동) → 미세 밀려남
정정 (BT73):
- footHit Raycast 좌·중·우 3점 추가
- footY = collider2d.bounds.min.y + 0.02f
- boundsLeft = collider2d.bounds.min.x + 0.02f
- boundsCenter = collider2d.bounds.center.x
- boundsRight = collider2d.bounds.max.x - 0.02f
- standingOnPlatform = 3점 OR 결합 (어느 하나라도 검출 시 true)
- = 발판 가장자리 영역 안정 검출
효과:
- 발판 가장자리 영역 진입 시 standingOnPlatform 안정 (jitter 차단)
- 발판 위 착지 정합 (3점 중 1점 검출 영역 충분)
- ascending·Drop-Through·일반 점프 영역 그대로
후속 의무:
- PD Refresh+Play 시각 검증 (특수 재현 경로 — 발판 끝 + Down + 발판 방향 이동)
PD 질문 (2026-05-08): "발판 방향 통과 시 밀려나는 현상. 깔끔하게 통과 또는 통과 X (착지) 둘 중 하나로"
진단:
- ascending 판정: velocity.y > 0.01f (mask OFF Layer 16 통과)
- 정점 영역 (velocity.y ≈ 0): 1~2 frame 동안 조건 X → standingOnPlatform 검사 활성
- = 발판 영역 진입 + footHit 검출 → mask ON 짧은 충돌 → 밀려남 (jitter)
정정 (BT72):
- jumpAscentTimer 신규 (JUMP_ASCENT_DURATION = 0.4초)
- PrepareToJump → Jumping 시 Timer 활성 (Drop-Through 점프 X — dropThroughTimer 영역으로 처리)
- Update에 매 frame Timer 감소
- isJumpingThrough 조건에 jumpAscentTimer > 0f 추가
- = 점프 시작 후 0.4초 mask 강제 OFF → ascending·정점 일관 통과
- 0.4초 후 또는 descending velocity.y < -0.01 → standingOnPlatform 검사 활성 → 발판 위 착지
효과:
- 발판 방향 점프 = 깔끔 통과 (정점 영역 밀려남 X)
- 발판 위 떨어지면 착지 (descending standingOnPlatform 검사)
- 일반 점프·Drop-Through·전진 점프 영역 그대로
후속 의무:
- PD Refresh+Play 시각 검증 (발판 통과 일관성)
- 정합 시 BT72 영역 영구 채택
PD 보고 (2026-05-08): "아래로 점프 시도 한 다음부터 점프키가 동작하지 않는 현상"
근본 원인:
- BT69 ComputeVelocity dropThroughJump 분기: velocity.y = 0
- velocity.y = 0 + 발판 위 IsGrounded=true 잔존 시:
→ KinematicObject FixedUpdate에서 IsGrounded 갱신 시 발판 통과 전 잔존 가능
→ jumpState = Jumping 영역에 IsGrounded=true → InFlight 전환 조건 X
→ jumpState = Jumping 영구 잔존
- Update §145: jumpState == Grounded 조건만 점프 입력 수용
→ 점프 입력 영구 무시
정정 (1행):
- velocity.y = 0f → -0.5f
- 즉시 낙하 시작 → IsGrounded=false 확보
- Jumping → InFlight → 착지 → Landed → Grounded 정상 사이클
- 점프 입력 정상 수용
효과:
- Drop-Through (Down + Jump 발판 위) 후 → 발판 통과 + 자연 낙하 + 다른 영역 착지
- 착지 후 점프 입력 정상 수용 (Grounded 영역 도달)
- 점프 모션 그대로 (jumpState = PrepareToJump → Jumping → InFlight → Landed → Grounded)
후속 의무:
- PD Refresh+Play 시각 검증 (Drop-Through 후 점프키 정상 작동)
- 정합 시 BT69+BT70+BT71 Drop-Through Input 영구 채택
PD 보고 (2026-05-08): "아래가 뚫려있지 않은 지형에서 아래로 점프 시도 시 점프가 되지 않는 버그"
근본 원인:
- BT69 코드: Down + Jump 입력 시 무조건 dropThroughTimer + dropThroughJump 활성
- ComputeVelocity: dropThroughJump=true 시 velocity.y=0 강제 (위 점프 X)
- = 지면(Layer 0) 위 Down + Jump → velocity.y=0 → 점프 자체 차단
정정 (Update 영역에 발판 위 검증 추가):
- Down + Jump 입력 시 footHit Raycast (Layer 16 mask 0.1m 아래)
- onJumpThroughPlatform = (footHit.collider != null)
- Drop-Through 발동 조건: downHeld AND onJumpThroughPlatform
- = 발판(Layer 16) 위만 Drop-Through 발동
- = 지면(Layer 0) 위 = 일반 점프 (velocity.y = jumpTakeOffSpeed)
효과:
- 발판 위 + Down + Jump → 발판 통과 + 점프 모션 + 자연 낙하 (BT69 영역 그대로)
- 지면 위 + Down + Jump → 일반 점프 (위로) ✅ (정정)
- Down 미입력 + Jump → 일반 점프 (그대로)
후속 의무:
- PD Refresh+Play 시각 검증
- 정합 시 BT69 + BT70 결합 = Drop-Through Input 패턴 영구 채택
PD 명시 (2026-05-08): "발판과 같이 아래가 뚫려있고 이동 가능한 영역이 있는 경우, 아래 방향키 상태로 점프하면 점프 모션과 함께 내려올 수 있도록"
표준 platformer 패턴 (Drop-Through Input):
- Player가 발판(Layer 16) 위 + Down 방향키 + Jump 키 동시 입력
- = Layer 16 mask 강제 OFF (DROP_THROUGH_DURATION=0.3초) → 발판 통과
- = velocity.y = 0 (위 점프 X·gravity로 자연 낙하)
- = jumpState = PrepareToJump (점프 애니메이션 발동·시각상 점프 모션)
변경 (PlayerController.cs 3영역):
1. 클래스 변수 추가:
- float dropThroughTimer (Layer 16 mask 강제 OFF 지속 시간)
- const float DROP_THROUGH_DURATION = 0.3f
- bool dropThroughJump (본 frame Drop-Through 점프 발동 분기)
2. Update 영역:
- Move Input 영역 y < -0.5 (Down) + Jump WasPressed → dropThroughTimer 활성 + dropThroughJump=true
- 매 frame dropThroughTimer 감소 (Time.deltaTime)
3. UpdateContactFilterForDropThrough 영역:
- isJumpingThrough 조건에 dropThroughTimer > 0 추가
- Drop-Through 활성 시 Layer 16 mask 강제 OFF
4. ComputeVelocity 영역:
- jump && IsGrounded 시 dropThroughJump 분기:
- dropThroughJump → velocity.y = 0 (위 점프 X)
- else → velocity.y = jumpTakeOffSpeed (기존 정상 점프)
효과 (PD 의도 정합):
- 일반 점프 (Jump only) = 위로 점프 (그대로)
- Drop-Through (Down + Jump) = 발판 통과 + 점프 모션 + 자연 낙하
- 0.3초 후 mask 자동 복원 (다른 발판 위 정상 착지 가능)
후속 의무:
- PD Refresh+Play 시각 검증 (발판 위 + Down + Jump → 통과·낙하 + 점프 애니메이션)
- 정합 시 BT49~BT65 영구 폐기 + R2 + BT68 + BT69 영역 영구 채택
PD 명시 (2026-05-08):
1. "대각선으로 점프로 벽 부분을 통과하려는 상황 → Player 점프 상태에서 밀려나는 현상" (애초에 통과 X 의무)
2. "전진하며 점프할 경우 앞이 막혀있으면 위로만 점프되어야 하는데 점프 자체가 막힘" (앞 막혀도 정상 점프 의무)
본 PM 직접 read 진단:
버그 1 (벽 통과) 원인:
- 자동 분류 영역(BT47/BT48)이 TileGround·TileGroundDark·TileGroundTop도 AutoForeground로 이동
- AutoForeground = Layer 16 + Drop-Through 패턴 (ascending mask OFF)
- = 대각선 점프 시 벽 Tile 통과 가능
버그 2 (점프 막힘) 원인:
- KinematicObject.PerformMovement line 164~165:
velocity.x *= 0; velocity.y = Mathf.Min(velocity.y, 0);
- = X 이동 시점 hit (앞 벽)에서도 velocity.y 영점 강제
- = 점프 시작 시 앞 벽 hit → 점프 속도 0 → 점프 자체 차단
정정:
1. KinematicObject.cs (버그 2):
- 공중 hit 처리 X·Y 분리:
- X 이동 시점 hit (앞 벽) → velocity.x = 0, velocity.y 보존 (점프 속도 유지)
- Y 이동 시점 hit (천장) → velocity.x·y 모두 cap (기존)
2. GameOptimizer.cs (버그 1):
- TileGround* (3종 — 지면·벽 의도) 자동 분류 제외 추가
- tileAsset.name.StartsWith("TileGround") → continue
- TileGround·TileGroundDark·TileGroundTop = Level 잔존·Layer 0·영구 충돌·통과 X
효과:
- 버그 1: 벽 통과 X (TileGround* = Layer 0 영구 충돌)
- 버그 2: 앞 막혀도 위로 점프 정합 (Y 속도 보존)
- 발판 동작 그대로 (TileFloating·MidgroundFiller·Building·cloud·hillside·midground·mountains 자동 분류)
- 나무·plant·fence·house 자체 통과 그대로
후속 의무:
- PD Refresh+Play 시각 검증 (대각선 점프 벽 통과 X + 앞 막힌 점프 작동)
- 본 PM Editor.log [BT48-MoveTiles] direct read
PD 보고 (2026-05-08): "발판의 위치가 1만큼 y로 올라갔는데 왜 그런거지?"
근본 원인:
- BT66 R2 — AutoForeground GameObject 신규 생성 (Grid 자식)
- 신규 생성 시 transform.localPosition = default (0, 0, 0)
- PD가 Level·Foreground GameObject를 y=-1로 직접 변경 (PD 시각 정정 작업)
- = AutoForeground (y=0) ↔ Level/Foreground (y=-1) → 1m 차이로 시각상 위로
정정 (1행 추가):
- 매 Play 시점 AutoForeground.transform.localPosition = PD Foreground localPosition (또는 Level)
- PD Foreground 우선 (가림막 영역과 동일 공간 보장) · 미존재 시 Level fallback
효과:
- AutoForeground 발판 시각 위치 = PD Foreground·Level 영역과 동일
- Drop-Through 패턴 작동 영역 동일 (Layer 16 + ContactFilter mask)
- 발판 위 착지 좌표 정합 (Player 영역과 정합)
후속 의무:
- PD Refresh+Play 시각 검증
- BT67 commit으로 R2 영역 완결
PD 명시 (2026-05-08): "R2로 진행해줘"
근본 원인 (BT65 진단):
- 본 PM 자동 분류 코드(BT47/BT48)가 PD 시각 분리 의도 침범
- PD Foreground = 직접 그린 가림막 시각만 + 본 PM 자동 분류 발판이 같은 GameObject 영역 혼재
R2 변경 (BT63 영역 + 분리):
1. PD Foreground GameObject = 가림막 시각만 (TilemapCollider2D Object.Destroy)
- PD 직접 그린 Tile 그대로·시각 표시 보존
- Player와 충돌 X (PD 시각 의도 정합)
2. AutoForeground GameObject 신규 생성 (Grid 자식)
- Tilemap + TilemapRenderer + TilemapCollider2D 자동 부착
- Layer 16 (Drop-Through)
- 자동 분류(BT47/BT48 임계값+작은 발판) SetTile 대상
3. PlayerController.UpdateContactFilterForDropThrough 영역 그대로 (Layer 16 mask 동적·BT63 영역 보존)
효과:
- PD 가림막 = 시각 표시·Player 통과 가능 (PD 의도 정합)
- 자동 분류 발판 = AutoForeground 영역·Drop-Through 패턴 (위 착지 + ascending 통과)
- BT49 None 차단 그대로 (tree·plant·fence·house 자체 통과)
매 Play 시점 동작:
- PD Foreground TilemapCollider Destroy
- AutoForeground 검색·없으면 신규 생성·Grid 자식·필수 컴포넌트 자동 부착
- 자동 분류 영역(BT48 임계값+작은 발판) Level → AutoForeground SetTile
후속 의무:
- PD Refresh+Play 시각 검증
- 본 PM Editor.log [BT48-MoveTiles] direct read
- 정합 시 BT49~BT65 영구 폐기 + feedback 메모리 등재
PD 명시 (2026-05-08): "직전 상태로 되돌려" + "에디터 상태에서는 박스 쳐진 가림막 부분만 Foreground인데 어째서 발판까지 영향을 받는거지?"
변경: fgTc.enabled = false 라인 제거 = BT63 정확 회귀.
본 PM 진단 (PD 의문 답변):
근본 원인 — 본 PM의 자동 분류 코드가 PD의 시각 분리 의도 침범:
- PD 의도: Foreground GameObject = PD 직접 그린 가림막 영역만 (시각 배경)
- 본 PM 코드 (BT47/BT48): Level Tile들을 GameObject.Find('Foreground') 영역으로 자동 이동 (SetTile)
- 결과: PD 가림막 + 본 PM 자동 분류 발판이 같은 Foreground GameObject 영역 혼재
- BT64 fgTc.enabled=false: 모든 Foreground Tile 충돌 X = 발판도 충돌 X = PD 보고 영역
= 자동 분류 영역이 PD 시각 분리 의도 침범 = 본 PM 핵심 오해.
PM 권고 (PD 결정 영역):
- 옵션 1: 자동 분류 영역 폐기 + PD가 발판 영역 직접 Tile Palette로 그리기 (표준 Unity 워크플로우)
- 옵션 2: 자동 분류 결과를 별도 GameObject (예: AutoForeground)에 SetTile = PD Foreground 분리
- 옵션 3: BT63 + 가림막 Tile asset (예: MidgroundFiller) 자동 식별 + 분리
후속 의무:
- PD 결정 영역 명시 후 본 PM 즉시 집행
- BT49~BT64 누적 16회 변경 영역 영구 폐기 의무
PD 명시 (2026-05-08): "BT63이 내가 원했던 기본 상태야. 이제 Grid 오브젝트의 자식 오브젝트인 Foreground가 플레이어와 충돌하지 않도록만 해봐"
변경 (BT63 영역 + 1행 추가):
- Foreground TilemapCollider2D 자동 부착 그대로 유지 (BT47 영역)
- 자동 분류 SetTile + SetColliderType 그대로 유지 (BT48·BT63 영역)
- 부착 직후 fgTc.enabled = false → 물리 충돌만 차단
효과:
- Foreground GameObject = Player와 충돌 X (PD 명시 정합)
- TilemapRenderer 시각 표시 그대로 (Layer 16·SortingOrder=5)
- Tile data·SetColliderType 영역 그대로 (BT63 영역 보존·롤백 가능)
- Level Tilemap = 영구 충돌 (지면·발판 역할)
미적용 (의도적):
- Object.Destroy 폐기 (data 보존·롤백 경로)
- Layer Matrix 변경 폐기 (Project Settings 영역 영향 X)
후속 의무:
- PD Refresh+Play 시각 검증
- 본 PM Editor.log [BT48-MoveTiles] direct read
- 정합 시 BT49~BT61 영구 폐기·feedback 메모리 등재
PD 명시 (2026-05-07): "이제 이 상태에서 나무가 충돌되는 것만 수정해봐"
변경 (BT62 = BT48 시점 + 1행 추가):
- Level → Foreground 자동 분류 영역에 None Tile 차단 추가:
if (tileAsset != null && tileAsset.colliderType == None) continue;
효과:
- BT48 영역 발판 동작 그대로 보존 (PD 정합 시점)
- tree·plant·fence·house (4종 None Tile) = 자동 분류 제외
- Level Tilemap 잔존 + Tile asset 자체 None Collider = 자연 통과 (충돌 X)
미적용 영역 (BT49 영역과 차이):
- 사후 복원 영역(Foreground 그려진 None Tile SetColliderType(None) 복원) 미추가
- 이유: PD 명시 = 나무 충돌만 정정 + BT48 영역 변경 최소화
Player.prefab·PlayerController.cs = BT62 영역 그대로 (BT48 시점).
BT49~BT61 누적 14회 변경은 BT62에서 이미 모두 폐기됨.
후속 의무:
- PD Refresh+Play 시각 검증
- 본 PM Editor.log [BT48-MoveTiles] direct read
- 나무·plant·fence·house 통과 + 발판 영역 정합 확증
PD 강한 어조 (2026-05-07): "또다시 발판을 통과할 수 없게 되었잖아!"
본 PM 자기검증 — 12회 가설 누적 부정확 자인:
- BT49 (None 차단·정합) → BT50/BT51 (Grid→Sprite 영역 효과 X)
- BT52/BT53 (카탈로그·decor=1 부정확)
- BT54 (Foreground 충돌 제거·발판 위 X)
- BT55 (BT47 회귀 시도·BT58 BoxCollider 영향)
- BT58 (BoxCollider BT47 회귀·점프 X 보고)
- BT59 (BT49 회귀 + Foreground 충돌 제거·발판 위 X)
- BT60 (자동 분류 폐기·발판 통과 X)
PD 명시 흐름 ('Foreground = Grid → Foreground 배경 의도') 정합 시도 모두 실패.
PD가 발판 통과·점프·위 착지 모두 정합 인식한 마지막 시점 = BT47 (commit 1024e08).
BT61 정정:
- git checkout 1024e08 -- Assets/Scripts/Mechanics/GameOptimizer.cs (BT47 시점 정확 회귀)
- BT47 영역 = Foreground TilemapCollider 자동 부착 + Layer 16 + Level→Foreground 임계값 자동 분류 + Sprite 강제
- Player.prefab BT58 그대로 (BT47 정합 영역)
- PlayerController.cs BT57 Debug.Log 그대로 (영향 X)
- diff: +38 / -46 (BT49~BT60 누적 영역 모두 폐기)
PD 의도 정합 (BT47 시점):
- 발판 위 착지 ✅ (Foreground TilemapCollider + Layer 16 + ContactFilter 동적 mask)
- 점프 ascending 통과 ✅ (PlayerController.UpdateContactFilterForDropThrough)
- 임계값 위 (worldY>=playerY+1.5) Tile 자동 분류
BT49 None 차단 영역(나무 통과) = BT47 시점에 미적용 = 나무도 발판처럼 충돌 영역 재발 가능 (PD 첫 보고 영역).
BT47 정합 우선 + 나무 충돌 영역 후속 PD 결정 영역.
본 PM 능력 한계 자인 — PD 추가 명시 영역 결정 영역 의무.
PD 보고 (2026-05-07): "지금은 발판 위에 올라갈 수 없게 되었어."
근본 원인 (본 PM 자기검증):
- BT49 자동 분류 (Level → Foreground 이동) = SetTile(null) 영역에서 Level 발판 Tile 제거
- Foreground TilemapCollider X (BT59) = Foreground 충돌 X
- = Level 발판 Tile 사라짐 + Foreground 영역 충돌 X
- = 발판 위 착지 X (PD 보고 영역)
BT60 정정:
- BT48 자동 분류 영역 폐기 (임계값+작은 발판 휴리스틱)
- BT49 사후 복원 영역 폐기 (None 처리)
- Foreground 자동 부착 영역 (TilemapCollider 제거 — BT59 영역) 그대로 유지
- 결과:
- Level Tilemap = Scene yaml 영역 그대로 (영구 충돌·발판·지면 역할)
- Foreground Tilemap = 시각만 (TilemapRenderer + Layer 16·TilemapCollider X)
PD 의도 정합 효과:
- Player가 Level 지면 위 착지 (영구 충돌)
- Foreground 영역 자유 통과 (충돌 X·시각만)
- BT47부터 누적된 Foreground Tile (Scene yaml) = 시각상 잔존·통과 가능
부수 영역:
- IsSmallAirPlatform 헬퍼 = dead code (사용 X·후속 정리 권고)
- 변경 전 자동 분류 영역 코드 = git history 9adfc64(BT49)·92f102e(BT59) 보존
PD 명시 (2026-05-07): "BT49 정정 (commit 9adfc64) 시점에서 Foreground에 충돌체크만 없애면 될거 같은데?"
변경:
1. GameOptimizer.cs = git checkout 9adfc64 영역 회귀 (BT49 자동 분류 + None 차단 + colliderType 존중 + 사후 복원)
2. Foreground 자동 부착 영역 정정:
- TilemapCollider2D 자동 부착 폐기
- 기존 TilemapCollider2D Object.Destroy
- fgTc null 유지 → 사후 복원 영역 자동 skip
결과 (PD 의도):
- Foreground Tilemap = 시각만 (TilemapRenderer + Layer 16·TilemapCollider X)
- BT48 자동 분류 (임계값+작은 발판) = SetTile 작동·ProcessTilemapChanges X (fgTc null)
- Level Tilemap = 영구 충돌 (발판·지면 역할)
- Player가 Level 지면 위 착지 + Foreground 영역 자유 통과
Player.prefab BoxCollider2D BT58 영역 그대로 (BT47 정확 회귀: 0.45×1.15 + offset 0,0.1)
PlayerController.cs BT57 Debug.Log 그대로 (Drop-Through 영역 폐기로 영향 X)
후속 의무:
- PD Refresh+Play 시각 검증
- Editor.log [BT48-MoveTiles] 직접 read (이름 BT48이지만 실제 BT49 회귀 코드)
- 정합 시 BT55+BT58 영역 폐기 채택 영구화
PD 강한 어조 (2026-05-07): "이전에는 잘 되었는데 왜 복구를 못하는거야?"
본 PM git diff 1024e08(BT47) vs HEAD 직접 진단:
- Player.prefab BoxCollider2D = 유일 핵심 차이 (BT56 변경)
- GameOptimizer.cs = BT49 None 차단 + BT51 사후 복원 추가 (restored=0 영향 X)
- PlayerController.cs = BT57 Debug.Log만 (영향 X)
- BT55 자동 분류 [BT55-MoveTiles] moved=1389 (BT47 정상 정합)
- Player Layer 13 / Foreground Layer 16 / Layer Matrix 13↔16 ON 모두 정합
= BT56 BoxCollider 변경이 발판 동작 영향 = 본 PM 가설.
정정 — BT47 정확 회귀:
- m_Size (0.4, 0.9) → (0.45, 1.15)
- m_Offset (0, -0.125) → (0, 0.1)
효과 (BT47 시점 PD 정합 영역 회귀):
- 발판 위 착지 ✅ (BT47 시점 정합)
- 점프 ascending 통과 ✅ (BT47 시점 정합)
- 좁은 통로 영역 = 1 cell 세로 통과 X 회귀 (BT56 의도 폐기)
좁은 통로 영역은 BT55+BT58 정합 확증 후 별도 정정 후속:
- 옵션 1: PD가 좁은 통로 영역 1 cell 세로 → 2 cell 세로로 변경 (게임 디자인)
- 옵션 2: BoxCollider 절충 영역 (예: 0.45×0.95) — 발판 영역 영향 미세
- 옵션 3: PD 결정
본 PM 가설 한계 자인:
- BT47 정확 회귀 = PD가 BT47 시점 정합 인식 영역
- 그러나 BT56 변경이 정확히 어느 영역에서 영향 X 영역 = 미식별
- PD Refresh+Play 시각 검증 의무
- 정합 시 BT55+BT58 결합 = 발판 동작 복원 + 숨겨진 통로 영역 별도 진단
PD 보고 (2026-05-07): "발판을 다시 통과해서 이동하거나 점프할 수 없게 되었어"
본 PM 알고리즘 영역 진단 결과 (모두 정합):
- BT55 자동 분류 [BT55-MoveTiles] moved=1389 (BT47 정합)
- Player Layer 13 / Foreground Layer 16
- Layer Matrix 13 ↔ 16 충돌 ON
- PlayerController.UpdateContactFilterForDropThrough 표준 패턴
= 알고리즘 영역 정합 + PD 보고 점프 X = 본 PM 미식별 영역.
BT57 진단 Debug.Log 추가:
- 출력 시점: 점프 시점 (jump || PrepareToJump || Jumping || InFlight velY>0.5)
- 출력 영역: jumpState·velocity.y·standingOnPlatform·mask16(Layer 16 mask)·transform.y·bounds.min.y
- log spam 방지 (점프 시점만)
PD Refresh+Play 후 본 PM Editor.log [BT57-DropThrough] direct read 후 진단:
- jumpState 영역 정상 전환 검증 (Grounded → PrepareToJump → Jumping)
- mask16 = false (ascending 시 mask OFF) 확증
- standingOnPlatform 영역 정상 검출 검증
알고리즘 정합 + 진단 결과로 후속 정정 영역 결정.
PD 가설 (2026-05-07): "이 위치의 캐릭터 콜라이더 때문에 이동하지 못하는게 아닌지 체크 + 크기 조절"
진단 (본 PM 직접 read):
- 변경 전: m_Size (0.45, 1.15) + m_Offset (0, 0.1)
- Tile cell size = 1.0 (Unity 표준)
- 세로 1.15 > 1.0 = 1 cell 세로 통로 통과 X (Collider 머리·모자가 Tile 충돌)
- = PD 가설 정확
정정:
- m_Size: (0.45, 1.15) → (0.4, 0.9)
- m_Offset: (0, 0.1) → (0, -0.125)
근거:
- 가로 0.4 = 좁은 통로 통과 margin 0.6 (Tile 가로 1.0 기준)
- 세로 0.9 = 1 cell 통로 통과 margin 0.1 (Tile 세로 1.0 기준)
- offset y -0.125 = 모자 영역 제외·발 영역 정합 (sprite 1.43×1.43 중심 기준 발 영역)
효과:
- 캐릭터 모자 = Collider X = 좁은 통로 통과 가능
- 발판 위 착지 정합 (발 영역 Collider)
- Enemy 충돌 정합 (본체 영역 보존)
PD Refresh+Play 시각 검증 후 정합 시 BT55 + BT56 결합 효과 확증. 부정합 시 size·offset 미세 조정 후속.
PD 명시 (2026-05-07):
1. "발판은 위에 설 수 있어야 해"
2. "내가 말한건 Grid → Foreground를 말한거야" (이미지 첨부)
3. "이전 버전처럼 발판을 통과해서 이동하거나 점프할 수 있도록 되돌려"
변경:
1. BT54 폐기 — Foreground TilemapCollider2D 자동 부착 회복 (Drop-Through 패턴 복원)
2. 자동 분류 영역 BT47 정확 회귀:
- 임계값(worldY >= playerY+1.5) 분류
- Sprite 강제 (BT47 호환·sprite 빈 픽셀 영역 점프 통과 보존)
- BT49 None 차단 유지 (tree·plant·fence·house 자체 통과)
3. 폐기:
- BT48 작은 발판 휴리스틱 (가로≤8+위·아래 빈)
- BT50 Grid→Sprite 이동 시 강제
- BT52 TileFloating* 단일 매칭
- BT53 카탈로그 8종 (TileFloating* + 배경·건물 7종)
4. 사후 복원 영역 (BT51 None 처리) 유지
효과 (PD 명시 정합):
- 발판 위 착지 (Foreground TilemapCollider + Layer 16 + ContactFilter 동적 mask)
- 점프 ascending 통과 (PlayerController.cs UpdateContactFilterForDropThrough — BT40 개발팀장 진단)
- 모든 비-None Tile 자동 분류 (BT47 시점 moved=1389 정합 회귀)
- tree·plant·fence·house 자체 통과 (BT49 None 차단)
본 PM 6회 가설 누적 부정확 자인:
- BT49 None 차단 (정합·유지)
- BT50 Grid→Sprite 이동·사후 강제 (효과 X)
- BT51 사후 Grid→Sprite 폐기 (효과 X)
- BT52 TileFloating* 단일 (decor=0 부정확)
- BT53 카탈로그 8종 (decor=1 부정확·1266개 미식별)
- BT54 Foreground TilemapCollider 제거 (발판 위 착지 X — PD 의도 부정합)
→ BT47 정합 영역 회귀 = PD 명시 "이전 버전처럼" 정합
후속 의무:
- PD Refresh+Play 시각 검증 + 본 PM Editor.log [BT55-MoveTiles] direct read
- BT49 후 "두 레이어 겹친 숨겨진 길 통과 X" 보고 영역 재발 시 PD 결정 영역
Debug.Log: [BT55-MoveTiles] moved=N (BT47 임계값 회귀·Sprite 강제·BT49 None 차단·thresholdY=...)
PD 결정 (2026-05-07): "그냥 단순히 Foreground에 충돌체크만 없애면 되지 않을까?"
변경:
- BT47 Foreground TilemapCollider2D 자동 부착 영역 폐기
- 기존 TilemapCollider2D Object.Destroy
- fgTilemap·fgTc null 유지 → 자동 분류(§83~) + 사후 복원(§129~) 자동 skip
- Foreground GameObject Layer 16 유지 (시각 정합)
영향 (PD 사전 명시 + 인지):
- 모든 Foreground Tile 충돌 X = 발판 위 착지 X (Drop-Through 패턴 폐기)
- BT47부터 자동 분류로 Foreground에 누적된 Tile들 = 시각만·자유 통과
- Level Tilemap (TileGround·TileGroundTop 1266개)만 영구 충돌 유지
본 PM 5회 가설 누적 부정확 후 PD 직접 단순 해결 채택:
- BT49 None 차단 (효과 X·restored=0)
- BT50 Grid→Sprite 강제 (효과 X·forced=0)
- BT51 사후 Grid→Sprite 폐기 (효과 X·restored=0)
- BT52 TileFloating* 단일 (decor=0 부정확)
- BT53 카탈로그 8종 확장 (decor=1 부정확·1266개 미식별)
→ PD 단순 제안 = 5회 가설 모두 우회
롤백 경로 (pm-auditor 권고):
- BT47 자동 분류 영역 + 사후 복원 영역 코드 보존 (fgTilemap null check skip만 추가)
- 회귀 시 fgTc 자동 부착 영역 회복 → 자동 분류 재가동 가능
후속 의무:
- PD Refresh+Play 시각 검증 + 본 PM Editor.log direct read
- 발판 위 착지 보존 의도 시 BT54 회귀 또는 카탈로그 v1.2 전환
Debug.Log: 자동 분류·사후 복원 출력 모두 fgTilemap null로 skip → BT54 시점 출력 X
PD 결정 (2026-05-07): "PM 권고안대로 해"
근본 원인 (Editor.log 직접 read):
- BT47 정상 시점 [BT47-MoveTiles] moved=1389 = PD 통과 가능 인식 영역
- BT52 보수적 후 [BT52-Classify] floating=122 = TileFloating* 3종만 = 배경·건물 7종 Level 잔존 = 영구 충돌
- PD 보고: "기존과 다르게 레벨 오브젝트가 생성됨·정상적인 플레이가 안 되고 있어"
- = 배경·건물 7종이 BT47 정상 시점 자동 분류된 결과로 추정 (가설)
옵션 A1 카탈로그 8종 SOT (GameOptimizer.cs SetupJumpThroughPlatforms 영역):
1. TileFloating* (3종) — 공중 발판 (Drop-Through):
- TileFloatingLeftEdge·TileFloatingRightEdge·TileFloatingTileMiddle
2. 배경·건물 (7종 — 자동 Foreground 이동·Drop-Through):
- ShortBuilding·TallBuilding·MidgroundFiller (건물·배경 채움)
- cloud·hillside·midground·mountains (배경 Parallax)
Level 잔존 (영구 충돌 또는 자연 통과):
- TileGround·TileGroundDark·TileGroundTop (3종 지면 — 영구 충돌)
- tree·plant·fence·house (4종 None — 자체 통과)
마이그레이션 X (PD 옵션 A 결정 유지 — Foreground 변경 X·위험 최소화).
사후 복원 영역 (BT51 None 처리) 유지.
가설 한계:
- 배경·건물 7종이 PD 의도 발판/통과 영역인지 확증 X (PD 시각 검증 후 정정 가능)
- 가설 실패 시 카탈로그 v1.1 재조정 또는 옵션 A2 (PD 직접 17종 명시) 전환 의무
Debug.Log: [BT53-Classify] moved=N (floating=F decor=D)
본 PM 직접 Editor.log read 의무 (PD 시각 검증 결과 보고 직후).
PD 결정 (2026-05-07): "A안대로 진행해"
근본 원인 (Editor.log 직접 read):
- [BT48-MoveTiles] moved=3524 비정상 (정상 1389 대비 2.5배)
- BT47/BT48 휴리스틱(임계값 playerY+1.5·작은 발판 가로≤8+위·아래 빈) = 정상 길·배경 벽지까지 자동 Foreground 이동
- → "숨겨진 레이어가 정상적인 길을 막고 있어" 근본 원인
- BT49/BT50/BT51 사후 복원 가설 모두 효과 X (restored=0/forced=0) — 4회 누적 부정확 자인
옵션 A 변경 (PD 승인 범위):
1. 휴리스틱 폐기: 임계값·작은 발판·BT49 None 차단 영역 모두 폐기
2. 새 알고리즘: Tile asset 이름 prefix "TileFloating" 3종만 자동 분류
(TileFloatingLeftEdge·TileFloatingRightEdge·TileFloatingTileMiddle — 카탈로그 17종 중 명시적 Floating 의도 3종)
3. 그 외 모든 Tile = Level 잔존 (PD Inspector 직접 분류 — 표준 Unity Tilemap 워크플로우)
4. 마이그레이션 X (PD 옵션 A 결정 — Foreground 변경 X·위험 최소화)
5. IsSmallAirPlatform 헬퍼 폐기 (dead code)
6. 사후 복원 영역 (BT51 None 처리) 유지
후속 의무:
- PD Refresh+Play 시각 검증 + 잘못 분류된 영역 발견 시 PD 직접 Inspector 정정 또는 카탈로그 확장 안건
- 본 PM 직접 Editor.log [BT52-Classify] floating moved=N read 의무
Debug.Log: [BT52-Classify] floating moved=N (Level→Foreground TileFloating* 3종만)
PD 보고 (BT50 후): "숨겨진 길이 최상단에 나와버려서 길을 다 막고 있어"
원인 가설:
- BT50 사후 복원 영역 = Foreground에 PD가 직접 그린 Grid Tile을 무차별 Sprite 강제
- PD Editor 직접 그린 Tile = default colliderType (Tile asset의 Grid) 의도
- 무차별 Sprite 강제 = PD 의도 형상 변형 → 통과 영역 차단
정정:
- 사후 복원: None Tile만 SetColliderType(None) 복원 (BT49 영역 정합 회귀)
- Grid→Sprite 강제 코드 영역 폐기
- 이동 시 Grid→Sprite 강제(상단)는 유지 — Level→Foreground 이동 신규 Tile만 Sprite 적용
효과:
1. Level→Foreground 이동 신규 Tile = Sprite Collider (BT49 후 통과 X 정정 유지)
2. PD 직접 그린 Grid Tile = default Grid Collider (PD 의도 형상 보존)
3. None Tile = 배경 통과 (BT49 영역 정합)
가설 한계 (pm-auditor Major #1 자인):
- BT50 사후 복원이 진짜 원인 확증 X. PD 시각 검증 후 효과 X 시 즉시 추가 가설 (Layer Matrix·UpdateContactFilter·Tilemap sortingOrder·Tile 위치 좌표) 전환 의무.
Debug.Log: [BT51-FgRefine] None restored=N (forced Sprite 카운터 폐기)
PD Refresh+Play 시 숨겨진 길 통과 + 이전 발판 정상 동작 시각 검증.
본 PM 직접 Editor.log read 의무 (PD 시각 검증 결과 보고 직후).
근본 원인 가설:
- Tile asset 카탈로그 17종: 13종 colliderType=1 (Grid·사각형) / 4종 0 (None — tree·plant·fence·house)
- 이전 BT47 = SetColliderType(Sprite) 무차별 강제 → 픽셀 정확 Collider (sprite 빈 영역 점프 통과 가능)
- BT49 = colliderType 존중 → Grid Tile은 SetColliderType(Grid) → 사각형 Collider (빈 영역 X) → 통과 차단
표준 패턴 정정 (BT49 metadata 존중 유지 + 이전 BT47 호환):
1. 이동 시: None=None (배경) / Grid→Sprite (강제) / Sprite=Sprite (그대로)
2. 사후 복원: Foreground 이미 그려진 Grid Tile = SetColliderType(Sprite) 강제 + ProcessTilemapChanges
- Debug.Log: [BT50-FgRefine] None restored=N / Grid→Sprite forced=M
가설 검증 의무 (pm-auditor Minor 권고):
PD 시각 검증 실패 시 Layer Matrix·UpdateContactFilter 가설 즉시 전환.
PD Refresh+Play 시 Console [BT50-FgRefine] forced=M + 숨겨진 길 통과 시각 검증.
본 PM 직접 Editor.log read 의무 (PD 시각 검증 결과 보고 직후).
근본 원인:
- BT47 line 106 `SetColliderType(pos, Sprite)` 무차별 강제
- tree.asset `m_ColliderType: 0` (None — 배경 의도) 무시 → 발판처럼 충돌
표준 패턴 정정 (3종 결합):
1. 분류 단계: Tile asset이 ColliderType.None = Foreground 이동 차단 (Level 잔존)
2. Foreground 이동 시: Tile asset 원래 colliderType 존중 (None=배경 / Sprite=발판)
3. Foreground 사후 복원: 이미 그려진 None Tile = SetColliderType(None) + ProcessTilemapChanges
Tile asset m_ColliderType 메타데이터 = 충돌 의도 SOT.
- m_ColliderType: 0 (None) = 배경 (충돌 X · 통과)
- m_ColliderType: 2 (Sprite) = 발판/지형 (충돌 ON)
발판 의도 Tile은 m_ColliderType=Sprite 명시 필수.
후속 점검 권고: 모든 Tile asset의 m_ColliderType 일제 검토 (PD 디자인 의도 정합 검증).
PD Refresh+Play 시 Console [BT49-Background] restored=N + 나무 통과 시각 검증.
본 PM 직접 Editor.log read 의무 (PD 시각 검증 결과 보고 직후).
BT47 단일 임계값(playerY+1.5) 의존 한계: 첨부 이미지 같은 낮은 위치 발판 누락.
BT48 분류 조건 2종 결합:
- (a) 임계값 위 = 무조건 공중 (BT47 호환)
- (b) 임계값 아래여도 위·아래 인접 Tile 모두 빈 공간 + 가로 연속 길이 ≤8 tile = 작은 공중 발판
→ 일반 지면(통상 10+ tile) 잘못 분류 방지 + PD 의도 발판 자동 포함
표준 One-Way Platform / Drop-Through 패턴 정합 (Layer 16 + ContactFilter2D 동적 mask).
8 tile 임계값 = 추정 proxy (일반 platformer 지면 10+ tile 가정·실측 미확증).
PD 시각 검증 후 의도와 다른 발판 분류 시 임계값 조정 또는 알고리즘 재설계 후속.
PD Editor Refresh+Play 시 Console [BT48-MoveTiles] high=N smallAir=M 출력으로 분류 결과 검증 가능.
본 PM 직접 Editor.log read 의무 (PD 시각 검증 결과 보고 직후).
PD 보고: 공중 발판 통과 X 여전 ([BT30-Collide] name='Level' layer=0)
PD 진단: prefab 영역 영역 영역
본 PM 자인:
- Level Tilemap = 일반 지면 + 공중 발판 통합 = 단일 GameObject 모든 Tile 동일 동작 = 분리 X
- 공중 발판 부딪힘 = Level Tilemap 일부 Tile
정정 (런타임 자동 분리):
- Player 시작 Y + 1.5 위 Tile = 공중 발판 영역 → Foreground Tilemap 영역 자동 이동
- Level Tilemap의 해당 Tile 영역 제거
- Foreground Tile m_ColliderType=Sprite 강제
- 양 Tilemap ProcessTilemapChanges 영역 영역 영역
동작:
- Level Tilemap (Layer 0) = 일반 지면·벽 (영구 충돌)
- Foreground Tilemap (Layer 16 + Sprite Collider) = 공중 발판 (Drop-Through)
- Player 점프 → 공중 발판 통과 / 벽 영역 막힘
- Player 걷기 → 공중 발판 옆 통과 / 일반 지면 영역 영역
PD 진단: '접근 방법이 잘못 된 것 같아. 프리펩을 수정해야하는게 아닐까?'
진단:
- BT45 모든 Tilemap Layer 16 = 벽도 Drop-Through = 점프 시 벽 통과 (PD 보고 1)
- Foreground Tile asset m_ColliderType=None 가능성 → TilemapCollider2D 추가해도 Tile별 Collider 미생성 = 통과 X 영역 영역 (PD 보고 2)
정정:
- Level Tilemap (name='Level' + TilemapCollider2D) = Layer 0 (일반 지면·벽 영구 충돌)
- Foreground Tilemap = TilemapCollider2D + Layer 16 + 모든 Tile m_ColliderType=Sprite 런타임 강제 (HasTile 영역 영역 SetColliderType + ProcessTilemapChanges)
- Alien 등 별개 BoxCollider2D = Layer 16
동작:
- 시작 → Level Tilemap 위 정착 (Layer 0)
- 점프 영역 → 벽(Layer 0) 막힘 정합 / Foreground 발판(Layer 16) mask OFF 통과
- 걷기 옆 영역 발판 → footHit X → mask OFF → 통과
- 점프 후 발판 위 → footHit Layer 16 → standingOnPlatform=true → 착지
깃 관리자