Renderizado 3D (4.7)
Los sombreadores y efectos visuales están en godot-shaders-vfx, y el trabajo de tiempo de fotograma en godot-performance. Las ejecuciones sin cabeza (headless) no renderizan, así que pide al usuario capturas de pantalla o usa una herramienta de captura de Godot MCP si hay una conectada.
Elige primero el renderizador (rendering/renderer/rendering_method)
| Característica | Compatibility | Mobile | Forward+ |
|---|---|---|---|
| Objetivos | web (la única opción), gama baja | teléfonos y tablets, XR (recomendado) | escritorio y consola |
| SDFGI, VoxelGI, SSR, SSIL, niebla volumétrica, TAA, FSR2 | no | no | sí |
| LightmapGI | solo renderizar (horneado en hardware RD) | sí | sí |
| SSAO | sí | no | sí |
| Calcomanías, efectos de compositor, 2D HDR, desenfoque DOF | no | sí | sí |
| Brillo, niebla (de profundidad y altura), tonemapping, MSAA 3D | sí | sí | sí |
| Luces omnidireccionales y focales por malla | 8 | 8 (256 por vista) | agrupadas, 512 por grupo |
| Sombras de AreaLight3D | ninguna | penumbra aproximada | PCSS |
Establece una anulación por plataforma con rendering_method.mobile. Verifica la elección actual con project_inspect.py. Windows usa D3D12 por defecto para proyectos nuevos (4.6+), y macOS/iOS usan Metal. |
Receta de entorno (WorldEnvironment → Environment)
- Cielo:
Sky+ProceduralSkyMaterial(estilizado),PhysicalSkyMaterial(realista, combina con unidades de luz físicas) oPanoramaSkyMaterial(HDRI). Configura el modo de fondo como Sky y la luz ambiental/reflejada desde el cielo. - Tonemapping:
TONE_MAPPER_AGXpara reflejos naturales (ajustatonemap_agx_white/tonemap_agx_contrast, 4.6+). Usa Filmic/ACES solo para igualar una apariencia existente. - Brillo: desde 4.6 se mezcla antes del tonemapping y por defecto usa el modo Screen con menor intensidad. Mantén
glow_intensitybajo y usa materiales emisivos con energía superior a 1 para el bloom. - Extras de Forward+: SSAO y SSIL (sombras de contacto, rebote), SSR (suelos mojados; tuvo una gran reelaboración en 4.6, con opción de media resolución), niebla volumétrica más
FogVolumepara rayos de luz, y SDFGI para GI dinámico de gran tamaño. CameraAttributesPractical(DOF, exposición automática) oCameraAttributesPhysical(f-stop real, obturador e ISO) van en el WorldEnvironment o en la Camera3D.
Luces y sombras
DirectionalLight3D(sol):directional_shadow_modePSSM 4 divisiones. Manténdirectional_shadow_max_distancetan pequeño como el juego permita (100–200 m), ya que eso mejora la resolución de las sombras.- Luces omnidireccionales y focales: activa las sombras solo para las luces que importan. Usa
distance_fade_*para luces lejanas. AreaLight3D(4.7): luz suave rectangular de pantallas, ventanas y neón. Configuraarea_size, unaarea_textureopcional yarea_normalize_energy. Cuesta más que las luces omnidireccionales o focales, así que usa pocas.- Las luces estáticas se hornean en
LightmapGIconlight_bake_mode = BAKE_STATIC. Las luces dinámicas permanecen comoBAKE_DYNAMIC.
Elección de iluminación global
| Necesidad | Usar |
|---|---|
| Nivel estático, mejor calidad, cualquier renderizador excepto horneado en Compatibility | LightmapGI (hornear en el editor; necesita UV2: activar "Lightmap UV" en la importación) |
| Objetos dinámicos en un área estática de tamaño medio | VoxelGI (hornear, Forward+) |
| Mundo enorme o abierto, hora del día, sin horneado | SDFGI (Environment, Forward+) |
| Reflejos en superficies brillantes | ReflectionProbe (configura interior para áreas interiores), más SSR |
| Combínalos: mapas de luz para iluminación estática, sondas de luz o VoxelGI para objetos dinámicos, y ReflectionProbes en todas las superficies brillantes. |
Materiales (StandardMaterial3D / ORMMaterial3D)
- Las texturas empaquetadas ORM van en
ORMMaterial3D. Albedo es sRGB. Los mapas normal, ORM y rugosidad se importan como lineales (Godot detecta los mapas normales cuando los asignas). - Transparencia: prefiere
TRANSPARENCY_ALPHA_SCISSORoALPHA_HASH(follaje, ordenado por profundidad de forma gratuita). UsaALPHAsolo para vidrio y VFX, ya que causa problemas de ordenamiento y no tiene sombras. - Usa
material_override(malla completa) yset_surface_override_material(i, m)por instancia. No edites un material compartido en tiempo de ejecución a menos que todos los usuarios deban cambiar.duplicate()primero. - Stencil (4.5+):
stencil_mode = STENCIL_MODE_OUTLINEoSTENCIL_MODE_XRAYda contornos y visión a través de paredes sin necesidad de shaders personalizados. - Los nodos
Decalse proyectan sobre cualquier superficie (no en Compatibility).
Importación (glTF 2.0 / .glb preferido)
- En Blender, exporta GLB con +Y hacia arriba y transformaciones aplicadas. Godot importa a
.godot/imported. Configura a través del panel de Importación o la "Configuración de importación avanzada" (LOD por malla, colisiones, materiales, clips de animación). - Los sufijos de nombre en el archivo de origen crean nodos automáticamente:
-col,-convcol,-colonly,-convcolonly(colisión),-rigid,-navmesh,-occ/-occonly(ocultadores),-noimp(omitir),-loop/-cycle(animación en bucle). - Importar
.blenddirectamente necesita Blender instalado yfilesystem/import/blender/enabled. Usa GLB en CI. - Mantén los materiales editados entre reimportaciones con la opción de importación de escena
materials/extract = 1(Extraer una vez), o Importación Avanzada → "Guardar en archivo" por material. Enumera todas las opciones de importación conapi_lookup.py ResourceImporterScene. - Para la creación y exportación de activos desde Blender, consulta la habilidad
blender-export-pipelinessi está instalada.
Escalado de detalle
- El LOD automático de mallas se genera en la importación. Ajústalo por viewport con
mesh_lod_threshold, donde valores más altos son más agresivos. visibility_range_begin/end(+ fundido) maneja HLOD e impostores y elimina objetos lejanos.- Ocultación por oclusión: activa
rendering/occlusion_culling/use_occlusion_culling, añadeOccluderInstance3Dy hornea. Ayuda en escenas interiores y urbanas. - Escalado de resolución:
Viewport.scaling_3d_mode(FSR 1, FSR2 en Forward+, MetalFX en Apple) másscaling_3d_scale. Antialiasing: MSAA 3D,screen_space_aa(FXAA, SMAA 4.5+) o TAA (Forward+).
Salida HDR (4.7)
Activa display/window/hdr/request_hdr_output (o Window.hdr_output_requested). Es compatible con Windows, macOS, iOS, visionOS y Linux Wayland, y vuelve a SDR automáticamente. Verifica DisplayServer.window_is_hdr_output_supported() y expón una palanca y opciones de brillo en la configuración.
Entorno, presets de iluminación, código de materiales y LOD (compilado por las pruebas): references/recipes.md