One-click install
npx skills add https://github.com/BasarEkinci/memory-card-game --skill save-system-basarekinci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: save-system
Source: https://github.com/BasarEkinci/memory-card-game/tree/main/.claude/skills/gameplay/save-system
Command: npx skills add https://github.com/BasarEkinci/memory-card-game --skill save-system-basarekinci

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Newtonsoft.Json.

What problem does it solve?

This Skill prevents losing player progress by providing a clear, consistent pattern for saving and restoring game state to disk, including scene transitions.

Core Features & Use Cases

  • ISaveable-based component persistence: Implement a stable key plus capture/restore logic for each stateful component.
  • Central SaveManager orchestration: Discover saveables, aggregate per-component data, write/load save files, and invoke completion hooks.
  • JSON save file management with versioning: Save structured state using a dictionary wrapper, support save slots, and migrate older versions safely.
  • Scene persistence model: Persist global objects across loads and serialize per-scene progress separately using scene-aware keys.

Quick Start

Use the save-system skill to implement ISaveable on your stateful MonoBehaviours and wire SaveManager to capture and restore their JSON state across save/load and scene changes.

Frequently Asked Questions about save-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save and restore game state across scene transitions in Unity?

To save game state across Unity scene transitions, implement an ISaveable contract on stateful MonoBehaviours and use a central SaveManager to aggregate and serialize component data to disk. This preserves player progress reliably between scene loads.

What is the best way to handle save file versioning and migration in Unity?

Save file versioning in Unity is handled by storing version metadata within a JSON dictionary wrapper. This allows the save system to identify older save formats and safely migrate them to current data structures during the restore process.

Does this Unity save system support multiple save slots and autosaves?

Yes, the Unity save system supports multiple save slots and autosaves by managing structured JSON save files. The central SaveManager orchestrates reading and writing these individual slots to persist distinct player progress.

How do I serialize complex game state data in Unity using JSON?

To serialize complex game state in Unity, the save system uses Newtonsoft.Json for the dictionary wrapper and JsonUtility for per-component structs. This combination captures and restores state entries aggregated from ISaveable MonoBehaviours.

Do I need Newtonsoft.Json to implement game state persistence in Unity?

Yes, Newtonsoft.Json is required as a dependency to serialize the dictionary wrapper for game state persistence. JsonUtility handles individual component structs, while Newtonsoft manages the overarching aggregated save data structure.

Can I persist global Unity objects separately from scene-specific progress?

Yes, you can persist global Unity objects separately from scene-specific progress using scene-aware keys. The save system serializes per-scene progress independently while maintaining global state across scene loads.