# godot-game-loop-collection

The godot-game-loop-collection skill structures Godot collectible systems with pickup logic, hunt progress, a nearest-item compass, and saved IDs. Use it for scavenger hunts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 345 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-collection/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-collection

## What it does

The skill defines a Godot collection loop around stable `item_id` values and a `collection_id` for each hunt. `collectible_item.gd` handles one-shot Area pickups, `collection_manager.gd` owns the collected-ID set, and `collection_compass.gd` searches the remaining IDs to guide the player.

Progress can be serialized with `get_collected_ids()` and restored with `restore_collected_ids()`. Fixed marker-based hunts can use `Marker3D` points with `hidden_item_spawner.gd`; `collection_loop_patterns.gd` covers advanced loop cases. Missing or duplicated IDs break saves and completion percentage.

The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. The core scripts cover fixed-ID hunts, while the spawner and advanced patterns are optional pieces.

## 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-collection -a claude-code
```

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

### Codex

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

2. **Manually: put the files in place**
- File: `.agents/skills/godot-game-loop-collection/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-collection -a cursor
```

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-game-loop-collection/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-collection -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-collection/SKILL.md

## When to use it
- collect items through Area pickups
- keep hunt progress after a level reload
- point a compass at the nearest remaining item
- calculate collection completion
- spawn hidden items from Marker3D points

## Example prompts
- Build a Godot scavenger hunt with `collectible_item.gd` and `collection_manager.gd`.
- Persist collected IDs with `get_collected_ids()` and restore them with `restore_collected_ids()`.
- Add a compass that targets an item returned by `get_remaining_ids()`.

## Similar
- [scenario-godot-architecture](https://affpapa.org/en/nevibecode/skills/scenario-godot-architecture.md) — skill · 452 installs
- [game-godot-specialist](https://affpapa.org/en/nevibecode/skills/game-godot-specialist.md) — skill · ★ 57 repo stars
- [AI Game Developer: MCP for Unity, Unreal and Godot](https://affpapa.org/en/nevibecode/mcp/ai-game-developer-mcp-for-unity-unreal-and-godot.md) — MCP server · ★ 4680 repo stars
- [godot-ui-control](https://affpapa.org/en/nevibecode/skills/godot-ui-control.md) — skill · 13100 installs
- [godot-animation](https://affpapa.org/en/nevibecode/skills/godot-animation.md) — skill · 12900 installs
- [godot-ui](https://affpapa.org/en/nevibecode/skills/godot-ui.md) — skill · 2700 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
