Skip to content
SkillModel-led1,979 tokens in use

godot-3d-essentials

Sets up Godot 4.7 3D scenes with a current camera, real lights, WorldEnvironment, materials and GridMap, and checks them with a headless scene test.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/godot/godot-3d-essentials
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing godot-3d-essentials costs

115tokens idle
1,979tokens in use
3,352tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples12/15
  • Output10/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    assets/check_3d_scene.gd

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill helps an agent assemble a 3D scene in Godot 4.7 that shows what it should in the running game. It covers the renderer choice, one current Camera3D per viewport, lights and a WorldEnvironment placed in the scene itself, Environment settings, StandardMaterial3D and GridMap blockouts.

A bundled headless check loads a scene and fails when there is no current camera, nothing lights the meshes, a sky background has no sky, or a mesh is hidden by the camera culling mask. The gotchas section explains black meshes, grey screens, wrong cameras and look_at() errors.

What You Get

  • A workflow from renderer check through camera, lighting, Environment and materials to GridMap blockouts
  • GDScript patterns for a sun and sky environment, a material from code and filling a GridMap
  • A headless scene check that exits non-zero on a missing camera, unlit meshes or hidden meshes
  • A command for rendering one software frame with Movie Maker so the agent can inspect a screenshot

Common Use Cases

  • Fixing a 3D scene that renders black or washed out in the running game
  • Tracking down a mesh that is invisible because of culling, distance or flipped normals
  • Blocking out a level quickly with a GridMap and MeshLibrary
  • Correcting a child node that rotates on the wrong axis because of local versus global transforms

What Makes It Unique

The skill separates what the editor preview shows from what the running game shows, which is the usual cause of dark scenes. It pairs that with a no-GPU headless check and a software Movie Maker render, so the agent can test a scene and look at a frame without a display. It hands spatial shaders, physics and camera feel to named sibling skills.

Under The Hood

The agent loads the SKILL.md and, when needed, a reference covering transforms, light types, Environment options and GI. It runs commands in your project: the Godot binary headless with the bundled GDScript check, an optional Python project checker from the godot-nodes-scenes skill, and, for a screenshot, xvfb-run with Godot’s movie writer, which writes image files into a shots folder. It makes no network calls. The shipped GDScript check is a file type the scanner cannot read, so what it does was not analysed and is worth a look before you run it.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers