# godot-game-loop-waves

godot-game-loop-waves is a Claude Code skill for configuring enemy spawning, difficulty balance, and combat waves in Godot 4 through data resources.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 349 installs · ★ 983 repo stars
- 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-game-loop-waves/SKILL.md
- Updated: 2026-10-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/godot-game-loop-waves

## What it does

The skill equips coding agents with battle loop architectures for arena titles, tower defense, and top-down action in Godot 4. It treats each encounter as a data-driven sequence. Designers tune balance inside `WaveResource` objects while `WaveManager` controls interval timers, cleanup groups, and clear signals. Spatial positions rely on editor markers such as `wave_spawner.gd` or weighted pickers.

Architectural guidance adjusts to unit density. Up to eighty active actors remain standard nodes in the scene tree using deferred child additions and memory pooling. For heavier crowds, the skill shifts mechanics toward `MultiMeshInstance3D` or server-side RID objects inside `PhysicsServer3D` and `NavigationServer3D`. Calling node additions synchronously during physics calculations causes state corruption, making deferred calls non-negotiable.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-game-loop-waves
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-game-loop-waves/SKILL.md`

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- structure wave timelines with custom `WaveResource` assets
- implement weighted random enemy spawners on marker nodes
- batch visual swarms via `MultiMeshInstance3D` without dropping frames
- offload navigation path checks from the main thread

## Example prompts
- Set up a sequential wave controller in Godot 4 using WaveResource assets.
- Configure a weighted enemy spawner on a Marker3D node.
- Replace get_children polling with group signals to track wave clears.

## Similar
- [godot-tilemap](https://affpapa.org/en/nevibecode/skills/godot-tilemap.md) — skill · 11900 installs
- [godot-mcp](https://affpapa.org/en/nevibecode/mcp/sandraschi-godot-mcp.md) — MCP server · ★ 6 repo stars
- [game-godot-specialist](https://affpapa.org/en/nevibecode/skills/game-godot-specialist.md) — skill · ★ 57 repo stars
- [godot-resources](https://affpapa.org/en/nevibecode/skills/godot-resources.md) — skill · 12400 installs
- [godot-optimization](https://affpapa.org/en/nevibecode/skills/godot-optimization.md) — skill · 733 installs
- [scenario-godot-3d-world](https://affpapa.org/en/nevibecode/skills/scenario-godot-3d-world.md) — skill · 461 installs

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