🗺️ PlayerSave

PlayerSave – Persistent Save System

The PlayerSave class is a static high-level API for saving and retrieving all persistent data in the game, such as nickname, level, items, coins, stats, color, selected clothes, and more.

It automatically handles encryption, serialization (for complex types), and saving behind the scenes through the configured ILocalSaveProvider. No need to manually call PlayerPrefs.Save().

---

💾 What It Does

• Stores and retrieves player data using SetString, SetInt, SetFloat (encrypted under the hood)

• Automatically saves after every change

• Supports:

  • 🧍 Nickname, pet ID, level, EXP

  • 📦 Item quantities (dictionary-based)

  • 🎮 High Scores

  • 🛒 Selected clothes and food

  • 🧼 Stat values (like hygiene, hunger)

  • 💰 Multiple coin types (by ID)

  • 🎨 Pet color customization

  • ⏱ Offline stat decay timestamp

• Raises events like OnCurrencyChanged, OnStatsChanged, OnExpChanged

---

🧠 How It Works

• Uses an ILocalSaveProvider (default: PlayerPrefsSaveProvider)

• Each call to SetInt, SetString, etc.:

  • Encrypts and stores the value

  • Automatically triggers provider.Save()

• Uses JSON serialization for complex data (e.g., inventory)

• Data is saved securely in PlayerPrefs, but can be swapped to a cloud or custom provider

---

🔧 Built-In Keys

Category	Key Format	Example
Nickname	PLAYER_NICK	"FluffyCat"
Pet ID	PLAYER_PET	0, 1, 2...
Level / Exp	PLAYER_LVL, PLAYER_EXP	5, 1500
Stat	STAT_{statName}	STAT_Hygiene
Coins	COIN_{coinId}	COIN_Gold
Scores	SCORE_{mode}	SCORE_FlappyPet
Items	ITEMS_JSON	JSON-encoded inventory
Food	SELECTED_FOOD	"apple_01"
Clothes	SELECTED_CLOTHES_{slot}	"hat_02"
Pet Color	PET_COLOR	#FFCC99FF
Last Update	PET_LAST_STAT_UPDATE	UTC Ticks (as string)

---

📥 Saving Data

You don’t need to call PlayerPrefs.Save() — just use the functions below:

PlayerSave.SetString("customKey", "someValue");
PlayerSave.SetInt("someNumber", 5);
PlayerSave.SetFloat("someFloat", 0.75f);

This will encrypt, store, and save automatically.

---

📤 Reading Data

You can retrieve saved values using the matching Get functions:

string name = PlayerSave.GetString("PLAYER_NICK");
int hygiene = PlayerSave.GetStat("Hygiene");
int coins = PlayerSave.GetCoin("Gold");

---

📦 Item System (Dictionary-based)

Items are stored in a JSON dictionary behind the scenes:

// Add items
PlayerSave.AddItems(new Dictionary<string, int> {
  { "food_apple", 3 },
  { "hat_red", 1 }
});

// Check quantity
int hats = PlayerSave.GetItemCount("hat_red");

// Remove items
PlayerSave.RemoveItems(new Dictionary<string, int> {
  { "food_apple", 1 }
});

---

🎮 Scores, Stats & Coins

PlayerSave.SetBestScore("FlappyPet", 1500);
int score = PlayerSave.GetBestScore("FlappyPet");

PlayerSave.SetStat("Hygiene", 20, 100);
int hygiene = PlayerSave.GetStat("Hygiene");

PlayerSave.AddCoin("Gold", 10);
PlayerSave.RemoveCoin("Gold", 5);
int gold = PlayerSave.GetCoin("Gold");

---

🎨 Clothes, Food & Color

PlayerSave.SetSelectedClothes("head", "hat_red");
PlayerSave.SetSelectedFood("food_apple");

Color petColor = PlayerSave.GetPetColor();
PlayerSave.SetPetColor(Color.cyan);

---

⏱ Offline Stat Decay

PlayerSave.SaveLastTimestamp(DateTime.UtcNow);
string lastUpdate = PlayerSave.GetLastTimestamp();

Used to calculate how much time has passed offline for stat decay (hunger, hygiene, etc.)

---

🧪 Switching Save Backend

If needed, you can replace the save provider with your own implementation:

PlayerSave.SetProvider(new MyCustomSaveProvider());

Your class must implement ILocalSaveProvider.

---

✅ Highlights

• 🔐 Encrypted & auto-saving system

• 🔧 Uses standard APIs: SetString, GetInt, etc.

• 🧱 Structured: supports stats, coins, scores, food, clothes

• 🔄 Ready for cloud migration (via provider interface)