godot-3d-rendering

Rendu 3D dans Godot 4.7 – choix du moteur de rendu (Forward+/Mobile/Compatibilité), Environnement (AgX, lueur, brouillard, SSAO/SSR/SDFGI), lumières incluant AreaLight3D, GI (SDFGI, VoxelGI, LightmapGI), sortie HDR, matériaux, suffixes d'import glTF/Blender, LOD et occlusion culling. Utilisez-le pour les scènes 3D, l'éclairage, les matériaux, l'import de modèles ou la qualité visuelle.

Qu'est-ce que godot-3d-rendering ?

Cette compétence est un guide complet pour configurer et optimiser le rendu 3D dans Godot 4.7 (et versions ultérieures). Elle vous aide à choisir le bon moteur de rendu en fonction de votre plateforme cible : Forward+ pour le bureau et la console (SDFGI, SSR, brouillard volumétrique), Mobile pour les téléphones, tablettes et XR, et Compatibilité pour le Web et les appareils bas de gamme. La compétence couvre la configuration complète de l'Environnement (WorldEnvironment) : ciels procéduraux et HDRI, mappage de tons AgX, lueur (glow), brouillard, SSAO/SSIL, SSR, et SDFGI pour l'illumination globale dynamique. Elle détaille les différents types de lumières (DirectionalLight3D, Omni, Spot, et la nouvelle AreaLight3D pour les lumières douces rectangulaires), ainsi que les techniques d'illumination globale comme LightmapGI, VoxelGI et SDFGI. La compétence explique également la création de matériaux (StandardMaterial3D / ORMMaterial3D) et les bonnes pratiques pour la transparence, les stencils (outline, x-ray), et les decals. Enfin, elle aborde l'import de modèles (glTF 2.0 recommandé, ou .blend avec Blender) avec les suffixes de noms pour collisions, navmesh et occludeurs, ainsi que les techniques de mise à l'échelle des détails (LOD, occlusion culling, FSR2, MetalFX) et la sortie HDR. Cette compétence est destinée aux développeurs utilisant Godot 4.7 qui souhaitent maîtriser le rendu 3D pour créer des scènes visuellement riches et performantes.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Rendu 3D (4.7)

Les shaders et effets visuels (VFX) se trouvent dans godot-shaders-vfx, et l'optimisation du temps d'image dans godot-performance. Les exécutions sans tête (headless) n'affichent pas de rendu, alors demandez des captures d'écran à l'utilisateur, ou utilisez un outil de capture d'écran Godot MCP s'il est connecté.

Choisissez d'abord le moteur de rendu (rendering/renderer/rendering_method)

FonctionnalitéCompatibilitéMobileForward+
Ciblesweb (seule option), bas de gammetéléphones et tablettes, XR (recommandé)bureau et console
SDFGI, VoxelGI, SSR, SSIL, brouillard volumétrique, TAA, FSR2nonnonoui
LightmapGIrendu uniquement (cuisson sur matériel RD)ouioui
SSAOouinonoui
Décalcomanies, effets de composition, HDR 2D, flou de profondeur de champ (DOF)nonouioui
Lueur, brouillard (profondeur et hauteur), mappage de tons, MSAA 3Douiouioui
Lumières omni et projecteur par maillage88 (256 par vue)groupées (clustered), 512 par cluster
Ombres AreaLight3Daucunepénombre approximativePCSS
Définissez une surcharge par plateforme avec rendering_method.mobile. Vérifiez le choix actuel avec project_inspect.py. Windows utilise D3D12 par défaut pour les nouveaux projets (4.6+), et macOS/iOS utilisent Metal.

Recette d'environnement (WorldEnvironment → Environment)

  • Ciel : Sky + ProceduralSkyMaterial (stylisé), PhysicalSkyMaterial (réaliste, s'associe avec les unités lumineuses physiques) ou PanoramaSkyMaterial (HDRI). Définissez le mode de fond sur Sky et la lumière ambiante/réfléchie depuis le ciel.
  • Mappage de tons : TONE_MAPPER_AGX pour des hautes lumières naturelles (ajustez tonemap_agx_white/tonemap_agx_contrast, 4.6+). Utilisez Filmic/ACES uniquement pour correspondre à un rendu existant.
  • Lueur : depuis la 4.6, elle se mélange avant le mappage de tons et passe par défaut en mode Screen avec une intensité plus faible. Gardez glow_intensity bas et utilisez des matériaux émissifs avec une énergie supérieure à 1 pour le bloom.
  • Extras Forward+ : SSAO et SSIL (ombres de contact, rebond), SSR (sols mouillés ; a subi une grande refonte en 4.6, avec une option demi-résolution), brouillard volumétrique plus FogVolume pour les rayons lumineux, et SDFGI pour une illumination globale dynamique à grande échelle.
  • CameraAttributesPractical (profondeur de champ, exposition automatique) ou CameraAttributesPhysical (réels f-stop, obturateur et ISO) se placent sur le WorldEnvironment ou la Camera3D.

Lumières et ombres

  • DirectionalLight3D (soleil) : directional_shadow_mode PSSM 4 splits. Gardez directional_shadow_max_distance aussi petite que le jeu le permet (100–200 m), car cela améliore la résolution des ombres.
  • Lumières omni et projecteur : activez les ombres uniquement pour les lumières importantes. Utilisez distance_fade_* pour les lumières éloignées.
  • AreaLight3D (4.7) : lumière douce rectangulaire provenant d'écrans, fenêtres et néons. Définissez area_size, un area_texture optionnel et area_normalize_energy. Elle coûte plus cher que les lumières omni ou projecteur, alors utilisez-en peu.
  • Les lumières statiques sont cuites dans LightmapGI avec light_bake_mode = BAKE_STATIC. Les lumières dynamiques restent BAKE_DYNAMIC.

Choix d'illumination globale

BesoinUtilisez
Niveau statique, meilleure qualité, tout moteur sauf cuisson CompatibilitéLightmapGI (cuisson dans l'éditeur ; nécessite UV2 : activez "Lightmap UV" à l'import)
Objets dynamiques dans une zone statique de taille moyenneVoxelGI (cuisson, Forward+)
Monde immense ou ouvert, heure du jour, pas de cuissonSDFGI (Environment, Forward+)
Réflexions sur surfaces brillantesReflectionProbe (définissez interior pour les zones intérieures), plus SSR
Combinez-les : lightmaps pour l'éclairage statique, light probes ou VoxelGI pour les objets dynamiques, et ReflectionProbes partout pour le brillant.

Matériaux (StandardMaterial3D / ORMMaterial3D)

  • Les textures ORM compressées vont dans ORMMaterial3D. L'albedo est en sRGB. Les cartes de normale, ORM et rugosité s'importent en linéaire (Godot détecte les cartes de normale lorsque vous les assignez).
  • Transparence : privilégiez TRANSPARENCY_ALPHA_SCISSOR ou ALPHA_HASH (feuillage, trié en profondeur gratuitement). Utilisez ALPHA uniquement pour le verre et les VFX, car cela provoque des problèmes de tri et aucune ombre.
  • Utilisez material_override (maillage entier) et set_surface_override_material(i, m) par instance. Ne modifiez pas un matériau partagé en cours d'exécution à moins que tous les utilisateurs ne doivent changer. Dupliquez-le d'abord avec duplicate().
  • Stencil (4.5+) : stencil_mode = STENCIL_MODE_OUTLINE ou STENCIL_MODE_XRAY donne des contours et une vision à travers les murs sans shaders personnalisés.
  • Les nœuds Decal se projettent sur n'importe quelle surface (pas en mode Compatibilité).

Import (glTF 2.0 / .glb préféré)

  • Dans Blender, exportez en GLB avec +Y vers le haut et les transformations appliquées. Godot importe dans .godot/imported. Configurez via le dock d'import ou les "Paramètres d'import avancés" (LOD par maillage, collisions, matériaux, clips d'animation).
  • Les suffixes de noms dans le fichier source créent automatiquement des nœuds : -col, -convcol, -colonly, -convcolonly (collision), -rigid, -navmesh, -occ/-occonly (occudeurs), -noimp (sauter), -loop/-cycle (animation en boucle).
  • Importer .blend directement nécessite Blender installé et filesystem/import/blender/enabled. Utilisez GLB en CI.
  • Conservez les matériaux édités lors des réimportations avec l'option d'import de scène materials/extract = 1 (Extraire une fois), ou Import avancé → "Enregistrer dans un fichier" par matériau. Listez toutes les options d'import avec api_lookup.py ResourceImporterScene.
  • Pour la création d'actifs et l'export depuis Blender, consultez la compétence blender-export-pipelines si elle est installée.

Mise à l'échelle des détails

  • Le LOD automatique des maillages est généré à l'import. Ajustez-le par viewport avec mesh_lod_threshold, où des valeurs plus élevées sont plus agressives.
  • visibility_range_begin/end (+ fondu) gère le HLOD et les imposteurs et élimine les accessoires éloignés.
  • Occlusion culling : activez rendering/occlusion_culling/use_occlusion_culling, ajoutez OccluderInstance3D, et cuisez. Cela aide les scènes intérieures et urbaines.
  • Mise à l'échelle de la résolution : Viewport.scaling_3d_mode (FSR 1, FSR2 sur Forward+, MetalFX sur Apple) plus scaling_3d_scale. Anti-aliasing : MSAA 3D, screen_space_aa (FXAA, SMAA 4.5+) ou TAA (Forward+).

Sortie HDR (4.7)

Activez display/window/hdr/request_hdr_output (ou Window.hdr_output_requested). C'est pris en charge sur Windows, macOS, iOS, visionOS et Linux Wayland, et cela revient automatiquement au SDR. Vérifiez DisplayServer.window_is_hdr_output_supported() et exposez un bouton de basculement et des options de luminosité dans les paramètres.

Environnement, préréglages d'éclairage, matériaux et code LOD (compilés par les tests) : references/recipes.md

Individual skills in this repo

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

Skills associés