Renderização 3D (4.7)
Shaders e VFX estão em godot-shaders-vfx, e o trabalho de tempo de quadro está em godot-performance. Execuções headless não renderizam, então peça capturas de tela ao usuário ou use uma ferramenta de captura de tela Godot MCP, se estiver conectada.
Escolha o renderizador primeiro (rendering/renderer/rendering_method)
| Funcionalidade | Compatibilidade | Mobile | Forward+ |
|---|---|---|---|
| Público-alvo | web (a única opção), baixo desempenho | celulares e tablets, XR (recomendado) | desktop e console |
| SDFGI, VoxelGI, SSR, SSIL, névoa volumétrica, TAA, FSR2 | não | não | sim |
| LightmapGI | renderizar apenas (assar em hardware RD) | sim | sim |
| SSAO | sim | não | sim |
| Decalques, efeitos de compositor, HDR 2D, desfoque DOF | não | sim | sim |
| Brilho, névoa (profundidade e altura), mapeamento de tom, MSAA 3D | sim | sim | sim |
| Luzes omnidirecionais e spot por malha | 8 | 8 (256 por visão) | clusterizado, 512 por cluster |
| Sombras de AreaLight3D | nenhuma | penumbra aproximada | PCSS |
Defina uma substituição por plataforma com rendering_method.mobile. Verifique a escolha atual com project_inspect.py. O Windows usa D3D12 por padrão para novos projetos (4.6+), e macOS/iOS usam Metal. |
Receita de Ambiente (WorldEnvironment → Environment)
- Céu:
Sky+ProceduralSkyMaterial(estilizado),PhysicalSkyMaterial(realista, combina com unidades de luz física) ouPanoramaSkyMaterial(HDRI). Defina o modo de fundo como Sky e luz ambiente/refletida do céu. - Mapeamento de tom:
TONE_MAPPER_AGXpara realces naturais (ajustetonemap_agx_white/tonemap_agx_contrast, 4.6+). Use Filmic/ACES apenas para corresponder a uma aparência existente. - Brilho: desde 4.6, ele se mescla antes do mapeamento de tom e usa o modo Screen por padrão com intensidade mais baixa. Mantenha
glow_intensitybaixo e use materiais emissivos com energia acima de 1 para bloom. - Extras do Forward+: SSAO e SSIL (sombras de contato, reflexão difusa), SSR (pisos molhados; teve uma grande reformulação em 4.6, com opção de meia resolução), névoa volumétrica mais
FogVolumepara raios de luz, e SDFGI para GI dinâmico em grande escala. CameraAttributesPractical(DOF, exposição automática) ouCameraAttributesPhysical(f-stop real, obturador e ISO) vão no WorldEnvironment ou no Camera3D.
Luzes e sombras
DirectionalLight3D(sol):directional_shadow_modePSSM 4 divisões. Mantenhadirectional_shadow_max_distanceo menor possível que o jogo permita (100–200 m), pois isso melhora a resolução da sombra.- Luzes omnidirecionais e spot: ative sombras apenas para as luzes que importam. Use
distance_fade_*para luzes distantes. AreaLight3D(4.7): luz suave retangular de telas, janelas e néon. Definaarea_size, umarea_textureopcional earea_normalize_energy. Custa mais do que luzes omni ou spot, então use poucas.- Luzes estáticas são assadas em
LightmapGIcomlight_bake_mode = BAKE_STATIC. Luzes dinâmicas permanecemBAKE_DYNAMIC.
Escolha de iluminação global
| Necessidade | Use |
|---|---|
| Nível estático, melhor qualidade, qualquer renderizador exceto assamento Compatibilidade | LightmapGI (asse no editor; precisa de UV2: habilite "Lightmap UV" na importação) |
| Objetos dinâmicos em uma área estática de médio porte | VoxelGI (asse, Forward+) |
| Mundo enorme ou aberto, hora do dia, sem assamento | SDFGI (Environment, Forward+) |
| Reflexões em superfícies brilhantes | ReflectionProbe (defina interior para áreas internas), mais SSR |
| Combine-os: lightmaps para iluminação estática, sondas de luz ou VoxelGI para objetos dinâmicos e ReflectionProbes em todos os lugares brilhantes. |
Materiais (StandardMaterial3D / ORMMaterial3D)
- Texturas empacotadas ORM vão em
ORMMaterial3D. Albedo é sRGB. Mapas de normal, ORM e rugosidade são importados como linear (Godot detecta mapas de normal quando você os atribui). - Transparência: prefira
TRANSPARENCY_ALPHA_SCISSORouALPHA_HASH(folhagem, ordenada por profundidade de graça). UseALPHAapenas para vidro e VFX, pois causa problemas de ordenação e nenhuma sombra. - Use
material_override(malha inteira) eset_surface_override_material(i, m)por instância. Não edite um material compartilhado em tempo de execução a menos que cada usuário deva mudar.duplicate()primeiro. - Stencil (4.5+):
stencil_mode = STENCIL_MODE_OUTLINEouSTENCIL_MODE_XRAYfornece contornos e visão através de paredes sem shaders personalizados. - Nós
Decalprojetam em qualquer superfície (não no Compatibilidade).
Importação (glTF 2.0 / .glb preferido)
- No Blender, exporte GLB com +Y para cima e transformações aplicadas. Godot importa para
.godot/imported. Configure através da aba Import ou das "Configurações Avançadas de Importação" (LOD por malha, colisões, materiais, clipes de animação). - Sufixos de nome no arquivo de origem criam nós automaticamente:
-col,-convcol,-colonly,-convcolonly(colisão),-rigid,-navmesh,-occ/-occonly(occludedores),-noimp(pular),-loop/-cycle(animação em loop). - Importar
.blenddiretamente precisa do Blender instalado efilesystem/import/blender/enabledativado. Use GLB em CI. - Mantenha materiais editados ao longo de reimportações com a opção de importação de cena
materials/extract = 1(Extrair uma vez), ou Importação Avançada → "Salvar em arquivo" por material. Liste todas as opções de importação comapi_lookup.py ResourceImporterScene. - Para criação de assets e exportação do Blender, veja o skill
blender-export-pipelinesse estiver instalado.
Escalonamento de detalhes
- LOD automático de malha é gerado na importação. Ajuste por viewport com
mesh_lod_threshold, onde valores mais altos são mais agressivos. visibility_range_begin/end(+ fade) gerencia HLOD e impostores e elimina props distantes.- Oclusão: habilite
rendering/occlusion_culling/use_occlusion_culling, adicioneOccluderInstance3De asse. Ajuda em cenas internas e urbanas. - Escalonamento de resolução:
Viewport.scaling_3d_mode(FSR 1, FSR2 no Forward+, MetalFX na Apple) maisscaling_3d_scale. Anti-aliasing: MSAA 3D,screen_space_aa(FXAA, SMAA 4.5+) ou TAA (Forward+).
Saída HDR (4.7)
Ative display/window/hdr/request_hdr_output (ou Window.hdr_output_requested). É suportado no Windows, macOS, iOS, visionOS e Linux Wayland, e volta para SDR automaticamente. Verifique DisplayServer.window_is_hdr_output_supported() e exponha uma alternância e opções de brilho nas configurações.
Ambiente, predefinições de iluminação, código de material e LOD (compilado pelos testes): references/recipes.md