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é | Mobile | Forward+ |
|---|---|---|---|
| Cibles | web (seule option), bas de gamme | téléphones et tablettes, XR (recommandé) | bureau et console |
| SDFGI, VoxelGI, SSR, SSIL, brouillard volumétrique, TAA, FSR2 | non | non | oui |
| LightmapGI | rendu uniquement (cuisson sur matériel RD) | oui | oui |
| SSAO | oui | non | oui |
| Décalcomanies, effets de composition, HDR 2D, flou de profondeur de champ (DOF) | non | oui | oui |
| Lueur, brouillard (profondeur et hauteur), mappage de tons, MSAA 3D | oui | oui | oui |
| Lumières omni et projecteur par maillage | 8 | 8 (256 par vue) | groupées (clustered), 512 par cluster |
| Ombres AreaLight3D | aucune | pénombre approximative | PCSS |
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) ouPanoramaSkyMaterial(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_AGXpour des hautes lumières naturelles (ajusteztonemap_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_intensitybas 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
FogVolumepour les rayons lumineux, et SDFGI pour une illumination globale dynamique à grande échelle. CameraAttributesPractical(profondeur de champ, exposition automatique) ouCameraAttributesPhysical(réels f-stop, obturateur et ISO) se placent sur le WorldEnvironment ou la Camera3D.
Lumières et ombres
DirectionalLight3D(soleil) :directional_shadow_modePSSM 4 splits. Gardezdirectional_shadow_max_distanceaussi 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éfinissezarea_size, unarea_textureoptionnel etarea_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
LightmapGIaveclight_bake_mode = BAKE_STATIC. Les lumières dynamiques restentBAKE_DYNAMIC.
Choix d'illumination globale
| Besoin | Utilisez |
|---|---|
| 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 moyenne | VoxelGI (cuisson, Forward+) |
| Monde immense ou ouvert, heure du jour, pas de cuisson | SDFGI (Environment, Forward+) |
| Réflexions sur surfaces brillantes | ReflectionProbe (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_SCISSORouALPHA_HASH(feuillage, trié en profondeur gratuitement). UtilisezALPHAuniquement pour le verre et les VFX, car cela provoque des problèmes de tri et aucune ombre. - Utilisez
material_override(maillage entier) etset_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 avecduplicate(). - Stencil (4.5+) :
stencil_mode = STENCIL_MODE_OUTLINEouSTENCIL_MODE_XRAYdonne des contours et une vision à travers les murs sans shaders personnalisés. - Les nœuds
Decalse 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
.blenddirectement nécessite Blender installé etfilesystem/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 avecapi_lookup.py ResourceImporterScene. - Pour la création d'actifs et l'export depuis Blender, consultez la compétence
blender-export-pipelinessi 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, ajoutezOccluderInstance3D, 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) plusscaling_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