Разработка системы сохранения прогресса мобильной игры

Разработка системы сохранения прогресса мобильной игры

Потеря прогресса — худшее, что может случиться с игроком. Прошёл 30 уровней, купил бустеры, разблокировал персонажей — и после переустановки или смены устройства ничего нет. Рейтинг в магазине падает, пользователь уходит. Система сохранений — критический компонент, который нельзя добавить «потом».

Что и где хранить

Прогресс игры состоит из нескольких типов данных с разными требованиями:

Критические данные (уровень, валюта, покупки) — должны синхронизироваться с сервером и не теряться никогда. Хранятся локально + облако.

Игровой прогресс (пройденные уровни, достижения, разблокированные предметы) — локально + опциональная синхронизация.

Пользовательские настройки (громкость, управление, графика) — только локально, потеря некритична.

Сессионные данные (текущий уровень, позиция, временные буффы) — только в памяти, не нужно персистировать между сессиями.

Локальное хранение

Для простых игр — JSON-файл или SharedPreferences/UserDefaults. Для сложного прогресса с множеством сущностей — SQLite через Room.

@Entity(tableName = "save_data")
data class SaveDataEntity(
    @PrimaryKey val playerId: String,
    val level: Int,
    val experience: Long,
    val coins: Long,
    val gems: Int,
    val unlockedLevels: String,  // JSON array
    val inventory: String,       // JSON array
    val achievements: String,    // JSON array
    val settings: String,        // JSON object
    val lastSavedAt: Long,
    val version: Int = 1         // для миграций формата
)

Для Unity — PlayerPrefs для простых значений, Application.persistentDataPath + бинарный файл для сложных структур. BinaryFormatter устарел в Unity 2022 — используем JsonUtility или Newtonsoft.Json + File.WriteAllBytes.

// Unity: сохранение через JsonUtility
[Serializable]
public class SaveData {
    public int level;
    public long coins;
    public List<string> unlockedItems = new List<string>();
    public int[] levelStars; // 3 звезды на каждый уровень
    public long savedAt;
}

public class SaveSystem : MonoBehaviour {
    private const string SAVE_FILE = "save.json";

    public static void Save(SaveData data) {
        data.savedAt = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
        string json = JsonUtility.ToJson(data);
        string path = Path.Combine(Application.persistentDataPath, SAVE_FILE);

        // Сначала пишем в temp, потом переименовываем — атомарная операция
        string tempPath = path + ".tmp";
        File.WriteAllText(tempPath, json);
        File.Move(tempPath, path, overwrite: true);
    }
}

Запись через temp-файл с последующим переименованием — защита от корруптированного файла при крэше во время записи.

Облачная синхронизация

Для кроссплатформенных игр — собственный бэкенд. Для iOS-only — Game Center + iCloud. Для Android — Google Play Games Services. Для Unity — обёртки над обоими.

// Android: Google Play Games Services
GamesSignInClient.signIn().addOnCompleteListener { task ->
    if (task.isSuccessful) {
        PlayGames.getSnapshotsClient(activity)
            .open(SNAPSHOT_NAME, true, SnapshotsClient.RESOLUTION_POLICY_MOST_RECENTLY_MODIFIED)
            .addOnSuccessListener { dataOrConflict ->
                if (dataOrConflict.isConflict) {
                    resolveConflict(dataOrConflict.conflict)
                } else {
                    loadFromSnapshot(dataOrConflict.data)
                }
            }
    }
}

Google Play Games Snapshots API автоматически управляет конфликтами при RESOLUTION_POLICY_MOST_RECENTLY_MODIFIED — побеждает более свежее сохранение. Для большинства игр этого достаточно.

Версионирование формата сохранения

Формат данных меняется с обновлениями игры. Нужна миграционная система:

class SaveMigrator {
    fun migrate(data: SaveDataEntity): SaveDataEntity {
        var current = data
        while (current.version < CURRENT_VERSION) {
            current = when (current.version) {
                1 -> migrateV1toV2(current)
                2 -> migrateV2toV3(current)
                else -> throw IllegalStateException("Unknown version: ${current.version}")
            }
        }
        return current
    }

    private fun migrateV1toV2(data: SaveDataEntity): SaveDataEntity {
        // В версии 2 добавили daily challenges progress
        return data.copy(
            dailyChallenges = "{}",
            version = 2
        )
    }
}

Проверяем версию при загрузке — если старая, мигрируем до актуальной и сохраняем заново.

Защита от читерства

Для игр с монетизацией — хэш для обнаружения модификации файла:

fun computeChecksum(data: SaveDataEntity): String {
    val content = "${data.playerId}|${data.coins}|${data.gems}|${data.level}|${SECRET_SALT}"
    return MessageDigest.getInstance("SHA-256")
        .digest(content.toByteArray())
        .fold("") { str, byte -> str + "%02x".format(byte) }
}

Серверная валидация — надёжнее. Критические операции (покупка за gems) проходят через сервер, клиент не может просто записать нужное значение в файл.

Система сохранений с локальным хранилищем, облачной синхронизацией и миграцией формата для Unity/Android/iOS: 2–3 недели. Стоимость рассчитывается индивидуально.