File-based save system in Unity - Mini Project: Build & Apply

File-based save system

📖 Scenario: You are making a simple game in Unity where the player can save their score to a file and load it later.

🎯 Goal: Build a file-based save system that writes the player's score to a file and reads it back.

📋 What You'll Learn

Create a variable to hold the player's score

Create a string variable for the file path

Write the score to a file using File.WriteAllText

Read the score from the file using File.ReadAllText

Print the loaded score to the console

💡 Why This Matters

🌍 Real World

Saving player progress or settings in games is common. This project shows how to save simple data to a file.

💼 Career

Understanding file input/output is important for game developers and software engineers to manage data persistence.

1

Create the player's score variable

Create an int variable called playerScore and set it to 100.

Unity

# Create an int variable called playerScore and set it to 100
# Your code here

Hint

Use int playerScore = 100; to create the variable.

2

Create the file path variable

Create a string variable called filePath and set it to "savefile.txt".

Unity

int playerScore = 100;
// Create a string variable called filePath and set it to "savefile.txt"
// Your code here

Hint

Use string filePath = "savefile.txt"; to create the file path.

3

Write the score to the file

Use System.IO.File.WriteAllText to write the playerScore as a string to the file at filePath.

Unity

int playerScore = 100;
string filePath = "savefile.txt";
// Write playerScore to the file at filePath
// Your code here

Hint

Use File.WriteAllText(filePath, playerScore.ToString()); to save the score.

4

Read and print the score from the file

Use System.IO.File.ReadAllText to read the score from filePath into a string variable called loadedScore. Then print loadedScore using Debug.Log.

Unity

using System.IO;

int playerScore = 100;
string filePath = "savefile.txt";
File.WriteAllText(filePath, playerScore.ToString());
// Read the score from the file into loadedScore
// Print loadedScore using Debug.Log
// Your code here

Hint

Use string loadedScore = File.ReadAllText(filePath); and Debug.Log(loadedScore);.

Practice

1. What is the main purpose of using a file-based save system in Unity games?

easy

A. To store game data on the device so progress is not lost

B. To improve game graphics performance

C. To increase the game's frame rate

D. To connect the game to online multiplayer servers

Solution

1. Step 1: Understand the role of saving data

   Saving data means keeping player progress or settings so they are not lost when the game closes.

2. Step 2: Identify file-based save system purpose

   A file-based save system stores this data on the device's storage, allowing the game to load it later.

3. Final Answer:

   To store game data on the device so progress is not lost -> Option A

4. Quick Check:

   Save system = store progress [OK]

Hint: Saving means keeping progress on device storage [OK]

Common Mistakes:

• Confusing saving with graphics or performance
• Thinking saving connects to online servers
• Assuming saving only affects frame rate

2. Which of the following is the correct way to write text data to a file in Unity using C#?

easy

A. File.WriteAllText(Application.persistentDataPath + "/savefile.txt", data);

B. File.ReadAllText(Application.persistentDataPath + "/savefile.txt", data);

C. File.WriteText(Application.dataPath + "/savefile.txt", data);

D. File.SaveText(Application.persistentDataPath + "/savefile.txt", data);

Solution

1. Step 1: Identify the correct method to write text

   The method to write text to a file is File.WriteAllText.

2. Step 2: Use the correct file path

   Application.persistentDataPath is the safe path for saving files on the device.

3. Final Answer:

   File.WriteAllText(Application.persistentDataPath + "/savefile.txt", data); -> Option A

4. Quick Check:

   WriteAllText + persistentDataPath = correct save [OK]

Hint: Use File.WriteAllText with persistentDataPath to save [OK]

Common Mistakes:

• Using File.ReadAllText to write data
• Using Application.dataPath which is not safe for saving
• Using non-existent methods like File.SaveText

3. What will be the output of the following code snippet if the file contains '{"score": 100}'?

string path = Application.persistentDataPath + "/savefile.json";
string json = File.ReadAllText(path);
PlayerData data = JsonUtility.FromJson<PlayerData>(json);
Debug.Log(data.score);

Assuming PlayerData is a class with a public int score field.

medium

A. null

B. 0

C. Error: File not found

D. 100

Solution

1. Step 1: Read JSON string from file

   The file contains '{"score": 100}', so json will hold this string.

2. Step 2: Deserialize JSON to PlayerData object

   JsonUtility.FromJson<PlayerData>(json) creates an object with score = 100.

3. Step 3: Output the score field

   Debug.Log(data.score) prints 100 to the console.

4. Final Answer:

   100 -> Option D

5. Quick Check:

   Deserialize JSON score = 100 [OK]

Hint: JsonUtility.FromJson reads JSON into object fields [OK]

Common Mistakes:

• Assuming score is zero if not initialized
• Confusing ReadAllText with WriteAllText
• Expecting null instead of a valid object

4. Identify the error in this code snippet for saving player data:

PlayerData data = new PlayerData();
data.score = 50;
string json = JsonUtility.ToJson(data);
File.WriteAllText("savefile.json", json);

medium

A. PlayerData.score must be private

B. Missing Application.persistentDataPath in file path

C. File.WriteAllText requires a byte array, not string

D. JsonUtility.ToJson cannot serialize PlayerData

Solution

1. Step 1: Check file path usage

   The code writes to "savefile.json" without specifying a full path, which may cause saving in an unsafe or unexpected location.

2. Step 2: Use Application.persistentDataPath for safe saving

   Unity recommends using Application.persistentDataPath + "/savefile.json" to save files safely on all platforms.

3. Final Answer:

   Missing Application.persistentDataPath in file path -> Option B

4. Quick Check:

   Always use persistentDataPath for file saving [OK]

Hint: Always include persistentDataPath in file paths [OK]

Common Mistakes:

• Saving files without full path causes errors
• Thinking JsonUtility cannot serialize simple classes
• Confusing WriteAllText input types

5. You want to save multiple player stats (score, level, health) in a file and load them later. Which approach correctly combines JSON serialization and file saving in Unity?

hard

A. Save each stat as a separate text file using File.WriteAllText without JSON

B. Serialize stats manually to a string and save using File.ReadAllText

C. Create a PlayerStats class with fields, serialize it with JsonUtility.ToJson, then save with File.WriteAllText using Application.persistentDataPath

D. Use JsonUtility.FromJson to save data and File.WriteAllText to load data

Solution

1. Step 1: Use a class to hold multiple stats

   A class like PlayerStats with fields score, level, health organizes data for easy serialization.

2. Step 2: Serialize and save correctly

   JsonUtility.ToJson converts the class to JSON string; File.WriteAllText with Application.persistentDataPath saves it safely.

3. Final Answer:

   Create a PlayerStats class with fields, serialize it with JsonUtility.ToJson, then save with File.WriteAllText using Application.persistentDataPath -> Option C

4. Quick Check:

   Class + JsonUtility + WriteAllText + persistentDataPath = correct [OK]

Hint: Use class + JsonUtility + persistentDataPath to save/load data [OK]

Common Mistakes:

• Saving stats separately without JSON causes complexity
• Mixing up ReadAllText and WriteAllText roles
• Using FromJson for saving instead of loading