218 lines
12 KiB
Markdown
218 lines
12 KiB
Markdown
# EerieVillage 대화로그 — 2026-05-08
|
|
|
|
---
|
|
|
|
## 엔트리 1. BT5-Dev 발판 시스템 영구 마무리 (BT63~BT75)
|
|
|
|
**시각**: 2026-05-08
|
|
**주체**: 총괄PM
|
|
**영역**: BT5-Dev Phase 3 파일럿 (개발) — 발판 시스템 + 플레이어 조작
|
|
**유형**: PD 시각 검증 반복 + 본 PM 누적 가설 부정확 자인 후 PD 명시 영역 회귀 + 영구 채택
|
|
|
|
### 배경
|
|
|
|
BT5-Dev 발판 시스템 영역 (BT47~BT74)은 PD 시각 검증 반복 + 본 PM 가설 17회 누적 부정확 자인 후 R2 (AutoForeground 분리) 채택으로 PD 의도 정합 영역 도달. 본 엔트리는 BT75 영구 마무리 commit으로 시행착오 주석 정리 + dead code 제거 + PD 명시 채택 영역 결과 보고.
|
|
|
|
### 영구 채택 영역
|
|
|
|
#### 1. GameOptimizer.cs — Foreground 분리 + 자동 분류
|
|
|
|
| 단계 | 동작 |
|
|
|------|------|
|
|
| Init | Layer Matrix Player(13) ↔ Enemy(14) 충돌 OFF |
|
|
| SetupJumpThroughPlatforms | Level Tilemap = Layer 0 (지면·벽 영구 충돌) / 그 외 비-trigger Collider2D = Layer 16 |
|
|
| PD Foreground | TilemapCollider2D `Object.Destroy` → 가림막 시각만 (PD 직접 그린 영역) |
|
|
| AutoForeground (Grid 자식·신규) | Tilemap + TilemapRenderer + TilemapCollider2D + Layer 16 자동 부착 + transform.localPosition 동기화 |
|
|
| 자동 분류 | Level → AutoForeground SetTile + Sprite 강제 |
|
|
| 제외 조건 | colliderType=None (tree·plant·fence·house) / 이름 prefix `TileGround` (지면·벽) |
|
|
| 분류 조건 | `worldY ≥ playerY+1.5` 또는 작은 공중 발판 (가로≤8 + 위·아래 빈) |
|
|
|
|
#### 2. PlayerController.cs — Drop-Through 패턴 + 입력 처리
|
|
|
|
| 영역 | 동작 |
|
|
|------|------|
|
|
| `JUMP_THROUGH_LAYER = 16` | AutoForeground·Foreground 통과 대상 Layer |
|
|
| `dropThroughTimer (0.3초)` | Down + Jump 입력 시 Layer 16 mask 강제 OFF |
|
|
| `jumpAscentTimer (0.4초)` | 점프 ascending·정점 영역 mask 강제 OFF (jitter 차단) |
|
|
| `dropThroughJump` | Drop-Through 점프 시 `velocity.y = -0.5f` (즉시 낙하·IsGrounded=false 확보) |
|
|
| `UpdateContactFilterForDropThrough` | ascending·정점·Timer 활성 시 mask OFF / footHit 3점 Raycast (좌·중·우) standingOnPlatform 안정 검출 |
|
|
| 밀림 강제 Drop-Through | 점프·낙하 중 `velocity.y > -1.5` + 수평 입력 + 발판 가장자리 일시 검출 → `dropThroughTimer` 강제 활성 |
|
|
| Down + Jump 발동 조건 | 발판(Layer 16) 위 footHit 검출 시만 (지면 위 = 일반 점프) |
|
|
|
|
#### 3. KinematicObject.cs — 공중 hit X·Y 분리
|
|
|
|
| 영역 | 동작 |
|
|
|------|------|
|
|
| 공중 hit (`!IsGrounded`) | X 이동 hit (앞 벽) = `velocity.x = 0`만 (점프 속도 보존) / Y 이동 hit (천장) = `velocity.x` + `velocity.y = Mathf.Min(velocity.y, 0)` |
|
|
|
|
### 플레이어 조작 시스템 동작 카탈로그
|
|
|
|
| 입력 | 위치 | 결과 |
|
|
|------|------|------|
|
|
| Jump only | 어디서든 | 일반 점프 (위로) |
|
|
| Jump + 수평 이동 | 발판 옆 | 정점 영역 mask 강제 OFF → 깔끔 통과 (jitter 차단) |
|
|
| Jump + 전진 (앞 벽) | 지면 | velocity.x=0 + velocity.y 보존 → 위로만 점프 |
|
|
| Down + Jump | 발판 위 | Drop-Through (발판 통과 + 점프 모션 + 자연 낙하) |
|
|
| Down + Jump | 지면 위 | 일반 점프 (위로) |
|
|
| 점프 ascending | 발판 영역 | mask OFF → 통과 |
|
|
| 점프 descending | 발판 위 | footHit 3점 검출 → standingOnPlatform=true → 착지 |
|
|
|
|
### Tile asset 분류 카탈로그 (PD 명시 정합)
|
|
|
|
| 분류 | Tile asset | 동작 |
|
|
|------|-----------|------|
|
|
| 공중 발판 (자동 분류·Drop-Through) | TileFloatingLeftEdge·RightEdge·TileMiddle | Layer 16 + Sprite Collider |
|
|
| 배경·건물 (자동 분류·Drop-Through) | ShortBuilding·TallBuilding·MidgroundFiller·cloud·hillside·midground·mountains | Layer 16 + Sprite Collider |
|
|
| 지면·벽 (Level 잔존·영구 충돌) | TileGround·TileGroundDark·TileGroundTop | Layer 0 + Tile asset Grid Collider |
|
|
| 배경 (None Tile·자체 통과) | tree·plant·fence·house | Layer 0 + Tile asset None Collider |
|
|
|
|
### 시행착오 영역 (정리·git history 영구 보존)
|
|
|
|
BT49~BT65 영역 누적 변경 17회 = 본 PM 가설 부정확 + PD 시각 검증 반복. R2 (BT66) 채택 후 영구 마무리 도달. 시행착오 commit 영역 git history 그대로 보존 — 본 BT75 = 시행착오 주석·dead code 정리만.
|
|
|
|
핵심 PD 명시 흐름:
|
|
1. "Foreground = Grid → Foreground 배경 의도" (PD 정정 — 본 PM 근본 오해 자인)
|
|
2. "발판은 위에 설 수 있어야 해" (PD 의도 명시)
|
|
3. "이전 버전처럼 발판 통과·점프 가능" (BT47 정합 회귀 명시)
|
|
4. "BT48로 복귀해봐" (commit hash 직접 명시)
|
|
5. "BT63 = 기본 상태" (PD 정합 인식)
|
|
6. "R2로 진행해줘" (AutoForeground 분리 채택)
|
|
|
|
### 잔여 영역 (PD 명시 — 추후 필요 시 재요청)
|
|
|
|
- BT74 밀림 강제 Drop-Through 영역 일부 잔존 가능 (PD 시각: "바로 떨구는 것 적용 X 느낌"). PD 명시 = "넘어가고 플레이어 조작 시스템 완성".
|
|
|
|
### 산출물
|
|
|
|
- `Assets/Scripts/Mechanics/GameOptimizer.cs` (Write 전체 재작성·시행착오 주석 정리)
|
|
- `Assets/Scripts/Mechanics/PlayerController.cs` (Edit 부분 정리·Drop-Through 패턴 영구)
|
|
- `Assets/Scripts/Mechanics/KinematicObject.cs` (Edit 부분 정리·X·Y 분리 영구)
|
|
- EerieVillage commit `2ebacf6` (BT75) — 발판 시스템 영구 마무리
|
|
|
|
### 관련 규칙·자산
|
|
|
|
- **C2 근본 해결** — BT75 시행착오 영역 정리·핵심 영역 보존
|
|
- **C5·C23·C44** — 본 PM 17회 가설 부정확 누적 자인 + PD 명시 영역 직접 따름
|
|
- **C36** — PD 명시 승인 영역만 변경
|
|
- **C18** — 양 git push 정합 (EerieVillage `2ebacf6` + BurningTimes 본 commit)
|
|
- `feedback_pm_solution_proactive_proposal` — 본 PM 표준 패턴 보유 한계 자인 후 PD 직접 명시 의무
|
|
- `feedback_pm_excessive_decision_request` — 옵션 명시 + PM 권고 + PD 결정 영역
|
|
- `feedback_pm_mcp_direct_implementation` — 본 PM Editor.log·Scene yaml·git diff direct read 능동 진단
|
|
|
|
### 후속 영역
|
|
|
|
- BT5-Dev 발판 시스템 = **완료 영역**. 활성 PD 지시 로그 BT5-Dev 영역 갱신 의무.
|
|
- 잔여 영역 (BT74 밀림 일부 잔존) = PD 명시 = 추후 필요 시 재요청 영역.
|
|
- 차기 BT5-Dev 영역 = 다른 메카닉 또는 컨텐츠 영역 (PD 결정).
|
|
|
|
---
|
|
|
|
## 엔트리 2. BT5-Dev 몬스터 시스템 (BT76~BT109)
|
|
|
|
**시각**: 2026-05-08 후반
|
|
**주체**: 총괄PM
|
|
**영역**: BT5-Dev Phase 3 파일럿 (개발) — 몬스터 리소스 교체·자동 patrol·낭떠러지 차단·밟기 처치
|
|
**유형**: PD 시각 검증 반복 + 본 PM 23회 가설 누적 부정확 자인 후 PD 근본 진단 채택 영역 도달
|
|
|
|
### 영역 카탈로그
|
|
|
|
#### Phase 1 — 몬스터 리소스 교체 (BT76~BT79)
|
|
- BT76: Enemy.prefab SpriteRenderer = M001_idle01 교체
|
|
- BT77: 4개 .anim (Idle·Run·Hurt·Death) sprite reference 영역 M001 순환 매핑 (Python 자동)
|
|
- BT78: M001 sprite fileID 영역 정확 매핑 (Multiple sprite mode internalID·BT76/BT77 정정)
|
|
- BT79: Enemy flipX 영역 PlayerController 정합 (좌측 sprite 기준 우측 이동 시 flipX=true)
|
|
|
|
#### Phase 2 — 자동 patrol·절벽 검출 (BT80~BT109)
|
|
- BT80: Enemy y+0.5 + 자동 patrol (생성 위치 ±100~150 random 왕복) + 절벽 검출 (PD 3건 일괄)
|
|
- BT81~BT85: 벽 정지·낭떠러지·flipX·이동속도·미세 밀림 영역 정정 (PD 시각 검증 반복)
|
|
- BT86: 속도 2배 느림 (maxSpeed 7→3.5) + 절벽 즉시 phase 전환
|
|
- BT87: 벽 충돌 즉시 전환·순찰 거리 절반 (50~75)
|
|
- BT88: phase+2 (시작 위치 복귀 폐기·즉시 반대 방향)
|
|
- BT89~BT93: 즉시 벽 검출·1~3초 대기·KinematicObject 정합 (transform+body 동시 push)
|
|
- BT94: phase cooldown 0.5초·시작 시 안전 거리 측정
|
|
- BT95: PatrolPath path 영역 12건 제거·velocity 즉시 반대 방향 (PD 명시)
|
|
- BT96: TriggerReverse 함수 (transform+body+velocity+move 통합 처리)
|
|
- BT97: Start 시점 안전 거리 측정 (AutoForeground Tile data 활성 후)
|
|
- BT98: R1 방어 영역 (발 자체 검사·시작 위치 텔레포트 복귀)
|
|
- BT99~BT101: EnemyWall Layer 18·투명벽 자동 생성 → 폐기 (PD Foreground TilemapCollider 부착·통로 막힘)
|
|
- BT102: 투명벽 폐기·y < startY-1.0 시 시작 위치 텔레포트
|
|
- BT103: 정확 측정 (Capsule 발 영역·0.1m 간격·0.5m margin)
|
|
- BT104: EnemyDeath 강화 (enabled=false·death 애니메이션·1초 Destroy) + 시작 위치 발판 검증·자동 재배치
|
|
- BT105: 제자리 사망 (body.simulated=false) + margin 0.5→2.0m
|
|
- BT106: y 영역 영구 고정 (떨어짐 영구 차단) — 폐기 (BT107 공중 부유 원인)
|
|
- BT107: Tilemap cell 기반 측정 (PD 근본 진단·Raycast 영역 부정확 폐기)
|
|
- BT108: 측정 결과 Debug.Log 진단
|
|
- BT109: footPos cell 영역 정정 (bounds.min.y - 0.5f·발판 cell 정확) + BT104 Raycast 재배치 폐기
|
|
|
|
### 영구 채택 영역 (BT109 정합)
|
|
|
|
#### EnemyController.cs
|
|
- 자동 patrol 4-phase (우측 random·시작 복귀·좌측 random·시작 복귀)
|
|
- patrolMinRange/patrolMaxRange = 50/75 (Inspector)
|
|
- Tilemap cell 기반 안전 거리 측정 (Start 시점 1회·AfterSceneLoad 후)
|
|
- TriggerReverse 영역 (절벽·벽 검출 시 transform+body+velocity 통합)
|
|
- phase cooldown 1.0초 (BT94 영역)
|
|
- waitTimer 1~3초 random (arrive 시점만)
|
|
- stuckTimer 50ms (벽 정지 fallback·BT90 영역)
|
|
- BT102 텔레포트 영역 (떨어짐 검출 후 시작 위치 복귀·보조 fallback)
|
|
|
|
#### EnemyDeath.cs (Gameplay)
|
|
- _collider.enabled = false
|
|
- control.enabled = false
|
|
- enemy.enabled = false (patrol 영역 정지)
|
|
- body.simulated = false (gravity X·제자리 사망)
|
|
- animator.SetTrigger("death")
|
|
- Object.Destroy(gameObject, 1f)
|
|
|
|
#### GameOptimizer.cs
|
|
- Init: Physics2D.IgnoreLayerCollision(13, 14, true) — Player ↔ Enemy
|
|
- SetupJumpThroughPlatforms:
|
|
- 모든 비-Level Collider2D Layer 16 강제
|
|
- PD Foreground TilemapCollider Object.Destroy (시각만)
|
|
- AutoForeground 신규 (Grid 자식·Tilemap·TilemapCollider·Layer 16·transform 동기화)
|
|
- Level → AutoForeground 자동 분류 (BT47/BT48 휴리스틱·BT49 None 차단·BT63 TileGround* 차단)
|
|
- 사후 복원 영역 (BT51 None 처리)
|
|
- CliffWalls GameObject Destroy (BT102 영역 폐기 정리)
|
|
|
|
#### TagManager.asset
|
|
- Layer 18 = "EnemyWall" (BT99 영역·BT102 폐기 후도 잔존)
|
|
|
|
### 잔여 영역 (PD 명시)
|
|
|
|
PD 보고 (BT109 후): "몬스터들 중 일부(이동 가능 영역이 좁은 경우)를 제외하면 내가 원하는대로 움직이고 있어"
|
|
|
|
= **좁은 영역 Enemy 영역 잔여 부정합**. PD 결정 영역 (재요청 시 본 PM 후속).
|
|
|
|
### 본 PM 23회+ 가설 누적 부정확 자인 영역
|
|
|
|
PD 시각 검증 반복 영역에서 본 PM 측정·검출·재배치 영역 다수 가설 시도. 핵심 PD 명시 채택 시 영구 마무리 도달:
|
|
- "PatrolPath 제거" → BT95
|
|
- "투명벽 삭제" → BT102
|
|
- "절벽 체크 로직 잘못 — 근본 원인" → BT107 Tilemap cell 기반 측정 재설계
|
|
|
|
### 산출물
|
|
|
|
- `Assets/Scripts/Mechanics/EnemyController.cs` (자동 patrol·Tilemap cell 측정·death·재배치)
|
|
- `Assets/Scripts/Mechanics/AnimationController.cs` (BT79 flipX 정합)
|
|
- `Assets/Scripts/Mechanics/GameOptimizer.cs` (Init·SetupJumpThroughPlatforms·CliffWalls 정리)
|
|
- `Assets/Scripts/Gameplay/EnemyDeath.cs` (BT104/BT105 강화)
|
|
- `Assets/Prefabs/Enemy.prefab` (M001 sprite·y+0.8·maxSpeed 3.5)
|
|
- `Assets/Scenes/Ingame.unity` (Enemy 인스턴스 16건 y+0.8·path 영역 12건 제거)
|
|
- `Assets/Character/Animations/EnemyIdle/Run/Hurt/Death.anim` (M001 sprite reference)
|
|
- `ProjectSettings/TagManager.asset` (Layer 18 EnemyWall)
|
|
|
|
### 관련 규칙·자산
|
|
|
|
- C2 근본 해결 (BT107 PD 근본 진단 채택)
|
|
- C5·C23·C44 정직성 (본 PM 23회 가설 누적 자인)
|
|
- C36 PD 명시 영역만 변경
|
|
- `feedback_pm_solution_proactive_proposal` (본 PM 표준 보유 한계 자인)
|
|
- `feedback_pm_excessive_decision_request` (옵션 명시·PM 권고)
|
|
- `feedback_pm_mcp_direct_implementation` (직접 read·yaml edit·Python 자동)
|
|
|
|
### 후속 영역
|
|
|
|
- BT5-Dev 몬스터 시스템 = 거의 완료 영역 (PD 명시 "일부 제외 정합")
|
|
- 좁은 영역 Enemy 잔여 = PD 추후 재요청 시 본 PM 후속
|
|
- 차기 영역 = PD 결정 영역 (다른 몬스터 종류·컨텐츠 등)
|