[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6KR5Z014T3R5RH0E9RT262D":3,"skill-same:01M6KR5Z014T3R5RH0E9RT262D":99},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":33,"linkOnly":34,"markdownContent":35,"markdownBody":36,"frontMatter":37,"refName":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":6,"ownerHtmlUrl":43,"ownerBlogUrl":44,"ownerDescription":45,"updatedAt":46,"install":47,"resources":60},"01M6KR5Z014T3R5RH0E9RT262D","3d-essentials",null,"Use when working with 3D-specific systems — materials, lighting, shadows, environment, global illumination, fog, LOD, occlusion culling, and decals in Godot 4.3+","jame581\u002FGodotPrompter","jame581","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F21112138?v=4","01M6KR3KEQ9Z30WVJRR2E2ZVXE","Jan Mesarč","01M6KR3KJVRMPDSMASQPBCBVK3",964,"MIT","https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32],"3D","3d essentials","environment","lod","use","lighting","materials","with","systems","godot 4","godot","global","occlusion","when","2026-11-10 10:12:30",false,"---\nname: 3d-essentials\ndescription: Use when working with 3D-specific systems — materials, lighting, shadows, environment, global illumination, fog, LOD, occlusion culling, and decals in Godot 4.3+\n---\n\n# 3D Essentials in Godot 4.3+\n\nAll examples target Godot 4.3+ with no deprecated APIs. GDScript is shown first, then C#.\n\n> **Related skills:** **rendering-pipeline** for renderer choice, lighting strategy, AA and resolution scaling, **player-controller** for CharacterBody3D movement, **physics-system** for 3D collision shapes and raycasting, **camera-system** for Camera3D follow and transitions, **shader-basics** for spatial shaders and post-processing, **godot-optimization** for 3D performance tuning, **animation-system** for AnimationTree and 3D animation blending.\n\n---\n\n## 1. 3D Coordinate System & Core Nodes\n\n### Coordinate System\n\nGodot uses a **right-handed** coordinate system with metric units (1 unit = 1 meter):\n\n| Axis | Direction | Color |\n|------|-----------|--------|\n| X | Right | Red |\n| Y | Up | Green |\n| Z | Out of screen (+Z toward viewer) | Blue |\n\n> Cameras and lights point along **-Z** by default. When a character \"faces forward,\" they look along -Z.\n\n### Essential 3D Nodes\n\n| Node | Purpose |\n|--------------------|-------------------------------------------------|\n| `Node3D` | Base transform node — position, rotation, scale |\n| `MeshInstance3D` | Displays a mesh with a material |\n| `Camera3D` | Required to render 3D — perspective or orthogonal |\n| `DirectionalLight3D` | Sun\u002Fmoon — parallel rays, cheapest light |\n| `OmniLight3D` | Point light — emits in all directions |\n| `SpotLight3D` | Cone light — flashlights, spotlights |\n| `WorldEnvironment` | Sky, fog, tonemap, post-processing |\n| `Decal` | Projected texture onto surfaces |\n| `GPUParticles3D` | GPU-driven particle effects |\n| `CSGBox3D` etc. | Constructive Solid Geometry — prototyping |\n| `GridMap` | 3D tile-based level building |\n\n> **Godot 4.7+:** `GridMap` exposes its internal octants for spatial queries (`cell_octant_size`, `get_used_octants()`, `get_octants_in_bounds()` and friends) so you can scope work to a region instead of walking every cell. `CSGShape3D` gains `autosmooth` \u002F `smoothing_angle` for automatic face smoothing. Full method table and semantics: [references\u002Fgodot-4.7-additions.md](references\u002Fgodot-4.7-additions.md)\n\n### Minimal 3D Scene\n\n```\nWorld (Node3D)\n├── Camera3D\n├── DirectionalLight3D\n├── WorldEnvironment\n├── MeshInstance3D (floor)\n└── MeshInstance3D (player model)\n```\n\n---\n\n## 2. Materials\n\n### StandardMaterial3D vs ShaderMaterial\n\n| Material | Use For | Notes |\n|----------------------|---------------------------------------------|--------------------------------|\n| `StandardMaterial3D` | Most 3D objects — PBR workflow | No code; Inspector-driven |\n| `ORMMaterial3D` | Same as Standard but with packed ORM texture | Occlusion+Roughness+Metallic in one texture |\n| `ShaderMaterial` | Custom effects — toon, water, dissolve | Requires spatial shader code |\n\n### Key StandardMaterial3D Properties\n\nThe PBR core: `albedo_color` \u002F `albedo_texture` (base color), `metallic` (0 dielectric → 1 metal), `roughness` (0 mirror → 1 matte), `normal_texture` with `normal_enabled` (surface detail), `ao_texture` (ambient occlusion). Add `emission` + `emission_energy_multiplier` for self-illumination, `heightmap_texture` for parallax, `rim` \u002F `clearcoat` for material flair.\n\n### Transparency Modes\n\nPrefer Alpha Scissor (fast, shadowed cutouts) or Alpha Hash (dithered — hair) over plain Alpha (slow, no shadows); Depth Pre-Pass suits mostly-opaque meshes with transparent edges.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#transparency-modes) for the comparison table.\n\n### Setting Materials from Code & Material Instancing\n\nCreate a `StandardMaterial3D` at runtime, assign to `mesh.material_override`, and drive emissive flashes via Tween. Use `.duplicate()` to make per-instance copies so changing one mesh's material doesn't affect others.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md) for the full GDScript and C# recipes (basic material setup, emissive flash, per-instance duplicate, dynamic OmniLight3D explosion).\n\n---\n\n## 3. Lighting\n\n### Light Types Comparison\n\n| Light | Shape | Shadows | Cost | Max Visible |\n|---------------------|---------------|---------|---------|----------------------|\n| `DirectionalLight3D` | Parallel rays | PSSM | Cheapest | 8 (Forward+) |\n| `OmniLight3D` | Sphere | Cube\u002FDual Paraboloid | Medium | 512 clustered* |\n| `SpotLight3D` | Cone | Single texture | Cheap | 512 clustered* |\n| `AreaLight3D` (4.7+) | Rectangle | PCSS soft | Most expensive | — |\n\n*Forward+ shares 512 clustered element slots among omni lights, spot lights, decals, and reflection probes.\n\n### Light Properties\n\nKey knobs: `light_color`, `light_energy` (HDR — values >1 are valid), `shadow_enabled` (big perf hit), `directional_shadow_mode`, `directional_shadow_max_distance` (lower = sharper shadows).\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#light-properties) for the properties table and the GDScript + C# sun setup snippet.\n\n### AreaLight3D (Godot 4.7+)\n\n`AreaLight3D` emits light from a rectangle along the node's **-Z** (neon tubes, screens, softbox panels), with PCSS soft shadows driven by `light_size`. Mobile support is limited and Compatibility cannot cast area-light shadows; in Forward+ one visible area light adds clustered-lighting cost to *all* rendered objects, so reserve it for cinematics or high-end targets.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#arealight3d-godot-47) for the full property table and the GDScript + C# setup recipe.\n\n### Dynamic Point Light\n\nSpawn an `OmniLight3D` at runtime, drive its energy with a tween, queue-free on completion. Common for explosions, muzzle flashes, magic effects.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#dynamic-point-light) for the full GDScript and C# recipe.\n\n### Shadow Configuration & Bake Modes\n\nPrefer `shadow_normal_bias` over `shadow_bias` against acne; keep `directional_shadow_max_distance` at the minimum needed (50–100 m typical). Bake modes: Disabled (fully real-time, ignored by GI), Static (fully baked, no runtime cost), Dynamic (the default; indirect baked into lightmaps, direct real-time).\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#shadow-configuration-tips) for the shadow-tuning table and the bake-modes table.\n\n> **Godot 4.8+:** Screen-space contact shadows (Forward+ only; `rendering\u002Flights_and_shadows\u002Fcontact_shadow\u002Fenabled`, default `false`) add the small shadows shadow maps miss. Light properties and `LightmapGI.specular_intensity`: [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#contact-shadows-godot-48).\n\n---\n\n## 4. Environment & Post-Processing\n\nConfigure global rendering — sky background, tonemapping, glow, SSR, SSAO\u002FSSIL\u002FSDFGI, depth-of-field — through a `WorldEnvironment` node holding an `Environment` resource. Pick a tonemap (`Linear`, `Reinhard`, `Filmic`, `ACES`, or `AgX` from Godot 4.4) on the Environment resource. Forward+ enables SSAO, SSIL, SSR, and SDFGI; the Mobile renderer omits them, and Compatibility has only SSAO (since 4.6).\n\n> See [references\u002Fenvironment-and-post.md](references\u002Fenvironment-and-post.md) for the full setup recipes (sky options, tonemap modes, all post-processing effects, the 4.6+ glow blend and default changes, AgX `tonemap_agx_white` \u002F `tonemap_agx_contrast` controls, and the 4.6+ SSR quality upgrade).\n\n> **Godot 4.7+:** `display\u002Fwindow\u002Fhdr\u002Frequest_hdr_output` requests HDR display output (read at startup; toggle `Window.hdr_output_requested` at runtime). ⚠️ The `rendering\u002Freflections\u002Fsky_reflections\u002Froughness_layers` default is `8` again after `7` in 4.6.0–4.6.1. Details in [references\u002Fenvironment-and-post.md](references\u002Fenvironment-and-post.md#hdr-output-and-sky-reflection-layers-godot-47).\n\n> **Changed in Godot 4.8:** New projects enable `rendering\u002Flights_and_shadows\u002Fmulti_bounce_occlusion\u002Fenabled` (Forward+ only; class default `false`), which approximates multi-bounce GI in ambient occlusion from albedo. SSAO and AO maps look different from an upgraded project.\n\n## 5. Global Illumination\n\nFive GI options trade quality for cost: none (ambient only) → ReflectionProbe (localized) → LightmapGI (best quality, baked) → VoxelGI (small\u002Fmedium dynamic) → SDFGI (large open-world). VoxelGI and SDFGI require Forward+; LightmapGI plays on all three renderers but bakes only in a Forward+ or Mobile editor. The 4.5+ subsection below applies across GI methods.\n\n> See [references\u002Fglobal-illumination.md](references\u002Fglobal-illumination.md) for the methods comparison table, ReflectionProbe scene + code recipe, LightmapGI bake workflow, and SDFGI configuration.\n\n### Specular Occlusion & Bent Normal Maps (Godot 4.5+)\n\nSince 4.5, indirect specular is dimmed by the ambient light reaching each pixel, in all renderers — on by default, no re-bake; disable globally with `rendering\u002Freflections\u002Fspecular_occlusion\u002Fenabled` or per shader with `render_mode specular_occlusion_disabled`. The `StandardMaterial3D` **Bent Normal** slot takes a baked bent normal map for better indirect lighting on hero assets.\n\n> See [references\u002Fglobal-illumination.md](references\u002Fglobal-illumination.md#specular-occlusion-from-ambient-light-godot-45) for when each one matters and the bent normal setup.\n\n---\n\n## 6. Fog\n\nThree layers: depth\u002Fheight fog set on `WorldEnvironment.environment` (cheap, all renderers), volumetric fog (Forward+ only — godrays through depth), and `FogVolume` nodes for localized fog effects (interior rooms, pits, atmospheric volumes).\n\n> See [references\u002Ffog-recipes.md](references\u002Ffog-recipes.md) for the full GDScript and C# recipes — depth\u002Fheight fog setup, volumetric fog parameters and performance notes, and FogVolume placement.\n\n> ⚠️ **Changed in Godot 4.7:** New project setting `rendering\u002Fenvironment\u002Ffog\u002Fuse_legacy_blending` (default `false`) restores the volumetric fog blending of Godot 4.5 and earlier ([GH-119414](https:\u002F\u002Fgithub.com\u002Fgodotengine\u002Fgodot\u002Fpull\u002F119414); also on the 4.6 branch). The blending itself changed in **4.6**, which made it more physically accurate, so fog tuned on 4.5 looks brighter after upgrading ([GH-112494](https:\u002F\u002Fgithub.com\u002Fgodotengine\u002Fgodot\u002Fpull\u002F112494)). Enable the setting to get the old look back exactly; otherwise lower the fog density or the lights' Volumetric Fog Energy.\n\n## 7. Decals\n\n`Decal` nodes project a texture onto whatever surfaces fall within their bounding box — bullet holes, blood splatter, ground details, signage. Forward+ and Mobile render decals; Compatibility does not. Performance scales with overdraw and decal count.\n\n> See [references\u002Fdecals.md](references\u002Fdecals.md) for the scene setup, runtime spawning recipe (GDScript + C#), and the per-renderer decal limits.\n\n---\n\n## 8. Optimization — LOD, Culling, MultiMesh\n\nFour tools: automatic mesh LOD (set on import or per `MeshInstance3D`), manual `VisibilityRange` for staged swaps, occlusion culling via `OccluderInstance3D`, and `MultiMeshInstance3D` for thousands of identical meshes in one draw call.\n\n> See [references\u002Flod-and-culling.md](references\u002Flod-and-culling.md) for setup recipes for each tool plus the MultiMesh runtime population example.\n\n## 9. Renderer Comparison\n\nPick the renderer before you build the look: **Forward+** (desktop default) is the only one with SDFGI and volumetric fog, **Mobile** trades those for performance on tile-based GPUs, and **Compatibility** (GLES3-class) drops most advanced lighting entirely. Advice that assumes SDFGI silently fails on the other two.\n\nFull feature-by-renderer table and selection guidance: [references\u002Frenderer-comparison.md](references\u002Frenderer-comparison.md)\n\n---\n\n## 10. Common Pitfalls\n\nQuick symptom → cause → fix table covering black scenes, dark objects without ambient light, shadow acne and peter-panning, popping shadows, flat materials, invisible decals, transparency sorting artifacts, SDFGI light leaking, missing volumetric fog, and invisible MultiMesh instances.\n\n> See [references\u002Fcommon-pitfalls.md](references\u002Fcommon-pitfalls.md) for the full table.\n\n---\n\n## 11. Implementation Checklist\n\n- [ ] Scene has Camera3D, at least one light source, and WorldEnvironment\n- [ ] Environment has a sky material (procedural or HDR panorama) for ambient and reflected light\n- [ ] Tonemap mode is set (Filmic or ACES for realistic look, AgX (4.4+) for physically accurate)\n- [ ] DirectionalLight3D has shadows enabled with `shadow_normal_bias` tuned to prevent acne\n- [ ] `directional_shadow_max_distance` is set to the minimum needed (50–100m typical)\n- [ ] Static geometry uses StandardMaterial3D with appropriate PBR textures (albedo, normal, roughness, metallic)\n- [ ] Transparent materials use Alpha Scissor or Alpha Hash instead of Alpha where possible (performance + shadows)\n- [ ] ReflectionProbes are placed in rooms\u002Fareas with reflective surfaces\n- [ ] GI method chosen based on project needs (LightmapGI for static, SDFGI for large dynamic, VoxelGI for small dynamic)\n- [ ] Mesh LOD is enabled on import (default for glTF\u002FBlend — verify OBJ files)\n- [ ] Occlusion culling is enabled and baked for scenes with heavy occlusion (indoor, urban)\n- [ ] MultiMeshInstance3D is used for instanced geometry (grass, trees, props) instead of individual nodes\n- [ ] Renderer matches target platform (Forward+ desktop, Mobile mobile, Compatibility web)\n- [ ] Specular occlusion (on by default since Godot 4.5) is left enabled, or disabled deliberately via `rendering\u002Freflections\u002Fspecular_occlusion\u002Fenabled` where reflections look too dim\n- [ ] Hero assets with complex surface detail use bent normal maps in the StandardMaterial3D Bent Normal slot for improved indirect lighting (Godot 4.5+)\n- [ ] After upgrading to Godot 4.6, glow settings are re-tuned if appearance has changed (default blend mode is now Screen and glow is blended before tonemapping)\n- [ ] AgX `tonemap_agx_white` and `tonemap_agx_contrast` are adjusted when using AgX tonemapper for precise look control (Godot 4.6+)\n- [ ] After upgrading, volumetric fog (blending changed in 4.6; 4.7 adds `use_legacy_blending`) and sky reflections (`roughness_layers` differed in 4.6.0–4.6.1) are re-checked\n","# 3D Essentials in Godot 4.3+\n\nAll examples target Godot 4.3+ with no deprecated APIs. GDScript is shown first, then C#.\n\n> **Related skills:** **rendering-pipeline** for renderer choice, lighting strategy, AA and resolution scaling, **player-controller** for CharacterBody3D movement, **physics-system** for 3D collision shapes and raycasting, **camera-system** for Camera3D follow and transitions, **shader-basics** for spatial shaders and post-processing, **godot-optimization** for 3D performance tuning, **animation-system** for AnimationTree and 3D animation blending.\n\n---\n\n## 1. 3D Coordinate System & Core Nodes\n\n### Coordinate System\n\nGodot uses a **right-handed** coordinate system with metric units (1 unit = 1 meter):\n\n| Axis | Direction | Color |\n|------|-----------|--------|\n| X | Right | Red |\n| Y | Up | Green |\n| Z | Out of screen (+Z toward viewer) | Blue |\n\n> Cameras and lights point along **-Z** by default. When a character \"faces forward,\" they look along -Z.\n\n### Essential 3D Nodes\n\n| Node | Purpose |\n|--------------------|-------------------------------------------------|\n| `Node3D` | Base transform node — position, rotation, scale |\n| `MeshInstance3D` | Displays a mesh with a material |\n| `Camera3D` | Required to render 3D — perspective or orthogonal |\n| `DirectionalLight3D` | Sun\u002Fmoon — parallel rays, cheapest light |\n| `OmniLight3D` | Point light — emits in all directions |\n| `SpotLight3D` | Cone light — flashlights, spotlights |\n| `WorldEnvironment` | Sky, fog, tonemap, post-processing |\n| `Decal` | Projected texture onto surfaces |\n| `GPUParticles3D` | GPU-driven particle effects |\n| `CSGBox3D` etc. | Constructive Solid Geometry — prototyping |\n| `GridMap` | 3D tile-based level building |\n\n> **Godot 4.7+:** `GridMap` exposes its internal octants for spatial queries (`cell_octant_size`, `get_used_octants()`, `get_octants_in_bounds()` and friends) so you can scope work to a region instead of walking every cell. `CSGShape3D` gains `autosmooth` \u002F `smoothing_angle` for automatic face smoothing. Full method table and semantics: [references\u002Fgodot-4.7-additions.md](references\u002Fgodot-4.7-additions.md)\n\n### Minimal 3D Scene\n\n```\nWorld (Node3D)\n├── Camera3D\n├── DirectionalLight3D\n├── WorldEnvironment\n├── MeshInstance3D (floor)\n└── MeshInstance3D (player model)\n```\n\n---\n\n## 2. Materials\n\n### StandardMaterial3D vs ShaderMaterial\n\n| Material | Use For | Notes |\n|----------------------|---------------------------------------------|--------------------------------|\n| `StandardMaterial3D` | Most 3D objects — PBR workflow | No code; Inspector-driven |\n| `ORMMaterial3D` | Same as Standard but with packed ORM texture | Occlusion+Roughness+Metallic in one texture |\n| `ShaderMaterial` | Custom effects — toon, water, dissolve | Requires spatial shader code |\n\n### Key StandardMaterial3D Properties\n\nThe PBR core: `albedo_color` \u002F `albedo_texture` (base color), `metallic` (0 dielectric → 1 metal), `roughness` (0 mirror → 1 matte), `normal_texture` with `normal_enabled` (surface detail), `ao_texture` (ambient occlusion). Add `emission` + `emission_energy_multiplier` for self-illumination, `heightmap_texture` for parallax, `rim` \u002F `clearcoat` for material flair.\n\n### Transparency Modes\n\nPrefer Alpha Scissor (fast, shadowed cutouts) or Alpha Hash (dithered — hair) over plain Alpha (slow, no shadows); Depth Pre-Pass suits mostly-opaque meshes with transparent edges.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#transparency-modes) for the comparison table.\n\n### Setting Materials from Code & Material Instancing\n\nCreate a `StandardMaterial3D` at runtime, assign to `mesh.material_override`, and drive emissive flashes via Tween. Use `.duplicate()` to make per-instance copies so changing one mesh's material doesn't affect others.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md) for the full GDScript and C# recipes (basic material setup, emissive flash, per-instance duplicate, dynamic OmniLight3D explosion).\n\n---\n\n## 3. Lighting\n\n### Light Types Comparison\n\n| Light | Shape | Shadows | Cost | Max Visible |\n|---------------------|---------------|---------|---------|----------------------|\n| `DirectionalLight3D` | Parallel rays | PSSM | Cheapest | 8 (Forward+) |\n| `OmniLight3D` | Sphere | Cube\u002FDual Paraboloid | Medium | 512 clustered* |\n| `SpotLight3D` | Cone | Single texture | Cheap | 512 clustered* |\n| `AreaLight3D` (4.7+) | Rectangle | PCSS soft | Most expensive | — |\n\n*Forward+ shares 512 clustered element slots among omni lights, spot lights, decals, and reflection probes.\n\n### Light Properties\n\nKey knobs: `light_color`, `light_energy` (HDR — values >1 are valid), `shadow_enabled` (big perf hit), `directional_shadow_mode`, `directional_shadow_max_distance` (lower = sharper shadows).\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#light-properties) for the properties table and the GDScript + C# sun setup snippet.\n\n### AreaLight3D (Godot 4.7+)\n\n`AreaLight3D` emits light from a rectangle along the node's **-Z** (neon tubes, screens, softbox panels), with PCSS soft shadows driven by `light_size`. Mobile support is limited and Compatibility cannot cast area-light shadows; in Forward+ one visible area light adds clustered-lighting cost to *all* rendered objects, so reserve it for cinematics or high-end targets.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#arealight3d-godot-47) for the full property table and the GDScript + C# setup recipe.\n\n### Dynamic Point Light\n\nSpawn an `OmniLight3D` at runtime, drive its energy with a tween, queue-free on completion. Common for explosions, muzzle flashes, magic effects.\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#dynamic-point-light) for the full GDScript and C# recipe.\n\n### Shadow Configuration & Bake Modes\n\nPrefer `shadow_normal_bias` over `shadow_bias` against acne; keep `directional_shadow_max_distance` at the minimum needed (50–100 m typical). Bake modes: Disabled (fully real-time, ignored by GI), Static (fully baked, no runtime cost), Dynamic (the default; indirect baked into lightmaps, direct real-time).\n\n> See [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#shadow-configuration-tips) for the shadow-tuning table and the bake-modes table.\n\n> **Godot 4.8+:** Screen-space contact shadows (Forward+ only; `rendering\u002Flights_and_shadows\u002Fcontact_shadow\u002Fenabled`, default `false`) add the small shadows shadow maps miss. Light properties and `LightmapGI.specular_intensity`: [references\u002Fmaterials-and-lighting-recipes.md](references\u002Fmaterials-and-lighting-recipes.md#contact-shadows-godot-48).\n\n---\n\n## 4. Environment & Post-Processing\n\nConfigure global rendering — sky background, tonemapping, glow, SSR, SSAO\u002FSSIL\u002FSDFGI, depth-of-field — through a `WorldEnvironment` node holding an `Environment` resource. Pick a tonemap (`Linear`, `Reinhard`, `Filmic`, `ACES`, or `AgX` from Godot 4.4) on the Environment resource. Forward+ enables SSAO, SSIL, SSR, and SDFGI; the Mobile renderer omits them, and Compatibility has only SSAO (since 4.6).\n\n> See [references\u002Fenvironment-and-post.md](references\u002Fenvironment-and-post.md) for the full setup recipes (sky options, tonemap modes, all post-processing effects, the 4.6+ glow blend and default changes, AgX `tonemap_agx_white` \u002F `tonemap_agx_contrast` controls, and the 4.6+ SSR quality upgrade).\n\n> **Godot 4.7+:** `display\u002Fwindow\u002Fhdr\u002Frequest_hdr_output` requests HDR display output (read at startup; toggle `Window.hdr_output_requested` at runtime). ⚠️ The `rendering\u002Freflections\u002Fsky_reflections\u002Froughness_layers` default is `8` again after `7` in 4.6.0–4.6.1. Details in [references\u002Fenvironment-and-post.md](references\u002Fenvironment-and-post.md#hdr-output-and-sky-reflection-layers-godot-47).\n\n> **Changed in Godot 4.8:** New projects enable `rendering\u002Flights_and_shadows\u002Fmulti_bounce_occlusion\u002Fenabled` (Forward+ only; class default `false`), which approximates multi-bounce GI in ambient occlusion from albedo. SSAO and AO maps look different from an upgraded project.\n\n## 5. Global Illumination\n\nFive GI options trade quality for cost: none (ambient only) → ReflectionProbe (localized) → LightmapGI (best quality, baked) → VoxelGI (small\u002Fmedium dynamic) → SDFGI (large open-world). VoxelGI and SDFGI require Forward+; LightmapGI plays on all three renderers but bakes only in a Forward+ or Mobile editor. The 4.5+ subsection below applies across GI methods.\n\n> See [references\u002Fglobal-illumination.md](references\u002Fglobal-illumination.md) for the methods comparison table, ReflectionProbe scene + code recipe, LightmapGI bake workflow, and SDFGI configuration.\n\n### Specular Occlusion & Bent Normal Maps (Godot 4.5+)\n\nSince 4.5, indirect specular is dimmed by the ambient light reaching each pixel, in all renderers — on by default, no re-bake; disable globally with `rendering\u002Freflections\u002Fspecular_occlusion\u002Fenabled` or per shader with `render_mode specular_occlusion_disabled`. The `StandardMaterial3D` **Bent Normal** slot takes a baked bent normal map for better indirect lighting on hero assets.\n\n> See [references\u002Fglobal-illumination.md](references\u002Fglobal-illumination.md#specular-occlusion-from-ambient-light-godot-45) for when each one matters and the bent normal setup.\n\n---\n\n## 6. Fog\n\nThree layers: depth\u002Fheight fog set on `WorldEnvironment.environment` (cheap, all renderers), volumetric fog (Forward+ only — godrays through depth), and `FogVolume` nodes for localized fog effects (interior rooms, pits, atmospheric volumes).\n\n> See [references\u002Ffog-recipes.md](references\u002Ffog-recipes.md) for the full GDScript and C# recipes — depth\u002Fheight fog setup, volumetric fog parameters and performance notes, and FogVolume placement.\n\n> ⚠️ **Changed in Godot 4.7:** New project setting `rendering\u002Fenvironment\u002Ffog\u002Fuse_legacy_blending` (default `false`) restores the volumetric fog blending of Godot 4.5 and earlier ([GH-119414](https:\u002F\u002Fgithub.com\u002Fgodotengine\u002Fgodot\u002Fpull\u002F119414); also on the 4.6 branch). The blending itself changed in **4.6**, which made it more physically accurate, so fog tuned on 4.5 looks brighter after upgrading ([GH-112494](https:\u002F\u002Fgithub.com\u002Fgodotengine\u002Fgodot\u002Fpull\u002F112494)). Enable the setting to get the old look back exactly; otherwise lower the fog density or the lights' Volumetric Fog Energy.\n\n## 7. Decals\n\n`Decal` nodes project a texture onto whatever surfaces fall within their bounding box — bullet holes, blood splatter, ground details, signage. Forward+ and Mobile render decals; Compatibility does not. Performance scales with overdraw and decal count.\n\n> See [references\u002Fdecals.md](references\u002Fdecals.md) for the scene setup, runtime spawning recipe (GDScript + C#), and the per-renderer decal limits.\n\n---\n\n## 8. Optimization — LOD, Culling, MultiMesh\n\nFour tools: automatic mesh LOD (set on import or per `MeshInstance3D`), manual `VisibilityRange` for staged swaps, occlusion culling via `OccluderInstance3D`, and `MultiMeshInstance3D` for thousands of identical meshes in one draw call.\n\n> See [references\u002Flod-and-culling.md](references\u002Flod-and-culling.md) for setup recipes for each tool plus the MultiMesh runtime population example.\n\n## 9. Renderer Comparison\n\nPick the renderer before you build the look: **Forward+** (desktop default) is the only one with SDFGI and volumetric fog, **Mobile** trades those for performance on tile-based GPUs, and **Compatibility** (GLES3-class) drops most advanced lighting entirely. Advice that assumes SDFGI silently fails on the other two.\n\nFull feature-by-renderer table and selection guidance: [references\u002Frenderer-comparison.md](references\u002Frenderer-comparison.md)\n\n---\n\n## 10. Common Pitfalls\n\nQuick symptom → cause → fix table covering black scenes, dark objects without ambient light, shadow acne and peter-panning, popping shadows, flat materials, invisible decals, transparency sorting artifacts, SDFGI light leaking, missing volumetric fog, and invisible MultiMesh instances.\n\n> See [references\u002Fcommon-pitfalls.md](references\u002Fcommon-pitfalls.md) for the full table.\n\n---\n\n## 11. Implementation Checklist\n\n- [ ] Scene has Camera3D, at least one light source, and WorldEnvironment\n- [ ] Environment has a sky material (procedural or HDR panorama) for ambient and reflected light\n- [ ] Tonemap mode is set (Filmic or ACES for realistic look, AgX (4.4+) for physically accurate)\n- [ ] DirectionalLight3D has shadows enabled with `shadow_normal_bias` tuned to prevent acne\n- [ ] `directional_shadow_max_distance` is set to the minimum needed (50–100m typical)\n- [ ] Static geometry uses StandardMaterial3D with appropriate PBR textures (albedo, normal, roughness, metallic)\n- [ ] Transparent materials use Alpha Scissor or Alpha Hash instead of Alpha where possible (performance + shadows)\n- [ ] ReflectionProbes are placed in rooms\u002Fareas with reflective surfaces\n- [ ] GI method chosen based on project needs (LightmapGI for static, SDFGI for large dynamic, VoxelGI for small dynamic)\n- [ ] Mesh LOD is enabled on import (default for glTF\u002FBlend — verify OBJ files)\n- [ ] Occlusion culling is enabled and baked for scenes with heavy occlusion (indoor, urban)\n- [ ] MultiMeshInstance3D is used for instanced geometry (grass, trees, props) instead of individual nodes\n- [ ] Renderer matches target platform (Forward+ desktop, Mobile mobile, Compatibility web)\n- [ ] Specular occlusion (on by default since Godot 4.5) is left enabled, or disabled deliberately via `rendering\u002Freflections\u002Fspecular_occlusion\u002Fenabled` where reflections look too dim\n- [ ] Hero assets with complex surface detail use bent normal maps in the StandardMaterial3D Bent Normal slot for improved indirect lighting (Godot 4.5+)\n- [ ] After upgrading to Godot 4.6, glow settings are re-tuned if appearance has changed (default blend mode is now Screen and glow is blended before tonemapping)\n- [ ] AgX `tonemap_agx_white` and `tonemap_agx_contrast` are adjusted when using AgX tonemapper for precise look control (Godot 4.6+)\n- [ ] After upgrading, volumetric fog (blending changed in 4.6; 4.7 adds `use_legacy_blending`) and sky reflections (`roughness_layers` differed in 4.6.0–4.6.1) are re-checked\n",{"name":5,"description":7},"master","60c28fdc40706a24576731e9fb3508b9c95258ad","skills\u002F3d-essentials",63,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter","https:\u002F\u002Fgithub.com\u002Fjame581","https:\u002F\u002Fjanmesarc.online\u002F","Software engineer. My biggest passion is game development.","2026-11-14 20:45:49",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add jame581\u002FGodotPrompter --skill 3d-essentials",{"tool":53,"command":54},"bunx","bunx skills add jame581\u002FGodotPrompter --skill 3d-essentials",{"tool":56,"command":57},"pnpm","pnpm dlx skills add jame581\u002FGodotPrompter --skill 3d-essentials","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002FSKILL.md",true,[61,67,71,75,79,83,87,91,95],{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fcommon-pitfalls.md","REFERENCE","参考文档",2266,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Fcommon-pitfalls.md",{"path":68,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fdecals.md",2594,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Fdecals.md",{"path":72,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Fenvironment-and-post.md",8051,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Fenvironment-and-post.md",{"path":76,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Ffog-recipes.md",3467,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Ffog-recipes.md",{"path":80,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fglobal-illumination.md",4283,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Fglobal-illumination.md",{"path":84,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fgodot-4.7-additions.md",1517,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Fgodot-4.7-additions.md",{"path":88,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":89,"sourceHtmlUrl":90},"references\u002Flod-and-culling.md",3404,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Flod-and-culling.md",{"path":92,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":93,"sourceHtmlUrl":94},"references\u002Fmaterials-and-lighting-recipes.md",10646,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Fmaterials-and-lighting-recipes.md",{"path":96,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":97,"sourceHtmlUrl":98},"references\u002Frenderer-comparison.md",752,"https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002F3d-essentials\u002Freferences\u002Frenderer-comparison.md",[100,118,139,169,192,210],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":33},"01M6KRFE5BR2PSD08ZKDAS66R7","xr-development","Use when building VR\u002FAR\u002FXR applications — OpenXR setup, XROrigin3D, hand tracking, controllers, passthrough, and Meta Quest deployment in Godot 4.3+","https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002Fxr-development\u002FSKILL.md",[],[107,108,32,109,29,110,111,112,28,113,114,23,115,116,117],"xr development","development","deployment","vr","setup","tracking","ar","hand","Meta","applications","quest",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":33},"01M6KRF8GZTG1TAS506MFBSGFC","web-services","Use when a Godot game calls a web server — HTTPRequest, downloads, REST\u002FJSON APIs, auth headers, WebSocketPeer clients, TLS, retries, and keeping secrets out of the build. Not for game networking\u002FRPCs (multiplayer-basics) or browser export (web-export)","https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002Fweb-services\u002FSKILL.md",[],[125,126,127,128,129,130,131,132,23,32,29,133,134,135,136,137,138],"web services","web","services","tls","retries","calling","auth","downloads","clients","headers","secrets","json","build","REST",{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":150,"publishedAt":33},"01M6KRF38Q4WSKAYFS56PG87T0","web-export","Use when shipping a Godot game to the browser — Web export preset options, threads vs no-threads and COOP\u002FCOEP headers, hosting on itch.io or your own server, PWA, JavaScriptBridge, user:\u002F\u002F persistence, audio and input limits, and load size","https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002Fweb-export\u002FSKILL.md",[145],{"categoryNo":146,"categoryName":147,"taxonomyType":148,"taxonomyTypeDesc":149},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",[126,151,152,153,154,155,156,157,134,158,159,32,160,161,162,163,164,165,23,166,167,168],"export","web export","threads","limits","shipping","size","options","hosting","input","Coop","preset","browser","game","io","load","pwa","Audio","server",{"skillNo":170,"name":171,"nameZh":6,"description":172,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":173,"categories":174,"keywords":183,"publishedAt":33},"01M6KREYFETEBH62ZTN6EZH2X3","using-godot-prompter","Bootstrap skill — establishes how to find and use GodotPrompter skills, with platform-specific tool mapping","https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002Fusing-godot-prompter\u002FSKILL.md",[175,178],{"categoryNo":176,"categoryName":177,"taxonomyType":148,"taxonomyTypeDesc":149},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":179,"categoryName":180,"taxonomyType":181,"taxonomyTypeDesc":182},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[29,184,185,26,186,23,187,188,189,190,191],"using godot prompter","find","bootstrap","tool","platform","mapping","how","how to",{"skillNo":193,"name":194,"nameZh":6,"description":195,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":196,"categories":197,"keywords":198,"publishedAt":33},"01M6KRER5G7EQWKGAFN8QJKQ69","tween-animation","Use when implementing tweens — property animation, method tweening, chaining, parallel sequences, easing, and common UI\u002Fgameplay motion recipes","https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002Ftween-animation\u002FSKILL.md",[],[199,200,23,201,202,203,204,205,206,207,208,32,209],"tween animation","Animation","motion","parallel","gameplay","chaining","ui","recipes","common","implementing","sequences",{"skillNo":211,"name":212,"nameZh":6,"description":213,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":214,"categories":215,"keywords":216,"publishedAt":33},"01M6KREKGCQMVDV8WX7HWX8BZG","state-machine","Use when building a state machine or refactoring logic into one — enum, node, and resource-based FSM patterns with trade-offs. Not for adding states to an existing one","https:\u002F\u002Fgithub.com\u002Fjame581\u002FGodotPrompter\u002Fblob\u002Fmaster\u002Fskills\u002Fstate-machine\u002FSKILL.md",[],[217,218,219,29,32,220,221,222,223,224,26,23,208,225],"state","state machine","machine","patterns","node","fsm","state machines","trade","trade-offs"]