Операционная деятельность

Операционная деятельность охватывает временные события, таблицы лидеров, достижения, облачные сохранения, автоматическое резервное копирование и поддержку модов. Эти системы обеспечивают непрерывную доставку контента и вовлечение игроков после запуска.

События, таблицы лидеров и достижения на одном экране. Обратный отсчёт активного события идёт по времени сервера, а не по часам клиента, — именно это не даёт игроку закончить событие досрочно, изменив системную дату.

Обзор архитектуры

Класс	Файл	Ответственность
EventService	Persistence/PersistenceAndSystems.cs	Управление сезонными/временными событиями
LeaderboardService	Persistence/PersistenceAndSystems.cs	Ранжированные таблицы лидеров с отправкой очков
AchievementService	Persistence/PersistenceAndSystems.cs	Отслеживание достижений и система разблокировки
CloudSaveService	Persistence/PersistenceAndSystems.cs	Загрузка/скачивание облачных сохранений с обнаружением конфликтов
BackupScheduler	AntiCheat/AntiCheatManager.cs	Автоматическое периодическое облачное резервное копирование
ModLoader	Persistence/PersistenceAndSystems.cs	Загрузка модов сообщества во время выполнения

Доступ через NakamaManager.Instance:

var events = NakamaManager.Instance.Events;
var leaderboards = NakamaManager.Instance.Leaderboards;
var achievements = NakamaManager.Instance.Achievements;
var cloudSave = NakamaManager.Instance.CloudSave;
var mods = NakamaManager.Instance.Mods;

Сервис событий

EventService управляет временными живыми событиями (дни сообщества, сезонный контент, особые встречи).

Получение активных событий

List<LiveEvent> activeEvents = await events.GetActiveEventsAsync();

foreach (var evt in activeEvents)
{
    // evt.Id -- уникальный ID события
    // evt.Name -- отображаемое имя
    // evt.Description -- детали события
    // evt.StartTime -- временная метка Unix (мс) начала
    // evt.EndTime -- временная метка Unix (мс) окончания
    // evt.RewardData -- JSON-кодированная конфигурация награды
}

Жизненный цикл события

events.OnEventStarted += (LiveEvent evt) =>
{
    Debug.Log($"Event started: {evt.Name}");
    // Показать баннер события, включить особые встречи и т.д.
};

events.OnEventEnded += (string eventId) =>
{
    Debug.Log($"Event ended: {eventId}");
    // Удалить контент события, раздать награды за участие
};

Модель данных LiveEvent

Поле	Тип	Описание
Id	string	Уникальный идентификатор события
Name	string	Отображаемое имя
Description	string	Текст описания события
StartTime	long	Временная метка начала (Unix мс)
EndTime	long	Временная метка окончания (Unix мс)
RewardData	string	JSON-кодированная конфигурация награды

События настраиваются на стороне сервера через консоль Nakama. Клиент опрашивает активные события и реагирует на уведомления о начале/окончании.

Сервис таблиц лидеров

LeaderboardService предоставляет ранжированные таблицы лидеров с отправкой очков и запросами рейтинга.

Отправка очков

await leaderboards.SubmitScoreAsync(
    boardId: "pvp_season_1",
    score: 1850);

await leaderboards.SubmitScoreAsync(
    boardId: "dex_completion",
    score: 151);

Запрос рейтингов

// Получить лучших игроков
List<LeaderboardEntry> top100 = await leaderboards.GetTopPlayersAsync(
    boardId: "pvp_season_1",
    limit: 100);

foreach (var entry in top100)
{
    // entry.Rank, entry.DisplayName, entry.Score, entry.UserId
}

// Получить мой рейтинг
LeaderboardEntry myRank = await leaderboards.GetMyRankAsync("pvp_season_1");

Обновление данных

await leaderboards.RefreshAsync();

Модель данных LeaderboardEntry

Поле	Тип	Описание
UserId	string	ID пользователя Nakama игрока
DisplayName	string	Отображаемое имя игрока
Score	long	Значение очков
Rank	int	Позиция в таблице лидеров

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

Сервис достижений

AchievementService отслеживает достижения игроков с поддержкой прогресса.

Список достижений

List<Achievement> all = await achievements.GetAchievementsAsync();

foreach (var ach in all)
{
    // ach.Id, ach.Name, ach.Description
    // ach.CurrentProgress, ach.MaxProgress
    // ach.IsUnlocked, ach.RewardData
}

Разблокировка достижений

// Мгновенная разблокировка
await achievements.UnlockAsync("first_capture");

// На основе прогресса (например, "Поймать 100 монстров")
await achievements.UpdateProgressAsync("centurion_catcher", progress: 47);

События достижений

achievements.OnAchievementUnlocked += (Achievement ach) =>
{
    Debug.Log($"Achievement unlocked: {ach.Name}!");
    // Показать всплывающее окно, выдать награду из ach.RewardData
};

Обновление данных

await achievements.RefreshAsync();

Модель данных Achievement

Поле	Тип	Описание
Id	string	Уникальный ID достижения
Name	string	Отображаемое имя
Description	string	Описание достижения
CurrentProgress	int	Текущее значение прогресса
MaxProgress	int	Целевой прогресс для завершения
IsUnlocked	bool	Завершено ли достижение
RewardData	string	JSON-кодированная конфигурация награды

Сервис облачных сохранений

CloudSaveService соединяет существующую JSON-систему сохранений MCE с хранилищем сервера Nakama, обеспечивая кроссплатформенную игру.

Загрузка сохранений

string saveJson = GetLocalSaveJson(); // Ваша сериализация сохранения
bool success = await cloudSave.UploadSaveAsync(saveJson);

// cloudSave.HasCloudSave -- true после успешной загрузки
// cloudSave.LastSyncTimestamp -- временная метка Unix последней синхронизации

Скачивание сохранений

string saveJson = await cloudSave.DownloadSaveAsync();
// Десериализовать и применить к локальному состоянию игры

Обнаружение конфликтов

При сохранении система может обнаруживать конфликты между локальными и облачными данными:

SaveConflictInfo conflict = await cloudSave.CheckSaveConflictAsync(localTimestamp);

if (conflict.HasConflict)
{
    // conflict.CloudTimestamp vs conflict.LocalTimestamp
    // Показать UI, чтобы игрок выбрал, какое сохранение оставить
}

Специализированная синхронизация

// Синхронизация ячеек ПК (хранилище монстров)
await cloudSave.SyncPCStorageAsync(pcStorageJson);

// Синхронизация данных прогресса (значки, Покедекс, квесты)
await cloudSave.SyncProgressionAsync(progressionJson);

Планировщик резервного копирования

BackupScheduler — это MonoBehaviour, который создаёт периодические автоматические облачные резервные копии.

Конфигурация

Поле	По умолчанию	Описание
autoSaveIntervalMinutes	5	Минут между автоматическими резервными копиями
maxBackupSlots	10	Максимальный размер истории резервирования (ротация FIFO)

Что резервируется

Резервная копия выгружает то, что возвращает SaveDataProvider планировщика (Func<string>). Если вы его не задали, планировщик использует LocalSaveDataProvider, который читает самое свежее сохранение SavegameManager на диске. Если нет провайдера, нет сохранения на диске или нет соединения, резервное копирование пропускается и срабатывает OnBackupFailed: ничего не выгружается, и запись в историю не создаётся.

Ручное резервирование

backupScheduler.CreateBackupAsync();

Восстановление из резервной копии

string saveJson = await backupScheduler.RestoreBackupAsync(backupId);

События резервирования

backupScheduler.OnBackupCreated += (BackupEntry entry) =>
{
    // entry.Id, entry.Timestamp, entry.Type, entry.SizeBytes
};

backupScheduler.OnBackupFailed += (string reason) =>
{
    Debug.LogWarning($"Backup failed: {reason}");
};

Типы резервных копий

Тип	Описание
Auto	Периодическая автоматическая резервная копия
Manual	Резервная копия, инициированная игроком
PreBattle	Снимок перед входом в бой
PreTrade	Снимок перед выполнением обмена

Поддержка модов

ModLoader позволяет загружать созданные сообществом пакеты контента во время выполнения. Это контролируется OnlineConfig.EnableModSupport (по умолчанию: false).

Загрузка модов

Установленные моды загружаются автоматически во время подключения, когда поддержка модов включена:

await mods.LoadInstalledModsAsync();

Установка и удаление модов

bool installed = await mods.InstallModAsync("/path/to/mod.zip");
bool removed = await mods.UninstallModAsync(modId);

Список загруженных модов

IReadOnlyList<ModManifest> loadedMods = mods.LoadedMods;

foreach (var mod in loadedMods)
{
    // mod.Id, mod.Name, mod.Author, mod.Version
    // mod.Description, mod.IsEnabled
    // mod.ContentTypes -- например, ["monsters", "maps", "items", "moves"]
}

События модов

mods.OnModLoaded += (ModManifest manifest) =>
{
    Debug.Log($"Mod loaded: {manifest.Name} v{manifest.Version}");
};

mods.OnModError += (string modId, string error) =>
{
    Debug.LogError($"Mod error ({modId}): {error}");
};

Модель данных ModManifest

Поле	Тип	Описание
Id	string	Уникальный идентификатор мода
Name	string	Отображаемое имя
Author	string	Автор мода
Version	string	Семантическая версия
Description	string	Описание мода
ContentTypes	string[]	Типы контента: "monsters", "maps", "items", "moves"
IsEnabled	bool	Активен ли мод в данный момент

Античит-системы

Античит-слой работает вместе с операционной деятельностью для поддержания целостности игры. См. специальные античит-классы в AntiCheat/AntiCheatManager.cs:

• SpeedValidator: Обнаруживает читы на скорость, сравнивая скорость передвижения с настраиваемым максимумом (по умолчанию: 8 тайлов/секунду).
• ActionRateLimiter: Предотвращает спам действий с настраиваемым минимальным интервалом (по умолчанию: 0,3 секунды).
• InventoryAuditor: Обнаруживает дублирование предметов и нелегальные предметы, сравнивая инвентарь, сообщённый клиентом, со снимками сервера.
• AntiCheatManager: Координирует все валидаторы с порогами нарушений — 10 нарушений вызывают кик, 25 — бан.