SkillAgentSearch skills...

godot-3d-essentials

Godot 4.7 3D scene setup: Camera3D, lights, WorldEnvironment (sky, ambient, tonemap, fog), StandardMaterial3D, GridMap and local vs global transforms, with a headless scene check

Install / Use

npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill godot-3d-essentials

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

92/100

Category

Other

Supported Platforms

Universal

Tags

Our assessment of godot-3d-essentials

godot-3d-essentials scores 92/100 on our quality scale, 57th of 330 Other skills we index (top 18%).

Its SKILL.md is 5.5 KB long, well organised into 11 sections with 4 code examples: a solid amount of guidance for an agent.

With 8,904 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
17/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 4 days ago, so godot-3d-essentials is actively maintained.
  • Our last check on 2026-10-31 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

godot-3d-essentials compared with similar skills

All 4 of these similar skills score higher than godot-3d-essentials; compare them before choosing.

SkillScoreStarsUpdatedFormat
godot-3d-essentials (this skill)by gamedev-skills928.9k4d agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install godot-3d-essentials?
Run npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill godot-3d-essentials. The install tabs above show the steps for each supported agent.
Which AI agents does godot-3d-essentials work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is godot-3d-essentials safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is godot-3d-essentials still maintained?
The repository was last updated 4 days ago, so godot-3d-essentials is actively maintained.

name: godot-3d-essentials description: > Set up a Godot 4.7 3D scene: Node3D transforms, Camera3D, lighting (DirectionalLight3D/OmniLight3D), WorldEnvironment for sky/ambient/tonemap/post, MeshInstance3D materials, and GridMap for tile-based 3D levels. Use when building a 3D scene in a Godot project, placing cameras/lights, configuring environment and post-processing, or working with Node3D/.tscn 3D content and GridMap.

Godot 3D Essentials (4.x)

Assemble a working 3D scene: transforms, camera, lights, environment/post, materials, and GridMap blockouts. Targets Godot 4.7.

When to use

  • Use when starting or fixing a 3D scene: positioning a Camera3D, adding lights, setting up a WorldEnvironment (sky, ambient, tonemap, glow/SSAO), assigning materials, or building levels with GridMap.

When not to use: writing spatial shaders → godot-shaders; 3D physics bodies and raycasts → godot-physics; character animation blending → godot-animation; full FPS template → the fps-shooter genre skill.

Core workflow

  1. Everything 3D is a Node3D with a Transform3D (position, rotation basis, scale). Move with global_position, rotate with rotate_y(angle) or look_at(target).
  2. Add a Camera3D. Mark it current (or call make_current()); set fov, near, far. Parent it to a rig/pivot for orbit or follow cameras.
  3. Light the scene. A DirectionalLight3D is the sun; OmniLight3D/SpotLight3D are local. Enable shadows per light. Without lights and ambient, surfaces render black.
  4. Add a WorldEnvironment with an Environment resource: background (sky/color), ambient light, tonemap, and post (glow, SSAO, fog, adjustments).
  5. Give meshes materials (StandardMaterial3D or a ShaderMaterial) on MeshInstance3D.
  6. Block out levels with GridMap, which places MeshLibrary items on a 3D grid (the 3D analog of a tilemap).

Patterns

1. A follow camera (third-person, smoothed)

extends Camera3D

@export var target: Node3D
@export var offset := Vector3(0, 4, 8)
@export var smooth := 6.0

func _physics_process(delta: float) -> void:
    if target == null:
        return
    var desired := target.global_position + offset
    global_position = global_position.lerp(desired, smooth * delta)  # smooth follow
    look_at(target.global_position, Vector3.UP)                      # face the target

2. Sun + environment in code

func _ready() -> void:
    var sun := DirectionalLight3D.new()
    sun.rotation_degrees = Vector3(-45, -30, 0)
    sun.shadow_enabled = true
    add_child(sun)

    var we := WorldEnvironment.new()
    var env := Environment.new()
    env.background_mode = Environment.BG_SKY
    env.sky = Sky.new()
    env.sky.sky_material = ProceduralSkyMaterial.new()
    env.ambient_light_source = Environment.AMBIENT_SOURCE_SKY
    env.tonemap_mode = Environment.TONE_MAPPER_FILMIC
    env.glow_enabled = true
    we.environment = env
    add_child(we)

3. Assign a StandardMaterial3D from code

func tint_mesh(mesh: MeshInstance3D, color: Color) -> void:
    var mat := StandardMaterial3D.new()
    mat.albedo_color = color
    mat.metallic = 0.0
    mat.roughness = 0.6
    mat.emission_enabled = true
    mat.emission = color * 0.3
    mesh.material_override = mat       # overrides the mesh's surface materials

4. Place tiles into a GridMap

@onready var grid: GridMap = $GridMap   # cell_size + mesh_library set in the editor

func build_floor(width: int, depth: int, item_id: int) -> void:
    for x in width:
        for z in depth:
            # set_cell_item(Vector3i cell, int item, orientation = 0)
            grid.set_cell_item(Vector3i(x, 0, z), item_id)

Pitfalls

  • Scene renders black → no lights and no ambient. Add a DirectionalLight3D and/or a WorldEnvironment with ambient/sky. New scenes have neither by default.
  • No camera / wrong camera. If nothing shows, no Camera3D is current. Set current = true or make_current(); only one camera renders per viewport.
  • Confusing local vs global transforms. position/rotation are relative to the parent; global_position/global_transform are world space. Mixing them under a rotated parent gives surprising results. look_at uses global coordinates.
  • Scaling physics/lights. Non-uniform scale on a Node3D distorts child collisions and lights; prefer scaling the mesh asset or using uniform scale.
  • Forgetting from/up in look_at. look_at(target, up) — a target equal to the node's position, or an up parallel to the look direction, produces NaNs/flips.
  • GridMap with no MeshLibrary places nothing. Create a MeshLibrary (from scenes) and assign it; set_cell_item(cell, -1) clears a cell.
  • HDR/glow too strong → check tonemap_mode and glow thresholds; raw emissive values bloom hard under filmic tonemapping.

References

  • For Transform3D math, camera projection modes, light/shadow params, the full Environment/post-processing options, MeshLibrary creation, and ReflectionProbe/ LightmapGI lighting, read references/scene-and-environment.md.

Related skills

  • godot-physics — 3D bodies, areas, and raycasts.
  • godot-shaders — spatial shaders for custom 3D surfaces.
  • godot-animation — AnimationTree for 3D characters.
  • camera-systems — third-person orbit / first-person look rigs, framing, and collision.
  • performance-optimization — keep 3D scenes within frame budget (draw calls, lights, LOD).
  • fps-shooter — composes 3D movement, input, and AI into a game.

Related Skills

View on GitHub
GitHub Stars8.9k
CategoryOther
Updated4d ago
Forks905

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions