docs(BT12-Dev-Vis): Player 사망 제자리·부활·FX 잔상 (엔트리 18)

EerieVillage 3a672f0 push 정합.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
깃 관리자 2026-05-13 20:03:29 +09:00
parent ae983c0e61
commit 5265e03226
2 changed files with 36 additions and 1 deletions

File diff suppressed because one or more lines are too long

View File

@ -449,6 +449,41 @@ if (other.GetComponent<Projectile>() != null) return;
---
## 엔트리 18 — Player 사망 제자리·부활 모션·무적 + FX 잔상 safety cap (2026-05-13 EerieVillage `3a672f0`)
**PD 지시 4건**:
1. "플레이어가 죽을 때 사라지는 현상이 있어. 정상적으로 죽는 모션이 나오도록 수정해줘."
2. "플레이어가 죽음 상태에서 제자리 부활할 경우 부활 모션(죽는 모션 반대로 재생) 후 조작 가능하도록 수정해줘."
3. "플레이어가 제자리 부활할 경우, 부활 모션이 나오고 2초 간 깜박거리며 무적 상태로 적용해줘."
4. "여전히 맵에 풀링 오브젝트로 의심되는 이펙트 잔상이 계속 남아있어."
### 작업 1 — Player 사망 사라지는 현상 fix
**원인 추정**: PlayerDeath 영역 collider·Rigidbody2D 영역 active 영역 gravity 영역 떨어짐·낙사·화면 외 영역.
**fix**: PlayerDeath.Execute 영역 `Rigidbody2D.simulated = false` (gravity 정지·제자리 사망·낙사 차단).
### 작업 2·3 — 제자리 부활·부활 모션·2초 무적 깜박
**원인**: PlayerSpawn.Execute 영역 `player.Teleport(model.spawnPoint.transform.position)` 영역 → spawn point 영역 이동 영역 제자리 부활 X.
**fix** (PlayerSpawn.Execute):
- Teleport 폐기 (spawn point 이동 X·제자리)
- `player.health.Resurrect()` 호출 — currentHP=maxHP·invulnerableUntil=2초·Animator `dead=false` + `resurrect` Trigger
- `Rigidbody2D.simulated = true` 복원 (PlayerDeath 영역 disable 영역 복원)
- `PlayerInvulnerabilityFlash` 영역 IsInvulnerable 영역 자동 SpriteRenderer 깜박 (2초 동안 0.1s 간격)
- 기존 `Schedule<EnablePlayerInput>(2f)` 정합 (2초 후 조작 가능)
### 작업 4 — FX 잔상 safety cap 5초
**원인 분석**:
- **LaserSpawner.Trigger** 영역 fx GameObject 영역 `Object.Destroy` 호출 누락 — 본 영역 강력 원인 의심.
- 다른 Spawner 영역 lifetime 영역 매우 긴 ParticleSystem (FX_Lightningball 등 root PS duration + startLifetime 10s+).
**fix**:
- LaserSpawner.Trigger — `Object.Destroy(fx, Mathf.Min(fxLifetime + 0.2f, 5f))` 추가
- LightningStrikeSpawner.AutoDestroyFx — `Mathf.Min(lifetime + 0.2f, 5f)` cap
- MeleeAreaSpawner.Trigger — 동일 cap
- Projectile.AutoDestroyOnParticleEnd (ProjectileSpawner OnHitFx) — 동일 cap
**safety cap 5초 채택 사유**: 일반 액티브 FX 영역 시각 1~3초 이내 종료. 5초 영역 cap 영역 표준 정합 X 시 잔상 영구 차단.
---
## 영역 자산
- `HitboxDebug.cs` 공용 helper (Spawn·AttachToTransform·GetWhiteSprite) — 추후 다른 카테고리 (C 설치·D 소환·E 오라) 영역 박스 시각화 재사용 가능.