# godot-genre-roguelike

Architectural guidelines and modular scripts for building roguelikes in Godot. Sets up procedural generation, seeded RNG, and meta-progression.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 429 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-genre-roguelike/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/godot-genre-roguelike

## What it does

The skill provides architectural rules and modular GDScript components tailored for Godot. It stops the agent from relying on unseeded global RNG. Heavy dungeon algorithms run outside the main thread via `WorkerThreadPool`, keeping the viewport responsive.

Included blueprints cover Drunkard's Walk carving in `dungeon_generator_walker.gd`, Jump Point Search with `AStarGrid2D`, and GPU shader masks for fog of war. Run logic and meta unlocks remain separated. While `run_manager.gd` supervises the active dungeon, `meta_progression_manager.gd` stores persistent upgrades in JSON under `user://`.

Saving active run states directly to `.tscn` files is prohibited because it bloats data. You must serialize procedural grid entities into JSON or binary files instead.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-genre-roguelike/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-genre-roguelike
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- offload procedural level generation to `WorkerThreadPool`
- isolate per-run temporary state from persistent meta-progression
- set up 2D grid pathfinding using `AStarGrid2D` and Jump Point Search
- prevent save scumming by wiping mid-run saves immediately upon loading

## Example prompts
- Implement a Drunkard's Walk procedural generator using WorkerThreadPool
- Set up meta-progression saving that separates run state from persistent unlocks
- Configure AStarGrid2D pathfinding with Chebyshev heuristic for an 8-way grid

## Similar
- [roguelike](https://affpapa.org/en/nevibecode/skills/roguelike.md) — skill · 6200 installs
- [godot-ui-control](https://affpapa.org/en/nevibecode/skills/godot-ui-control.md) — skill · 6700 installs
- [cli-anything-godot](https://affpapa.org/en/nevibecode/skills/cli-anything-godot.md) — skill · 548 installs
- [godot-prompter](https://affpapa.org/en/nevibecode/plugins/godot-prompter.md) — plugin · ★ 867
- [godot](https://affpapa.org/en/nevibecode/rules/godot.md) — rule · ★ 3579
- [godot-mcp-enhanced](https://affpapa.org/en/nevibecode/mcp/godot-mcp-enhanced.md) — MCP server · ★ 103

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 51 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