Community코딩 & 개발github.com

고도 퍼포먼스

Godot 4.7에서 성능 문제를 찾아 수정합니다. 프로파일러와 모니터, 프레임 예산, 수천 개의 객체를 위한 MultiMesh 및 서버 API, WorkerThreadPool과 스레드 그룹, GDScript/C# 핫 경로, 드로우 콜, 라이트, LOD, 물리 비용, 로딩 및 메모리 누수를 다룹니다. 게임이 끊기거나 FPS가 낮거나 로딩이 느리거나 메모리가 증가할 때 사용하세요.

고도 퍼포먼스란 무엇인가요?

이 스킬은 Godot 4.7 게임 엔진에서 발생하는 다양한 성능 문제를 진단하고 해결하는 데 특화된 지침을 제공합니다. 개발자는 에디터 디버거의 프로파일러, 모니터, 네이티브 프로파일러(Tracy, Perfetto 등)를 활용하여 CPU 및 GPU 병목 지점을 정확히 측정하고, 프레임 예산(60FPS 기준 16.6ms) 내에서 최적화를 수행할 수 있습니다. 특히 수천 개의 객체를 다룰 때는 개별 노드 대신 MultiMesh, 서버 API, 데이터 중심 설계를 사용하여 드로우 콜과 오버헤드를 획기적으로 줄이는 방법을 제시합니다. 또한 스레드 안전성을 유지하면서 WorkerThreadPool과 스레드 그룹을 활용한 병렬 처리, GPU 렌더링 최적화(라이트/섀도우 관리, LOD, 오버드로우 감소), 효율적인 로딩 및 메모리 관리 전략을 상세히 다룹니다. 모바일, 웹, 데스크톱/콘솔 등 플랫폼별 예산 가이드라인을 제공하여 개발자가 목표 플랫폼에 맞춰 성능을 조정할 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EL4CTEO/godot-skills/tree/main/skills/godot-performance

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

성능 (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

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬