성능 (4.7)
먼저 측정하세요. 절대 눈감고 최적화하지 마십시오. 프레임당 16.6ms(60FPS) 또는 8.3ms(120FPS)의 예산은 스크립트, 물리, CPU 및 GPU의 렌더링을 포함합니다.
도구
- 에디터 디버거: 프로파일러(스크립트 함수; 시작하고 플레이한 후 자체 시간으로 정렬), 시각적 프로파일러(렌더 패스별 CPU 대 GPU), 모니터(FPS, 프로세스/물리 시간, 객체, 노드, 고아 노드, 드로우 콜, 비디오 메모리), 네트워크 프로파일러 및 ObjectDB 스냅샷(4.6+: 두 스냅샷을 비교하여 누수 찾기).
- 코드:
Performance.get_monitor(Performance.TIME_PROCESS),RENDER_TOTAL_DRAW_CALLS_IN_FRAME,OBJECT_NODE_COUNT,OBJECT_ORPHAN_NODE_COUNT.Performance.add_custom_monitor(&"game/enemies", callable)으로 자신만의 모니터를 추가하세요. - 네이티브 프로파일러(4.6+): Tracy, Perfetto(Android 기본) 및 Apple Instruments는 GDScript, C# 및 GDExtension 프레임을 볼 수 있습니다. 프레임 시간 스파이크를 찾는 데 사용하십시오.
- CLI:
--profiling,--gpu-profile,--print-fps,--benchmark. 반복 가능한 실행을 위해--fixed-fps 60 --quit-after N을 사용하세요. - 누수: 고아 노드는 트리에서 제거되었지만 해제되지 않은 노드입니다.
Node.print_orphan_nodes(),get_orphan_node_ids()(4.5+).
CPU: 더 적은 작업 수행
- 필요하지 않은 처리를 비활성화하십시오: 유휴 상태일 때
set_process(false)/set_physics_process(false).VisibleOnScreenEnabler2D/3D는 화면 밖 액터를 일시 중지합니다. 타이머는 프레임당 폴링보다 낫습니다. - 프레임당 코드는 핫 경로입니다.
@onready/_Ready에서 노드를 캐시하세요. 액션, 그룹 및 메서드 이름에는StringName리터럴(&"jump")을 사용하세요. 매 프레임마다get_tree().get_nodes_in_group()을 호출하지 마십시오. 타입이 있는 GDScript를 사용하세요(타입이 있는 opcode가 더 빠릅니다). - 시그널과
call_group은 이벤트에 저렴하지만, 수천 개의 엔티티에 대해 엔티티당 매 프레임 방출하지 마십시오. - 수천 개의 것: 것당 하나의 노드를 사용하는 것을 중단하십시오.
- 시각:
MultiMeshInstance3D/2D(하나의 드로우 콜;multimesh.buffer를 일괄 작성) 또는 GPU 파티클. - 로직: 하나의 관리자 스크립트에서 일반 배열과 구조체(데이터 중심), 엔티티당 스크립트가 아닙니다.
- 물리: 노드 없이
PhysicsServer2D/3D바디와 영역, 또는 프레임당 하나의 레이캐스트 배치. - 노드 없는 렌더링:
RenderingServer인스턴스 및 캔버스 아이템.
- 시각:
- 물리: 게임에 더 필요하지 않으면
physics_ticks_per_second를 60으로 유지하십시오. 단순한 기본 도형을 사용하고 움직이는 바디에서ConcavePolygonShape3D를 피하십시오. 레이어와 마스크는 쌍 검사를 줄입니다. 바디가 절전 모드로 전환되도록 두십시오(can_sleep).
스레드
WorkerThreadPool.add_task(callable)/add_group_task(callable, count)(병렬 for), 그런 다음wait_for_task_completion(id). 대부분의 작업에서 원시Thread보다 낫습니다.- 씬 트리 규칙: 트리 내부의 노드는 스레드 그룹에 있지 않은 한 메인 스레드에서만 접근할 수 있습니다(
process_thread_group = PROCESS_THREAD_GROUP_SUB_THREAD, 해당 하위 트리를 병렬로 처리하며 교차 그룹 호출을 위해call_deferred_thread_group사용). 작업자 스레드에서 결과를call_deferred/Callable.call_deferred()로 다시 전달하십시오.Thread.is_main_thread()(4.7)로 단언하십시오. - 공유 데이터:
Mutex로 보호하거나 각 작업자에게 자체 조각을 제공하고 메인 스레드에서 병합하십시오. - 백그라운드 로딩:
ResourceLoader.load_threaded_request(path, "", true)는 종속성에 하위 스레드를 사용합니다.
GPU 및 렌더링
- 드로우 콜: 정적 메시를 병합하고 재질을 공유하십시오. 메시 표면의 각 고유 재질이 드로우 콜을 추가하기 때문입니다. 반복에는 MultiMesh를, 2D에서는 텍스처 아틀라스를 사용하십시오.
- 라이트와 섀도우는 일반적인 GPU 소모자입니다. 그림자가 있는 옴니 및 스포트 라이트를 적게 사용하고,
directional_shadow_max_distance를 작게 유지하며, 정적 조명을 베이크하십시오(LightmapGI). - 오버드로우: 큰 투명 파티클과 전체 화면 알파. 잎 foliage 및 더 작은 파티클 쿼드에는 알파 시저 또는 해시를 사용하십시오.
- 디테일 스케일 조정: LOD(
mesh_lod_threshold),visibility_range_*, 폐색 컬링 및 약한 GPU에서 해상도 스케일링(FSR, MetalFX). 올바른 렌더러를 선택하십시오: 저사양용 Mobile 또는 Compatibility (godot-3d-rendering참조). - 셰이더 히치: 셰이더 베이커(내보내기 옵션), 더 적은 재질 변형.
로딩 및 메모리
preload는 스크립트 로드 시 로드되며 차단합니다. 항상 필요한 작은 것에만 사용하십시오.load는 지연 로드됩니다. 스레드 로딩은 레벨에 적합합니다.ResourceLoader는 리소스를 캐시합니다. 재사용하고 인스턴스별 상태가 필요하지 않으면 공유 리소스를duplicate()하지 마십시오.- 텍스처: VRAM 압축 가져오기(3D 기본값; 큰 2D에 대해 활성화). 3D용 밉맵. 플랫폼별 최대 크기 제한. 오디오: 긴 트랙용 Ogg 스트림.
- 생성한 것을 해제하십시오:
queue_free()및 총알용 풀. 고아 개수가 일정하게 유지되는지 확인하십시오.
GDScript 대 C#
- GDScript는 게임플레이에 적합합니다. 빡빡한 수학 루프(경로 찾기, 절차적 생성, 시뮬레이션)를 C# 또는 GDExtension으로 옮기고 API 호출을 일괄 처리하십시오.
- C#: 프레임당 할당(LINQ, 클로저, 문자열 포매팅,
new Godot.Collections.Array)을 피하십시오. 모든 Godot API 호출은 상호 운용 경계를 넘으므로 일괄 처리하십시오. PackedArray는 경계를 넘을 때 복사됩니다.
플랫폼 예산 (경험 법칙)
모바일: < 100–150 드로우 콜, 1개의 그림자 라이트, Mobile 또는 Compatibility 렌더러, 30–60 FPS 목표. 웹: Compatibility 렌더러, 내보내기가 스레드를 사용하지 않으면 단일 스레드(교차 출처 격리 헤더 필요), 다운로드를 작게 유지하십시오. 데스크톱 또는 콘솔: Forward+, 최소 사양 하드웨어에서 프로파일링하십시오.
성능 HUD + 사용자 정의 모니터, MultiMesh 크라우드, 병렬 그룹 작업, 서버 측 총알(테스트에 의해 컴파일됨): references/patterns.md