디버그 경로

디버깅 도구 선택

파티클이 보이지 않는 문제, 움직임이 어긋나는 문제, 성능이 떨어지는 문제는 서로 다른 증거를 요구합니다. 나이아가라 디버거, 에디터 Debug 메뉴, stat Niagara, profilegpu를 증상별로 연결해 원인을 좁힙니다.

나이아가라 증상별 디버깅 도구 선택 흐름 보이지 않음, 이상 동작, 성능 저하 증상마다 확인할 패널과 콘솔 명령이 달라진다. 증상 선택 무엇이 이상한가 안 보임 Active / Spawn 이상 동작 값 변화 추적 성능 저하 파티클 수 / GPU Overview 실행 여부 확정 Debug Menu ID / 실행 순서 stat Niagara CPU/GPU 비용 원인 후보 좁힘 Renderer / Force / Cost
증상 선택
먼저 현상을 세 갈래로 나눈다 안 보임, 이상 동작, 성능 저하는 확인해야 할 증거가 다르다.
안 보임
Overview로 활성과 스폰을 확인 Active, Spawn Rate, Lifetime, Renderer 상태를 먼저 본다.
이상 동작
Debug Menu로 값 변화 순서를 추적 ID, 실행 순서, Age 기반 색/크기 변화를 멈춰서 비교한다.
성능 저하
stat Niagara와 profilegpu로 비용 확인 파티클 수, GPU 시간, 오버드로우, 비싼 렌더러를 분리한다.

마지막에는 Renderer, Force, Collision, Material 중 어느 축이 원인인지 좁힌다.

안 보임 활성, 스폰, 렌더러를 먼저 확인
  • Niagara Component의 Active와 Auto Activate 상태
  • Spawn Rate, Spawn Burst, Lifetime, Sprite Size 값
  • Renderer가 Light Renderer만 남아 있지 않은지 확인
이상 동작 프레임을 멈추고 값 변화 순서를 추적
  • Add Velocity, Gravity Force, Drag, Noise Force 강도
  • Normalized Age 커브와 Color, Size 변화
  • Data Interface의 액터와 컴포넌트 참조 유효성
성능 저하 파티클 수, 오버드로우, 비싼 모듈을 분리
  • Emitters 패널의 CPU/GPU 시간과 현재 파티클 수
  • Translucent 머티리얼, Light Renderer, Shadows 비용
  • Collision Trace와 복잡한 모듈 스크립트 사용 여부
도구별 증거
도구 보는 값 디버깅 도구 판단
Overview 시스템 활성, 이미터 수, 총 파티클 수 대상이 실제로 실행 중인지 먼저 확정합니다.
Parameters User 변수와 내부 Particles.* 값 블루프린트 입력과 모듈 계산 결과가 맞는지 봅니다.
Modules 모듈별 CPU/GPU 시간 Collision, Force, 커브, 커스텀 스크립트 병목을 찾습니다.
Debug Menu Bounding Box, Particle IDs, Execution Order 위치, 실행 순서, 개별 파티클 상태를 시각적으로 검증합니다.