godot-3d-rendering

Renderização 3D no Godot 4.7 – escolha do renderizador (Forward+/Mobile/Compatibilidade), Ambiente (AgX, brilho, névoa, SSAO/SSR/SDFGI), luzes incluindo AreaLight3D, GI (SDFGI, VoxelGI, LightmapGI), saída HDR, materiais, sufixos de importação glTF/Blender, LOD e oclusão. Use para cenas 3D, iluminação, materiais, importação de modelos ou qualidade visual.

O que é godot-3d-rendering?

Este skill fornece um guia abrangente para obter uma aparência 3D de alta qualidade no Godot Engine 4.7. Ele cobre desde a escolha inicial do renderizador (Forward+, Mobile, Compatibilidade) até técnicas avançadas de iluminação, ambiente e otimização. É ideal para desenvolvedores que estão criando cenas 3D, configurando iluminação global (GI), importando modelos glTF/Blender, ou ajustando a qualidade visual com efeitos como SSAO, SSR, SDFGI e HDR. O skill explica como configurar o Environment com tonemapping AGX, glow e névoa, além de apresentar o novo nó AreaLight3D para luzes de área suave. Também aborda materiais (StandardMaterial3D/ORMMaterial3D), importação de assets com sufixos especiais (como -col para colisão), e técnicas de escalonamento de detalhes como LOD e oclusão. O conteúdo é apresentado de forma prática, com tabelas de compatibilidade e recomendações para diferentes plataformas (desktop, mobile, web) e casos de uso.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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)

FuncionalidadeCompatibilidadeMobileForward+
Público-alvoweb (a única opção), baixo desempenhocelulares e tablets, XR (recomendado)desktop e console
SDFGI, VoxelGI, SSR, SSIL, névoa volumétrica, TAA, FSR2nãonãosim
LightmapGIrenderizar apenas (assar em hardware RD)simsim
SSAOsimnãosim
Decalques, efeitos de compositor, HDR 2D, desfoque DOFnãosimsim
Brilho, névoa (profundidade e altura), mapeamento de tom, MSAA 3Dsimsimsim
Luzes omnidirecionais e spot por malha88 (256 por visão)clusterizado, 512 por cluster
Sombras de AreaLight3Dnenhumapenumbra aproximadaPCSS
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) ou PanoramaSkyMaterial (HDRI). Defina o modo de fundo como Sky e luz ambiente/refletida do céu.
  • Mapeamento de tom: TONE_MAPPER_AGX para realces naturais (ajuste tonemap_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_intensity baixo 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 FogVolume para raios de luz, e SDFGI para GI dinâmico em grande escala.
  • CameraAttributesPractical (DOF, exposição automática) ou CameraAttributesPhysical (f-stop real, obturador e ISO) vão no WorldEnvironment ou no Camera3D.

Luzes e sombras

  • DirectionalLight3D (sol): directional_shadow_mode PSSM 4 divisões. Mantenha directional_shadow_max_distance o 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. Defina area_size, um area_texture opcional e area_normalize_energy. Custa mais do que luzes omni ou spot, então use poucas.
  • Luzes estáticas são assadas em LightmapGI com light_bake_mode = BAKE_STATIC. Luzes dinâmicas permanecem BAKE_DYNAMIC.

Escolha de iluminação global

NecessidadeUse
Nível estático, melhor qualidade, qualquer renderizador exceto assamento CompatibilidadeLightmapGI (asse no editor; precisa de UV2: habilite "Lightmap UV" na importação)
Objetos dinâmicos em uma área estática de médio porteVoxelGI (asse, Forward+)
Mundo enorme ou aberto, hora do dia, sem assamentoSDFGI (Environment, Forward+)
Reflexões em superfícies brilhantesReflectionProbe (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_SCISSOR ou ALPHA_HASH (folhagem, ordenada por profundidade de graça). Use ALPHA apenas para vidro e VFX, pois causa problemas de ordenação e nenhuma sombra.
  • Use material_override (malha inteira) e set_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_OUTLINE ou STENCIL_MODE_XRAY fornece contornos e visão através de paredes sem shaders personalizados.
  • Nós Decal projetam 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 .blend diretamente precisa do Blender instalado e filesystem/import/blender/enabled ativado. 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 com api_lookup.py ResourceImporterScene.
  • Para criação de assets e exportação do Blender, veja o skill blender-export-pipelines se 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, adicione OccluderInstance3D e asse. Ajuda em cenas internas e urbanas.
  • Escalonamento de resolução: Viewport.scaling_3d_mode (FSR 1, FSR2 no Forward+, MetalFX na Apple) mais scaling_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

Individual skills in this repo

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

Habilidades Relacionadas