CommunityCodierung & Entwicklunggithub.com

3D-Rendering in Godot 4.7

Erzeugt einen 3D-Look in Godot 4.7. Behandelt die Renderer-Auswahl (Forward+/Mobile/Compatibility-Matrix), die Umgebung (AgX, Glühen, Nebel, SSAO/SSR/SDFGI), Beleuchtung inklusive AreaLight3D, GI (SDFGI, VoxelGI, LightmapGI), HDR-Ausgabe, Materialien, glTF/Blender-Import-Suffixe, LOD und Occlusion Culling. Verwenden Sie es für 3D-Szenen, Beleuchtung, Materialien, Modellimport oder visuelle Qualität.

Was ist 3D-Rendering in Godot 4.7?

Dieses Skill bietet eine umfassende Anleitung zur Erstellung hochwertiger 3D-Renderings in Godot 4.7. Es führt durch die Auswahl des geeigneten Renderers (Forward+, Mobile, Compatibility) basierend auf der Zielplattform und den gewünschten Effekten. Es beschreibt detailliert die Konfiguration der Umgebung (Environment) mit Himmelsarten, Tonemapping (insbesondere AgX), Glühen, Nebel, SSAO, SSR und volumetrischem Nebel. Für die Beleuchtung werden die verschiedenen Lichttypen (DirectionalLight3D, Omni-/Spot-Lights und das neue AreaLight3D) sowie Schatteneinstellungen erklärt. Das Skill deckt auch die Globalbeleuchtungsoptionen (LightmapGI, VoxelGI, SDFGI) und deren Kombinationen ab, sowie Materialien (StandardMaterial3D/ORMMaterial3D) mit Tipps zu Transparenz, Stencil-Effekten und Decals. Es enthält Anleitungen zum Import von 3D-Modellen (glTF/GLB), inklusive der Verwendung von Namenssuffixen für automatische Node-Erstellung, und zur Detailskalierung mit LOD, Sichtweiten und Occlusion Culling. Zuletzt wird die HDR-Ausgabe für kompatible Systeme beschrieben.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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)

FunktionCompatibilityMobileForward+
ZielgeräteWeb (einzige Option), Low-EndTelefone und Tablets, XR (empfohlen)Desktop und Konsole
SDFGI, VoxelGI, SSR, SSIL, volumetrischer Nebel, TAA, FSR2neinneinja
LightmapGInur rendern (Bake auf RD-Hardware)jaja
SSAOjaneinja
Decals, Compositor-Effekte, HDR 2D, DOF-Unschärfeneinjaja
Glühen, Nebel (Tiefe und Höhe), Tonemapping, MSAA 3Djajaja
Omni- und Spotlichter pro Mesh88 (256 pro View)geclustert, 512 pro Cluster
AreaLight3D-Schattenkeineannähernder HalbschattenPCSS
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) oder PanoramaSkyMaterial (HDRI). Setzen Sie den Hintergrundmodus auf Himmel und das Umgebungs-/reflektierte Licht vom Himmel.
  • Tonemapping: TONE_MAPPER_AGX für natürliche Glanzlichter (passen Sie tonemap_agx_white/tonemap_agx_contrast an, 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_intensity niedrig 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 FogVolume für Lichtstrahlen und SDFGI für große dynamische GI.
  • CameraAttributesPractical (DOF, automatische Belichtung) oder CameraAttributesPhysical (echte Blende, Verschluss und ISO) werden am WorldEnvironment oder an der Camera3D gesetzt.

Lichter und Schatten

  • DirectionalLight3D (Sonne): directional_shadow_mode PSSM 4 Splits. Halten Sie directional_shadow_max_distance so 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 Sie area_size, optional ein area_texture und area_normalize_energy. Es ist teurer als Omni- oder Spotlichter, verwenden Sie daher nur wenige davon.
  • Statische Lichter werden in LightmapGI mit light_bake_mode = BAKE_STATIC eingebrannt. Dynamische Lichter bleiben BAKE_DYNAMIC.

Globale Beleuchtungsauswahl

BedarfVerwendung
Statische Level, beste Qualität, jeder Renderer außer Compatibility BakingLightmapGI (im Editor backen; benötigt UV2: Aktivieren Sie "Lightmap UV" beim Import)
Dynamische Objekte in einem mittelgroßen statischen BereichVoxelGI (backen, Forward+)
Riesige oder offene Welt, Tageszeit, kein BackenSDFGI (Environment, Forward+)
Reflexionen auf glänzenden OberflächenReflectionProbe (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 ORMMaterial3D verwendet. Albedo ist sRGB. Normal-, ORM- und Rauheitskarten werden linear importiert (Godot erkennt Normal Maps, wenn Sie sie zuweisen).
  • Transparenz: Bevorzugen Sie TRANSPARENCY_ALPHA_SCISSOR oder ALPHA_HASH (Laub, automatisch nach Tiefe sortiert). Verwenden Sie ALPHA nur für Glas und VFX, da es Sortierprobleme verursacht und keine Schatten wirft.
  • Verwenden Sie material_override (gesamtes Mesh) und set_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 mit duplicate().
  • Stencil (4.5+): stencil_mode = STENCIL_MODE_OUTLINE oder STENCIL_MODE_XRAY erzeugt 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 .blend erfordert installiertes Blender und filesystem/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 mit api_lookup.py ResourceImporterScene auf.
  • Zur Erstellung von Assets und Export aus Blender siehe das blender-export-pipelines Skill, falls es installiert ist.

Detailskalierung

  • Automatisches Mesh-LOD wird beim Import generiert. Passen Sie es pro Viewport mit mesh_lod_threshold an, 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 Sie OccluderInstance3D hinzu und backen Sie es. Es hilft in Innen- und Stadtszenen.
  • Auflösungsskalierung: Viewport.scaling_3d_mode (FSR 1, FSR2 auf Forward+, MetalFX auf Apple) plus scaling_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

Individual skills in this repo

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

Verwandte Skills