Saving Game Progress to Local Disk Storage

In this lesson, you will learn how to bridge the gap between volatile in-memory game data and permanent local disk storage by writing serialized data streams directly to the device's persistent file path.

Why Persistent Data Paths?

While JsonUtility is excellent for structuring data, your game needs a "home" on the user's hard drive that is guaranteed to remain unchanged across application updates and restarts. In Unity, this location is accessed via Application.persistentDataPath. This property provides a platform-specific directory where your game has read/write permissions, preventing issues with OS-level security restrictions that occur if you try to write to the project folder directly.

Implementing the Write Stream

To save progress, we combine serialization with System.IO file streams. The goal is to convert your data object (already serialized as a JSON string) into a byte stream that is flushed directly to the disk.

using System.IO;
using UnityEngine;

public class SaveSystem : MonoBehaviour
{
    public void SaveGameData(string jsonData)
    {
        // Define the path using the persistent data folder
        string filePath = Path.Combine(Application.persistentDataPath, "savefile.json");

        // Write the serialized string to the file
        File.WriteAllText(filePath, jsonData);
        
        Debug.Log($"Data saved successfully to: {filePath}");
    }
}

Ensuring Data Integrity

When writing to disk, always be mindful of file handles. While File.WriteAllText is convenient for smaller saves, it creates a clean overwrite of the target file. If your save files grow significantly in size, or if you are saving frequently, consider the overhead this causes to the disk I/O. In those instances, you would use FileStream with a StreamWriter to manage the buffer manually, though for most progress-tracking scenarios, the method above is sufficient.

Note that persistentDataPath is also cross-platform; Unity automatically maps it to the correct user-specific folders on Windows, macOS, Android, and iOS, ensuring your code remains portable without needing platform-specific #if directives.

Key Takeaway: Use Application.persistentDataPath to ensure your serialized JSON data survives application restarts by writing directly to a reliable, cross-platform storage location.