# godot-procedural-generation

This skill helps plan procedural levels, terrain, and object placement in Godot. Use it when generated worlds need to be repeatable from a seed.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 492 installs · ★ 893
- Author: thedivergentai
- License: LGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-procedural-generation/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/godot-procedural-generation

## What it does

The skill maps common generation tasks to algorithms: BSP for rooms and corridors, Drunkard’s Walk for paths, FastNoiseLite for heightmaps and biomes, and Wave Function Collapse for tile layouts. It points to Poisson Disk Sampling for distributing objects without clumping, plus Marching Cubes and LOD chunks for 3D terrain.

GDScript files cover individual algorithms, with two required starting scripts for seed handling and background chunk generation. Compute data on a worker thread, then move SceneTree operations to the main thread; rebake NavigationRegion after geometry is added. Saving the seed and player changes lets a world be restored. Creating nodes from a worker thread conflicts with the stated SceneTree restriction.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-procedural-generation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-procedural-generation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-procedural-generation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-procedural-generation
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-procedural-generation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-procedural-generation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-procedural-generation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-procedural-generation -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/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-procedural-generation/SKILL.md

## When to use it
- divide a level into rooms and connect them with corridors
- generate caves with a cellular automaton
- create a heightmap with FastNoiseLite
- place props without clustering
- build chunked procedural 3D terrain

## Example prompts
- Plan a Godot room-and-corridor generator using BSP and a repeatable seed.
- Move chunk data generation to a worker thread and keep node creation on the main thread.
- Choose an algorithm for spreading trees without clumping and show me its script.

## Similar
- [orbit-card](https://affpapa.org/en/nevibecode/skills/orbit-card.md) — skill · 10000 installs
- [cad](https://affpapa.org/en/nevibecode/skills/cad.md) — skill · 14000 installs
- [step-parts](https://affpapa.org/en/nevibecode/skills/step-parts.md) — skill · 11200 installs
- [sdf](https://affpapa.org/en/nevibecode/skills/sdf.md) — skill · 10500 installs
- [urdf](https://affpapa.org/en/nevibecode/skills/urdf.md) — skill · 10500 installs
- [hatch-pet](https://affpapa.org/en/nevibecode/skills/hatch-pet.md) — skill · 3300 installs

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 61 cards

---
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