Community코딩 & 개발github.com

godot-3d-rendering

Godot 4.7에서 3D 렌더링 - 렌더러 선택(Forward+/Mobile/Compatibility 매트릭스), Environment(AgX, 글로우, 안개, SSAO/SSR/SDFGI), AreaLight3D를 포함한 조명, GI(SDFGI, VoxelGI, LightmapGI), HDR 출력, 머티리얼, glTF/Blender 임포트 접미사, LOD 및 폐색 컬링. 3D 씬, 조명, 머티리얼, 모델 임포트 또는 시각적 품질에 사용합니다.

godot-3d-rendering란 무엇인가요?

이 스킬은 Godot 4.7에서 3D 렌더링을 위한 포괄적인 가이드입니다. 개발자에게 최적의 렌더러 선택(Forward+, Mobile, Compatibility)부터 시작하여 Environment 설정(AgX 톤매핑, 글로우, 안개, SSAO/SSR/SDFGI), 조명(DirectionalLight3D, OmniLight3D, SpotLight3D 및 새로운 AreaLight3D 포함), 글로벌 일루미네이션(LightmapGI, VoxelGI, SDFGI), 머티리얼(StandardMaterial3D/ORMMaterial3D), glTF/Blender 임포트, 세부 수준 제어(LOD, 폐색 컬링, 해상도 스케일링), 그리고 HDR 출력에 이르기까지 모든 것을 다룹니다. 각 기술에 대한 실용적인 조언, 성능 최적화 팁, 특정 기능이 어떤 렌더러에서 지원되는지에 대한 명확한 표를 제공합니다. Godot 4.7에서 시각적으로 뛰어나고 성능이 좋은 3D 프로젝트를 만들고자 하는 모든 사용자에게 필수적인 참고 자료입니다.

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

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

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

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

문서

3D 렌더링 (4.7)

셰이더와 VFX는 godot-shaders-vfx에서, 프레임 시간 작업은 godot-performance에서 다룹니다. 헤드리스 실행에서는 렌더링되지 않으므로 사용자에게 스크린샷을 요청하거나, 연결된 Godot MCP 스크린샷 도구를 사용하세요.

먼저 렌더러를 선택하세요 (rendering/renderer/rendering_method)

기능CompatibilityMobileForward+
대상웹(유일한 옵션), 저사양휴대폰 및 태블릿, XR(권장)데스크톱 및 콘솔
SDFGI, VoxelGI, SSR, SSIL, 볼류메트릭 안개, TAA, FSR2아니요아니요예
LightmapGI렌더링 전용(RD 하드웨어에서 베이크)예예
SSAO예아니요예
데칼, 컴포지터 효과, HDR 2D, DOF 블러아니요예예
글로우, 안개(깊이 및 높이), 톤매핑, MSAA 3D예예예
메시당 옴니 및 스포트 조명88(뷰당 256)클러스터형, 클러스터당 512
AreaLight3D 그림자없음근사 반음영PCSS
플랫폼별 재정의는 rendering_method.mobile로 설정하세요. 현재 선택 사항은 project_inspect.py로 확인하세요. Windows는 새 프로젝트(4.6+)에서 기본적으로 D3D12를 사용하고, macOS/iOS는 Metal을 사용합니다.

환경 레시피 (WorldEnvironment → Environment)

  • 하늘: Sky + ProceduralSkyMaterial(양식화), PhysicalSkyMaterial(실감형, 물리적 광원 단위와 함께 사용) 또는 PanoramaSkyMaterial(HDRI). 배경 모드를 Sky로 설정하고 하늘로부터의 앰비언트/반사광을 설정합니다.
  • 톤매핑: 자연스러운 하이라이트를 위해 TONE_MAPPER_AGX를 사용하세요(tonemap_agx_white/tonemap_agx_contrast 조정, 4.6+). 기존 룩에 맞출 때만 Filmic/ACES를 사용하세요.
  • 글로우: 4.6부터 톤매핑 전에 혼합되며 기본적으로 Screen 모드와 더 낮은 강도를 사용합니다. glow_intensity를 낮게 유지하고 블룸을 위해 에너지가 1 이상인 방출성 머티리얼을 사용하세요.
  • Forward+ 추가 기능: SSAO 및 SSIL(접촉 그림자, 바운스), SSR(젖은 바닥; 4.6에서 대대적으로 재작업되었으며 절반 해상도 옵션 포함), 볼류메트릭 안개 및 광선 샤프트용 FogVolume, 대규모 동적 GI용 SDFGI.
  • CameraAttributesPractical(DOF, 자동 노출) 또는 CameraAttributesPhysical(실제 f-stop, 셔터 및 ISO)는 WorldEnvironment 또는 Camera3D에 배치합니다.

조명 및 그림자

  • DirectionalLight3D(태양): directional_shadow_mode PSSM 4 분할. directional_shadow_max_distance를 게임이 허용하는 한 작게 유지하세요(100–200 m). 그림자 해상도가 향상됩니다.
  • 옴니 및 스포트 라이트: 중요한 라이트에 대해서만 그림자를 켜세요. 멀리 있는 라이트에는 distance_fade_*를 사용하세요.
  • AreaLight3D (4.7): 화면, 창문 및 네온사인의 부드러운 사각형 광원입니다. area_size, 선택적 area_texture 및 area_normalize_energy를 설정하세요. 옴니 또는 스포트 라이트보다 비용이 많이 들므로 몇 개만 사용하세요.
  • 정적 라이트는 light_bake_mode = BAKE_STATIC으로 LightmapGI에 베이크됩니다. 동적 라이트는 BAKE_DYNAMIC으로 유지됩니다.

글로벌 일루미네이션 선택

필요사용
정적 레벨, 최고 품질, Compatibility 베이킹을 제외한 모든 렌더러LightmapGI (에디터에서 베이크; UV2 필요: 임포트 시 "Lightmap UV" 활성화)
중간 크기 정적 영역의 동적 오브젝트VoxelGI (베이크, Forward+)
거대하거나 오픈 월드, 시간대, 베이킹 불필요SDFGI (Environment, Forward+)
반짝이는 표면의 반사ReflectionProbe (실내 영역은 interior 설정) 및 SSR
결합하세요: 정적 조명용 라이트맵, 동적 오브젝트용 라이트 프로브 또는 VoxelGI, 반짝이는 모든 곳에 ReflectionProbe.

머티리얼 (StandardMaterial3D / ORMMaterial3D)

  • ORM 압축 텍스처는 ORMMaterial3D에 사용합니다. Albedo는 sRGB입니다. Normal, ORM 및 거칠기 맵은 선형으로 임포트됩니다(Godot은 할당 시 노멀 맵을 감지합니다).
  • 투명도: TRANSPARENCY_ALPHA_SCISSOR 또는 ALPHA_HASH(잎사귀, 무료로 깊이 정렬)를 선호하세요. 유리와 VFX에만 ALPHA를 사용하세요. 정렬 문제와 그림자 부재를 유발합니다.
  • material_override(전체 메시)와 set_surface_override_material(i, m)(인스턴스별)을 사용하세요. 모든 사용자가 변경해야 하는 경우가 아니라면 런타임에 공유 머티리얼을 편집하지 마세요. 먼저 duplicate()하세요.
  • 스텐실 (4.5+): stencil_mode = STENCIL_MODE_OUTLINE 또는 STENCIL_MODE_XRAY는 커스텀 셰이더 없이 외곽선과 벽 관통 시야를 제공합니다.
  • Decal 노드는 모든 표면에 투영됩니다(Compatibility 제외).

임포트 (glTF 2.0 / .glb 권장)

  • 블렌더에서 +Y up과 적용된 변환으로 GLB를 내보내세요. Godot은 .godot/imported로 임포트합니다. 임포트 독 또는 "고급 임포트 설정"(메시별 LOD, 충돌, 머티리얼, 애니메이션 클립)을 통해 구성하세요.
  • 소스 파일의 이름 접미사는 자동으로 노드를 생성합니다: -col, -convcol, -colonly, -convcolonly (충돌), -rigid, -navmesh, -occ/-occonly (가리개), -noimp (건너뛰기), -loop/-cycle (루핑 애니메이션).
  • .blend를 직접 임포트하려면 Blender가 설치되어 있어야 하고 filesystem/import/blender/enabled가 설정되어 있어야 합니다. CI에서는 GLB를 사용하세요.
  • 편집된 머티리얼을 재임포트 시 유지하려면 씬 임포트 옵션 materials/extract = 1 (한 번 추출) 또는 고급 임포트 → 머티리얼별 "파일로 저장"을 사용하세요. 모든 임포트 옵션은 api_lookup.py ResourceImporterScene으로 확인하세요.
  • 블렌더에서 에셋 생성 및 내보내기에 대한 자세한 내용은 설치된 경우 blender-export-pipelines 스킬을 참조하세요.

세부 수준 조정

  • 자동 메시 LOD는 임포트 시 생성됩니다. 뷰포트별로 mesh_lod_threshold로 조정하세요. 값이 높을수록 더 공격적입니다.
  • visibility_range_begin/end (+ 페이드)는 HLOD와 이미포스터를 처리하고 먼 프로프를 컬링합니다.
  • 폐색 컬링: rendering/occlusion_culling/use_occlusion_culling을 활성화하고, OccluderInstance3D를 추가하고 베이크하세요. 실내 및 도시 씬에 유용합니다.
  • 해상도 스케일링: Viewport.scaling_3d_mode (FSR 1, Forward+에서 FSR2, Apple에서 MetalFX) 및 scaling_3d_scale. 안티앨리어싱: MSAA 3D, screen_space_aa (FXAA, SMAA 4.5+) 또는 TAA (Forward+).

HDR 출력 (4.7)

display/window/hdr/request_hdr_output (또는 Window.hdr_output_requested)를 켜세요. Windows, macOS, iOS, visionOS 및 Linux Wayland에서 지원되며 자동으로 SDR로 대체됩니다. DisplayServer.window_is_hdr_output_supported()를 확인하고 설정에 토글과 밝기 옵션을 노출하세요.

환경, 조명 프리셋, 머티리얼 및 LOD 코드(테스트에 의해 컴파일됨): references/recipes.md

Individual skills in this repo

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

관련 스킬