3D-Rendering (4.7)
Shader und VFX befinden sich in godot-shaders-vfx, und die Arbeit an der Bildrate ist in godot-performance. Headless-Ausführungen rendern nicht. Fragen Sie den Benutzer nach Screenshots oder verwenden Sie ein Godot MCP Screenshot-Tool, falls eines angeschlossen ist.
Wählen Sie zuerst den Renderer (rendering/renderer/rendering_method)
| Funktion | Compatibility | Mobile | Forward+ |
|---|---|---|---|
| Zielgeräte | Web (einzige Option), Low-End | Telefone und Tablets, XR (empfohlen) | Desktop und Konsole |
| SDFGI, VoxelGI, SSR, SSIL, volumetrischer Nebel, TAA, FSR2 | nein | nein | ja |
| LightmapGI | nur rendern (Bake auf RD-Hardware) | ja | ja |
| SSAO | ja | nein | ja |
| Decals, Compositor-Effekte, HDR 2D, DOF-Unschärfe | nein | ja | ja |
| Glühen, Nebel (Tiefe und Höhe), Tonemapping, MSAA 3D | ja | ja | ja |
| Omni- und Spotlichter pro Mesh | 8 | 8 (256 pro View) | geclustert, 512 pro Cluster |
| AreaLight3D-Schatten | keine | annähernder Halbschatten | PCSS |
Legen Sie eine plattformspezifische Überschreibung mit rendering_method.mobile fest. Überprüfen Sie die aktuelle Wahl mit project_inspect.py. Windows verwendet standardmäßig D3D12 für neue Projekte (4.6+), und macOS/iOS verwenden Metal. |
Umgebungsrezept (WorldEnvironment → Environment)
- Himmel:
Sky+ProceduralSkyMaterial(stilisiert),PhysicalSkyMaterial(realistisch, passt zu physikalischen Lichteinheiten) oderPanoramaSkyMaterial(HDRI). Setzen Sie den Hintergrundmodus auf Himmel und das Umgebungs-/reflektierte Licht vom Himmel. - Tonemapping:
TONE_MAPPER_AGXfür natürliche Glanzlichter (passen Sietonemap_agx_white/tonemap_agx_contrastan, 4.6+). Verwenden Sie Filmic/ACES nur, um ein bestehendes Aussehen zu erreichen. - Glühen (Glow): Seit 4.6 wird es vor dem Tonemapping gemischt und standardmäßig im Screen-Modus mit geringerer Intensität angewendet. Halten Sie
glow_intensityniedrig und verwenden Sie emittierende Materialien mit einer Energie über 1 für Bloom. - Forward+ Extras: SSAO und SSIL (Kontaktschatten, Reflektionen), SSR (nasse Böden; es gab eine große Überarbeitung in 4.6, mit einer Halb-Auflösungs-Option), volumetrischer Nebel plus
FogVolumefür Lichtstrahlen und SDFGI für große dynamische GI. CameraAttributesPractical(DOF, automatische Belichtung) oderCameraAttributesPhysical(echte Blende, Verschluss und ISO) werden am WorldEnvironment oder an der Camera3D gesetzt.
Lichter und Schatten
DirectionalLight3D(Sonne):directional_shadow_modePSSM 4 Splits. Halten Siedirectional_shadow_max_distanceso klein wie möglich (100–200 m), da dies die Schattenauflösung verbessert.- Omni- und Spotlichter: Schalten Sie Schatten nur für die Lichter ein, die wichtig sind. Verwenden Sie
distance_fade_*für weit entfernte Lichter. AreaLight3D(4.7): Weiches, rechteckiges Licht von Bildschirmen, Fenstern und Neon. Setzen Siearea_size, optional einarea_textureundarea_normalize_energy. Es ist teurer als Omni- oder Spotlichter, verwenden Sie daher nur wenige davon.- Statische Lichter werden in
LightmapGImitlight_bake_mode = BAKE_STATICeingebrannt. Dynamische Lichter bleibenBAKE_DYNAMIC.
Globale Beleuchtungsauswahl
| Bedarf | Verwendung |
|---|---|
| Statische Level, beste Qualität, jeder Renderer außer Compatibility Baking | LightmapGI (im Editor backen; benötigt UV2: Aktivieren Sie "Lightmap UV" beim Import) |
| Dynamische Objekte in einem mittelgroßen statischen Bereich | VoxelGI (backen, Forward+) |
| Riesige oder offene Welt, Tageszeit, kein Backen | SDFGI (Environment, Forward+) |
| Reflexionen auf glänzenden Oberflächen | ReflectionProbe (setzen Sie interior für Innenbereiche), plus SSR |
| Kombinieren Sie sie: Lightmaps für statische Beleuchtung, Light-Probes oder VoxelGI für dynamische Objekte und ReflectionProbes überall dort, wo Glanz benötigt wird. |
Materialien (StandardMaterial3D / ORMMaterial3D)
- ORM-gepackte Texturen werden in
ORMMaterial3Dverwendet. Albedo ist sRGB. Normal-, ORM- und Rauheitskarten werden linear importiert (Godot erkennt Normal Maps, wenn Sie sie zuweisen). - Transparenz: Bevorzugen Sie
TRANSPARENCY_ALPHA_SCISSORoderALPHA_HASH(Laub, automatisch nach Tiefe sortiert). Verwenden SieALPHAnur für Glas und VFX, da es Sortierprobleme verursacht und keine Schatten wirft. - Verwenden Sie
material_override(gesamtes Mesh) undset_surface_override_material(i, m)pro Instanz. Bearbeiten Sie kein geteiltes Material zur Laufzeit, es sei denn, jeder Benutzer soll die Änderung sehen. Kopieren Sie es zuerst mitduplicate(). - Stencil (4.5+):
stencil_mode = STENCIL_MODE_OUTLINEoderSTENCIL_MODE_XRAYerzeugt Umrisse und Durchsicht-Wände-Effekte ohne benutzerdefinierte Shader. Decal-Nodes projizieren auf jede Oberfläche (nicht in Compatibility).
Import (glTF 2.0 / .glb bevorzugt)
- Exportieren Sie in Blender GLB mit +Y nach oben und angewendeten Transformationen. Godot importiert nach
.godot/imported. Konfigurieren Sie über den Import-Dock oder die "Erweiterten Importeinstellungen" (pro-Mesh LOD, Kollisionen, Materialien, Animationsclips). - Namenssuffixe in der Quelldatei erstellen automatisch Nodes:
-col,-convcol,-colonly,-convcolonly(Kollision),-rigid,-navmesh,-occ/-occonly(Occluder),-noimp(überspringen),-loop/-cycle(loopende Animation). - Der direkte Import von
.blenderfordert installiertes Blender undfilesystem/import/blender/enabled. Verwenden Sie GLB in CI. - Behalten Sie bearbeitete Materialien über Neuimporte hinweg mit der Szenenimport-Option
materials/extract = 1(Einmal extrahieren) oder Erweiterter Import → pro-Material "In Datei speichern". Listen Sie alle Importoptionen mitapi_lookup.py ResourceImporterSceneauf. - Zur Erstellung von Assets und Export aus Blender siehe das
blender-export-pipelinesSkill, falls es installiert ist.
Detailskalierung
- Automatisches Mesh-LOD wird beim Import generiert. Passen Sie es pro Viewport mit
mesh_lod_thresholdan, wobei höhere Werte aggressiver sind. visibility_range_begin/end(+ Fade) verwaltet HLOD und Impostors und verwirft weit entfernte Objekte.- Occlusion Culling: Aktivieren Sie
rendering/occlusion_culling/use_occlusion_culling, fügen SieOccluderInstance3Dhinzu und backen Sie es. Es hilft in Innen- und Stadtszenen. - Auflösungsskalierung:
Viewport.scaling_3d_mode(FSR 1, FSR2 auf Forward+, MetalFX auf Apple) plusscaling_3d_scale. Anti-Aliasing: MSAA 3D,screen_space_aa(FXAA, SMAA 4.5+) oder TAA (Forward+).
HDR-Ausgabe (4.7)
Aktivieren Sie display/window/hdr/request_hdr_output (oder Window.hdr_output_requested). Es wird auf Windows, macOS, iOS, visionOS und Linux Wayland unterstützt und fällt automatisch auf SDR zurück. Überprüfen Sie DisplayServer.window_is_hdr_output_supported() und machen Sie einen Umschalter und Helligkeitsoptionen in den Einstellungen verfügbar.
Umgebung, Beleuchtungsvoreinstellungen, Material- und LOD-Code (von den Tests kompiliert): references/recipes.md