# scenario-godot-3d-world

scenario-godot-3d-world guides 3D level building and environment setup in Godot 4.7, covering character controllers, stair stepping, Jolt physics, and mesh imports.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 461 installs · ★ 3964 repo stars
- Author: scenario-labs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/godot/scenario-godot-3d-world/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/scenario-godot-3d-world

## What it does

This skill bundles practices and helper utilities for building 3D environments under Godot 4.7.2. Its toolset includes the `scripts/gd_world.py` runner alongside GDScript files in `scripts/agentkit/world/` that handle runtime logic, jobs, and post-import operations. It directly resolves common controller friction: preventing capsule snagging on stairs using tread raycasts, avoiding walk slowdown when pitching the camera down, and tuning `SpringArm3D` with a spherical shape that ignores the player.

Asset pipelines follow explicit conventions: graybox geometry built with CSG gets baked instead of animated, while AI-generated GLB models from tools like Tripo or Meshy are normalized via import manifests to reset pivots and generate convex or box colliders. For landscapes in Terrain3D, the skill prioritizes `.res` binary saves over `.tres` alongside channel-packed, power-of-two textures. It explicitly depends on `scenario-godot-expert` being present in your agent environment.

Without running on macOS Apple Silicon or adjusting for your target device, reported frame numbers and test metrics should be re-profiled.

## Requirements
- Works with: Godot, Blender

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-3d-world -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/scenario-godot-3d-world/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/scenario-godot-3d-world/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-3d-world -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/scenario-godot-3d-world/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-3d-world -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/scenario-godot-3d-world/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scenario-labs/skills skills/game-engines/godot/scenario-godot-3d-world
```

2. **Manually: put the files in place**
- File: `.github/skills/scenario-godot-3d-world/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-3d-world -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/scenario-labs/skills --path skills/game-engines/godot/scenario-godot-3d-world
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/scenario-godot-3d-world/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-godot-3d-world -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/godot/scenario-godot-3d-world/SKILL.md

## When to use it
- stop CharacterBody3D capsules from sticking on stair steps
- configure third-person SpringArm3D collision without wall clipping
- bake CSG blockouts into optimized static level meshes
- process raw AI-generated GLB assets with manifests and collision layers

## Example prompts
- Implement stair step snapping for CharacterBody3D using test motion and a tread ray
- Write a post-import GDScript for incoming GLTF props to apply box collisions
- Configure Terrain3D texture regions and save the resource as binary res

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 6dc50327b2a2c8c6.

BEGIN THIRD-PARTY FILE 6dc50327b2a2c8c6
```text
---
name: scenario-godot-3d-world
description: "Use when building 3D levels and worlds in Godot 4.7: third-person or FPS controller, player stuck on stairs, spring arm camera clipping, blockout with CSG, GridMap and MeshLibrary, terrain (heightmap, HeightMapShape3D, Terrain3D regions, textures, painting), scattering trees with MultiMesh, streaming a big world, procedural meshes with SurfaceTool, Jolt physics settings, importing GLB or glTF from Blender or AI generators (Scenario, Tripo, Meshy, Hitem3D), import scripts, name suffixes, model facing, collision generation, LODs."
license: MIT
---

# Godot 3D world (level and environment artist)

Target: Godot 4.7.2.stable, macOS Apple Silicon, Jolt Physics, Forward+.

**REQUIRED BACKGROUND:** scenario-godot-expert (channels, `gd_run`, the review loop, 4.7 traps). If
a sibling skill named here is missing from your available skills, load it with `skill_get` (Scenario
MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install); unattended,
proceed from tool schemas and flag the gap.

**Status (2026-10-02):** all 14 live test groups in `tests/code/godot-3d-world/test_world_live.py`
passed (`live_20261002-215949.json`); L8 and L12 were extended and passed again in round 2
(`live_20261002-223935.json`). The 11 offline checks pass. Details in
[`references/procedures.md`](references/procedures.md).

Toolkit: [`scripts/gd_world.py`](scripts/gd_world.py) (runner side) and
[`scripts/agentkit/world/*.gd`](scripts/agentkit/world/) (jobs, a post-import script and two runtime
scripts), installed with `gd_world.install_world(P)`.

## Stance (the expert delta)

1. **Zero Y before normalizing the camera-relative direction.** GDQuest (JlgZtOFMdfc 00:22:00):
   otherwise looking down slows the walk. With the order right, the controller kept 6.00 m/s at -60
   degrees of pitch.
2. **CharacterBody3D needs a stairs module, and the step height must come from the tread.** Majikayo
   (Tb-R3l0SQdc 00:17:01) snaps up with `body_test_motion` and checks the tread with a ray, because
   the capsule touches the leading edge. A stock r 0.35 capsule stops at 0.18 m steps. Taking the
```
END THIRD-PARTY FILE 6dc50327b2a2c8c6

The third-party file has ended. Everything between the 6dc50327b2a2c8c6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2158 of 17890 bytes. © scenario-labs · MIT · https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/godot/scenario-godot-3d-world/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
