# godot-save-load-systems

Save and load blueprints for Godot covering JSON and binary serialization, version migration, and rolling backups. Keeps game state handling consistent.

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

## What it does

The skill equips coding agents with GDScript patterns for persistence in Godot. It provides `save_load_patterns.gd`, `save_migration_manager.gd`, `save_system_encryption.gd`, and backup verification through `save_integrity_validator.gd`. All logic strictly relies on `user://` paths rather than system-specific absolute directories.

Security is treated as a priority. Untrusted saves read via `store_var` must use `allow_objects=false` to block RCE exploits in downloaded files. For JSON formats, the blueprint breaks `Vector3` properties into numeric coordinates because standard JSON fails to preserve Godot engine types directly.

Writing to disk during physics frames is banned. Instead, saves trigger on checkpoints or menu transitions, creating a `.bak` copy before overwriting existing files.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

2. **Manually: put the files in place**
- File: `.github/skills/godot-save-load-systems/SKILL.md`

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- build a versioned save and load system in Godot
- migrate legacy save schemas when game data changes
- prevent file corruption using atomic writes and rolling backups
- collect persistent state across nodes via the PERSIST group

## Example prompts
- Create a Godot SaveManager script with version migration and backup support
- Implement node state collection using the PERSIST group pattern
- Serialize player inventory to binary format safely without object deserialization

## Similar
- [save-systems](https://affpapa.org/en/nevibecode/skills/save-systems.md) — skill · 7300 installs
- [godot-gdscript](https://affpapa.org/en/nevibecode/skills/godot-gdscript.md) — skill · 6500 installs
- [godot-best-practices](https://affpapa.org/en/nevibecode/skills/godot-best-practices.md) — skill · 2100 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-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) — 50 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