3D 렌더링 (4.7)
셰이더와 VFX는 godot-shaders-vfx에서, 프레임 시간 작업은 godot-performance에서 다룹니다. 헤드리스 실행에서는 렌더링되지 않으므로 사용자에게 스크린샷을 요청하거나, 연결된 Godot MCP 스크린샷 도구를 사용하세요.
먼저 렌더러를 선택하세요 (rendering/renderer/rendering_method)
| 기능 | Compatibility | Mobile | Forward+ |
|---|---|---|---|
| 대상 | 웹(유일한 옵션), 저사양 | 휴대폰 및 태블릿, XR(권장) | 데스크톱 및 콘솔 |
| SDFGI, VoxelGI, SSR, SSIL, 볼류메트릭 안개, TAA, FSR2 | 아니요 | 아니요 | 예 |
| LightmapGI | 렌더링 전용(RD 하드웨어에서 베이크) | 예 | 예 |
| SSAO | 예 | 아니요 | 예 |
| 데칼, 컴포지터 효과, HDR 2D, DOF 블러 | 아니요 | 예 | 예 |
| 글로우, 안개(깊이 및 높이), 톤매핑, MSAA 3D | 예 | 예 | 예 |
| 메시당 옴니 및 스포트 조명 | 8 | 8(뷰당 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_modePSSM 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