# godot-turn-system

Supplies agents with GDScript blueprints for turn-based combat in Godot. Essential when structuring initiative queues and action points.

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

## What it does

The skill equips the agent with strict GDScript rules for turn-based mechanics in Godot. It separates combat architecture into discrete phased rounds, continuous ATB gauges, or timeline managers. Board state lives in a Dictionary rather than the node tree. Grid navigation relies on `AStarGrid2D` instead of `AStar2D`.

Action points require validation through `can_perform_action()` before spending. In multiplayer games, the server owns the turn clock and triggers automatic passes on timeout. Queue recalculation on every action is disallowed to prevent performance dips. Modifying tile solidity without invoking `update()` on `AStarGrid2D` immediately breaks path queries.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- build a phased turn queue with action point validation
- implement an active time battle gauge or timeline interrupt system
- handle authoritative server-side turn timeouts for multiplayer matches
- configure grid pathfinding using AStarGrid2D and obstacle updates

## Example prompts
- Implement a round-based combat manager in Godot using action points and deterministic tie-breaking.
- Create an ATB gauge loop in GDScript that pauses execution when an actor is ready.
- Set up a server-authoritative turn timeout handler using the TurnManager singleton contract.

## Similar
- [godot-gdscript](https://affpapa.org/en/nevibecode/skills/godot-gdscript.md) — skill · 6500 installs
- [godot-physics](https://affpapa.org/en/nevibecode/skills/godot-physics.md) — skill · 6300 installs
- [godot-mcp-enhanced](https://affpapa.org/en/nevibecode/mcp/godot-mcp-enhanced.md) — MCP server · ★ 103
- [godot](https://affpapa.org/en/nevibecode/rules/godot.md) — rule · ★ 3579
- [godot-ui](https://affpapa.org/en/nevibecode/skills/godot-ui.md) — skill · 2700 installs
- [godot-asset-generator](https://affpapa.org/en/nevibecode/skills/godot-asset-generator.md) — skill · 1000 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