CommunityProgramación y desarrollogithub.com

godot-3d-rendering

Apariencia 3D en Godot 4.7: elección del renderizador (Forward+/Mobile/Compatibility), entorno (AgX, brillo, niebla, SSAO/SSR/SDFGI), luces incluyendo AreaLight3D, GI (SDFGI, VoxelGI, LightmapGI), salida HDR, materiales, importación de glTF/Blender con sufijos, LOD y ocultación por oclusión. Útil para escenas 3D, iluminación, materiales, importación de modelos o calidad visual.

¿Qué es godot-3d-rendering?

Esta habilidad proporciona una guía completa y detallada para lograr un aspecto 3D de alta calidad en Godot 4.7. Cubre la elección del motor de renderizado (Forward+, Mobile, Compatibility) según los objetivos de la plataforma, la configuración del entorno global con WorldEnvironment (incluyendo tonemapping con AgX, brillo, niebla y efectos avanzados como SSAO, SSR y SDFGI), y la iluminación dinámica y de horquilla (baked). Explica el uso de los nuevos nodos AreaLight3D, las opciones de iluminación global (LightmapGI, VoxelGI, SDFGI) y los materiales (StandardMaterial3D/ORMMaterial3D) con consejos sobre transparencia y stencil. También detalla el proceso de importación de modelos 3D desde Blender/glTF, incluyendo sufijos específicos para colisiones, LOD y ocultadores, y ofrece estrategias para escalar el detalle mediante LOD automático, rangos de visibilidad y ocultación por oclusión. Finalmente, cubre la salida HDR y cómo verificar su soporte. Está diseñada para ser utilizada con herramientas como Claude Code, Cursor o Codex, y su contenido se basa en el archivo SKILL.md original, proporcionando un recurso centralizado y traducido para desarrolladores.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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ísticaCompatibilityMobileForward+
Objetivosweb (la única opción), gama bajateléfonos y tablets, XR (recomendado)escritorio y consola
SDFGI, VoxelGI, SSR, SSIL, niebla volumétrica, TAA, FSR2nonosí
LightmapGIsolo renderizar (horneado en hardware RD)sísí
SSAOsínosí
Calcomanías, efectos de compositor, 2D HDR, desenfoque DOFnosísí
Brillo, niebla (de profundidad y altura), tonemapping, MSAA 3Dsísísí
Luces omnidireccionales y focales por malla88 (256 por vista)agrupadas, 512 por grupo
Sombras de AreaLight3Dningunapenumbra aproximadaPCSS
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) o PanoramaSkyMaterial (HDRI). Configura el modo de fondo como Sky y la luz ambiental/reflejada desde el cielo.
  • Tonemapping: TONE_MAPPER_AGX para reflejos naturales (ajusta tonemap_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_intensity bajo 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 FogVolume para rayos de luz, y SDFGI para GI dinámico de gran tamaño.
  • CameraAttributesPractical (DOF, exposición automática) o CameraAttributesPhysical (f-stop real, obturador e ISO) van en el WorldEnvironment o en la Camera3D.

Luces y sombras

  • DirectionalLight3D (sol): directional_shadow_mode PSSM 4 divisiones. Mantén directional_shadow_max_distance tan 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. Configura area_size, una area_texture opcional y area_normalize_energy. Cuesta más que las luces omnidireccionales o focales, así que usa pocas.
  • Las luces estáticas se hornean en LightmapGI con light_bake_mode = BAKE_STATIC. Las luces dinámicas permanecen como BAKE_DYNAMIC.

Elección de iluminación global

NecesidadUsar
Nivel estático, mejor calidad, cualquier renderizador excepto horneado en CompatibilityLightmapGI (hornear en el editor; necesita UV2: activar "Lightmap UV" en la importación)
Objetos dinámicos en un área estática de tamaño medioVoxelGI (hornear, Forward+)
Mundo enorme o abierto, hora del día, sin horneadoSDFGI (Environment, Forward+)
Reflejos en superficies brillantesReflectionProbe (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_SCISSOR o ALPHA_HASH (follaje, ordenado por profundidad de forma gratuita). Usa ALPHA solo para vidrio y VFX, ya que causa problemas de ordenamiento y no tiene sombras.
  • Usa material_override (malla completa) y set_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_OUTLINE o STENCIL_MODE_XRAY da contornos y visión a través de paredes sin necesidad de shaders personalizados.
  • Los nodos Decal se 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 .blend directamente necesita Blender instalado y filesystem/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 con api_lookup.py ResourceImporterScene.
  • Para la creación y exportación de activos desde Blender, consulta la habilidad blender-export-pipelines si 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ñade OccluderInstance3D y hornea. Ayuda en escenas interiores y urbanas.
  • Escalado de resolución: Viewport.scaling_3d_mode (FSR 1, FSR2 en Forward+, MetalFX en Apple) más scaling_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

Individual skills in this repo

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

Skills relacionados