Why persistence stores player progress in Unity - Visual Breakdown

Concept Flow - Why persistence stores player progress

Player plays game

↓

Game state changes

↓

Save progress triggered

↓

Write data to storage

↓

Data saved

↓

Player quits or reloads

↓

Load saved data

↓

Restore player progress

This flow shows how the game saves player progress by writing data to storage and later loads it to restore the player's state.

Execution Sample

Unity

void SaveProgress() {
  PlayerPrefs.SetInt("Level", currentLevel);
  PlayerPrefs.SetFloat("Health", playerHealth);
  PlayerPrefs.Save();
}

This code saves the player's current level and health to persistent storage.

Execution Table

Step	Action	Data Saved	Storage State	Result
1	Player reaches level 3	None	Empty	Progress not saved yet
2	Call SaveProgress()	Level=3, Health=75.5	Level=3, Health=75.5	Data written to storage
3	Player quits game	Level=3, Health=75.5	Level=3, Health=75.5	Data persists after quit
4	Player reloads game	None	Level=3, Health=75.5	Data loaded from storage
5	Restore player state	None	Level=3, Health=75.5	Player progress restored

💡 Execution stops after player progress is restored from saved data.

Variable Tracker

Variable	Start	After SaveProgress	After Quit	After Reload	Final
currentLevel	1	3	3	3	3
playerHealth	100.0	75.5	75.5	75.5	75.5
Storage (PlayerPrefs)	Empty	Level=3, Health=75.5	Level=3, Health=75.5	Level=3, Health=75.5	Level=3, Health=75.5

Key Moments - 3 Insights

Why does the game save data before quitting?

Because without saving, all progress would be lost when the game closes, as shown in step 3 of the execution_table.

What happens if the game tries to load progress but no data was saved?

The game will load default values or no progress, meaning the player starts fresh, unlike step 4 where saved data exists.

Why is PlayerPrefs.Save() important?

It ensures data is actually written to storage immediately, preventing loss if the game crashes or closes unexpectedly, as seen in step 2.

Visual Quiz - 3 Questions

Look at the execution_table, what data is saved at step 2?

A Level=1, Health=100.0

B No data saved yet

C Level=3, Health=75.5

D Level=5, Health=50.0

💡 Hint

Check the 'Data Saved' column at step 2 in the execution_table.

At which step does the player progress get restored?

A Step 3

B Step 5

C Step 1

D Step 2

💡 Hint

Look at the 'Result' column to find when progress is restored.

If PlayerPrefs.Save() was not called, what would likely happen?

A Data might not be saved before quitting

B Data would still be saved correctly

C Game would crash immediately

D Player progress would reset to level 10

💡 Hint

Refer to the explanation in key_moments about PlayerPrefs.Save() importance.

Concept Snapshot

Persistence stores player progress by saving game data to storage.
Use functions like PlayerPrefs.SetInt and PlayerPrefs.SetFloat to save values.
Call PlayerPrefs.Save() to write data immediately.
On game reload, load saved data to restore progress.
Without saving, progress is lost when quitting.

Full Transcript

This visual trace shows how persistence works to save and restore player progress in a game. The player plays and reaches a new level, then the game saves the current level and health to storage using PlayerPrefs. This data remains saved even after the player quits the game. When the player reloads the game, the saved data is loaded back, restoring the player's progress. Key moments include why saving before quitting is necessary, what happens if no data is saved, and the importance of calling PlayerPrefs.Save() to ensure data is written. The quiz questions help check understanding of these steps.

Practice

1. Why is persistence important in a Unity game for player progress?

easy

A. It changes the game graphics automatically.

B. It saves player progress so it is not lost between game sessions.

C. It makes the game run faster during play.

D. It prevents the player from quitting the game.

Solution

1. Step 1: Understand what persistence means in games

   Persistence means saving data so it stays even after the game is closed.

2. Step 2: Connect persistence to player progress

   Saving progress means players can continue where they left off next time.

3. Final Answer:

   It saves player progress so it is not lost between game sessions. -> Option B

4. Quick Check:

   Persistence = Save progress [OK]

Hint: Persistence means saving progress between sessions [OK]

Common Mistakes:

• Confusing persistence with game speed
• Thinking persistence changes graphics
• Believing persistence stops quitting

2. Which of the following is the correct way to save an integer score using PlayerPrefs in Unity?

easy

A. PlayerPrefs.Set("score", 100);

B. PlayerPrefs.SaveInt("score", 100);

C. PlayerPrefs.SetInt("score", 100);

D. PlayerPrefs.Save("score", 100);

Solution

1. Step 1: Recall PlayerPrefs method for saving integers

   The correct method is SetInt with key and value parameters.

2. Step 2: Check method names in options

   Only PlayerPrefs.SetInt("score", 100); matches the correct syntax.

3. Final Answer:

   PlayerPrefs.SetInt("score", 100); -> Option C

4. Quick Check:

   SetInt saves integer values [OK]

Hint: Use PlayerPrefs.SetInt for integers [OK]

Common Mistakes:

• Using incorrect method names like SaveInt
• Using Set instead of SetInt
• Confusing Save with Set

3. What will be the output of this Unity C# code snippet?

PlayerPrefs.SetInt("level", 3);
int currentLevel = PlayerPrefs.GetInt("level", 1);
Debug.Log(currentLevel);

medium

A. 3

B. Error

C. 0

D. 1

Solution

1. Step 1: Understand PlayerPrefs.SetInt and GetInt

   SetInt stores the value 3 with key "level". GetInt retrieves it, defaulting to 1 if not found.

2. Step 2: Since "level" was set, GetInt returns 3

   Therefore, Debug.Log prints 3.

3. Final Answer:

   3 -> Option A

4. Quick Check:

   Set then Get returns stored value [OK]

Hint: GetInt returns stored value if set, else default [OK]

Common Mistakes:

• Assuming default value is always returned
• Confusing SetInt with GetInt
• Expecting an error from PlayerPrefs

4. Identify the error in this Unity C# code that tries to save player health:

PlayerPrefs.SetFloat("health", 75);
// Missing PlayerPrefs.Save() call

medium

A. PlayerPrefs.SetFloat cannot save float values.

B. PlayerPrefs.SetFloat requires a string value, not a number.

C. The key "health" must be an integer.

D. PlayerPrefs.Save() must be called to ensure data is written.

Solution

1. Step 1: Check PlayerPrefs.SetFloat usage

   SetFloat correctly saves float values with a string key.

2. Step 2: Understand importance of PlayerPrefs.Save()

   Without Save(), data may not be written immediately and can be lost on crash.

3. Final Answer:

   PlayerPrefs.Save() must be called to ensure data is written. -> Option D

4. Quick Check:

   Always call Save() after setting PlayerPrefs [OK]

Hint: Call PlayerPrefs.Save() after setting values [OK]

Common Mistakes:

• Thinking SetFloat can't save floats
• Believing keys must be integers
• Confusing data types for PlayerPrefs

5. You want to save a player's name and highest score so progress is kept between sessions. Which approach correctly saves and retrieves this data in Unity?

hard

A. PlayerPrefs.SetString("playerName", "Alex"); PlayerPrefs.SetInt("highScore", 500); PlayerPrefs.Save(); string name = PlayerPrefs.GetString("playerName"); int score = PlayerPrefs.GetInt("highScore");

B. PlayerPrefs.SaveString("playerName", "Alex"); PlayerPrefs.SaveInt("highScore", 500); string name = PlayerPrefs.LoadString("playerName"); int score = PlayerPrefs.LoadInt("highScore");

C. PlayerPrefs.Set("playerName", "Alex"); PlayerPrefs.Set("highScore", 500); string name = PlayerPrefs.Get("playerName"); int score = PlayerPrefs.Get("highScore");

D. PlayerPrefs.SetString("playerName", "Alex"); PlayerPrefs.SetInt("highScore", 500); string name = PlayerPrefs.GetString("playerName"); int score = PlayerPrefs.GetInt("highScore");

Solution

1. Step 1: Identify correct PlayerPrefs methods for saving data

   Use SetString for strings and SetInt for integers, then call Save() to write data.

2. Step 2: Retrieve data with GetString and GetInt methods

   These methods get the saved values correctly.

3. Final Answer:

   PlayerPrefs.SetString("playerName", "Alex"); PlayerPrefs.SetInt("highScore", 500); PlayerPrefs.Save(); string name = PlayerPrefs.GetString("playerName"); int score = PlayerPrefs.GetInt("highScore"); -> Option A

4. Quick Check:

   Set + Save then Get methods for persistence [OK]

Hint: Set values, call Save(), then Get values to persist data [OK]

Common Mistakes:

• Using non-existent SaveString or LoadInt methods
• Forgetting to call PlayerPrefs.Save()
• Using generic Set or Get methods incorrectly