RetroAchievements Import RU

Импорт из RetroAchievements

Импортируйте библиотеку ретро-игр из RetroAchievements в Tonkatsu Box. Игры сопоставляются с базой IGDB, с отслеживанием прогресса ачивок и статуса.

Что импортируется

Данные RA	Tonkatsu Box
Сыгранные игры	Игры, найденные в IGDB
Прогресс ачивок	Хранится в базе трекера, прогресс-бары в карточке игры
Высшая награда (mastered/beaten)	Статус «Завершено»
Игры с ачивками > 0	Статус «В процессе» (или «Брошено» если неактивна >90 дней)
Игры с 0 ачивок	Статус не меняется
Дата награды (beaten/mastered)	Сохраняется как дата «Завершено»
Дата первой полученной ачивки	Сохраняется как дата «Начато»
Дата последней полученной ачивки	Сохраняется как дата «Последняя активность»
Ненайденные игры	Добавляются в Вишлист (опционально)
Консоль/платформа	Маппинг на платформу IGDB (50+ консолей)

Требования

• Ключ IGDB API - нужен для сопоставления игр с базой IGDB. Настройка IGDB →
• Имя пользователя RetroAchievements - имя вашего профиля на RA
• API ключ RetroAchievements - получить на retroachievements.org/controlpanel.php

Настройка учётных данных RA

1. Перейдите в Настройки → Импорт → RetroAchievements
2. Введите Имя пользователя RA
3. Введите API ключ RA
4. Нажмите Проверить подключение для проверки данных и предпросмотра профиля

После сохранения учётных данных значок RA появится в заголовке каждой игровой карточки, чья платформа поддерживается RetroAchievements.

Как импортировать

1. В Tonkatsu Box: перейдите в Настройки → Импорт → RetroAchievements
2. Введите учётные данные (если ещё не сохранены)
3. Настройте параметры:
   • Добавить ненайденные в Вишлист - сохраняет игры, не найденные в IGDB
4. Выберите целевую коллекцию:
   • Создать новую коллекцию - создаст «RA Games»
   • Использовать существующую - выбор из списка
5. Нажмите Начать импорт

Прогресс импорта

Во время импорта вы увидите:

• Текущий этап (загрузка библиотеки RA, поиск в IGDB)
• Прогресс-бар с текущим / общим количеством
• Название игры, которая сейчас ищется
• Счётчики в реальном времени: добавлено, обновлено, в вишлист

Как работает матчинг

Для каждой игры из библиотеки RA:

1. Ручные привязки имеют приоритет. Если вы уже руками связали игру с RA в её карточке (раздел достижений → «Привязать к RA») в прошлой сессии, импортёр использует сохранённый IGDB id и пропускает IGDB-поиск. Игра не уйдёт повторно в вишлист.
2. Иначе - приложение ищет в IGDB по названию игры с фильтром по платформе (напр. SNES → IGDB платформа 19)
3. Выбирает лучшее совпадение: точное имя > подстрока > первый результат
4. Если с фильтром платформы нет результатов - повторяет поиск без фильтра
5. Если найдено - игра добавляется в коллекцию с правильной ретро-платформой
6. Если не найдено - игра сохраняется в Вишлист с указанием консоли

Маппинг платформ

Импортёр поддерживает маппинг 50+ консолей RetroAchievements на платформы IGDB:

NES, SNES, N64, Game Boy, GBA, Game Boy Color, Genesis/Mega Drive, Master System, Game Gear, Saturn, Dreamcast, Sega CD, 32X, PlayStation, PS2, PSP, Nintendo DS, 3DS, TurboGrafx-16, PC Engine, Neo Geo, Atari 2600/7800/Jaguar/Lynx, 3DO, ColecoVision, Virtual Boy, WonderSwan, Game & Watch, Arcade и другие.

Правила синхронизации статуса

Статус всегда синхронизируется с данными RA - как при импорте, так и при открытии карточки:

Условие RA	Статус	Примечание
Награда: mastered / beaten / completed	Завершено	Любой вариант beaten/mastered
Ачивки > 0, последняя активность > 90 дней назад	Брошено	Только если текущий статус НЕ «Запланировано» / «Не начато»
Ачивки > 0, недавняя активность	В процессе
0 ачивок	Без изменений	У RA нет данных - существующий статус сохраняется

Защита от Dropped

Если текущий статус игры - Запланировано или Не начато, он НЕ будет изменён на «Брошено», даже если RA показывает >90 дней неактивности. Это предотвращает некорректную пометку игр, которые пользователь ещё не начинал. Все остальные переходы (→ Завершено, → В процессе) разрешены из любого статуса.

Значок RA в заголовке карточки

Когда учётные данные RA настроены, логотип RetroAchievements появляется в заголовке карточки игры (рядом с бейджем IGDB и названием платформы):

• Цветной логотип - игра привязана к RA. Клик открывает страницу игры на RA в браузере
• Мерцающий полупрозрачный логотип - игра НЕ привязана к RA, но может быть. Клик для поиска и привязки
• Нет логотипа - учётные данные RA не настроены, или платформа игры не поддерживается RA

Ручная привязка игр

Если игра не была найдена при импорте (напр. разные названия в IGDB и RA), можно привязать вручную:

1. Откройте карточку игры
2. Нажмите на мерцающий логотип RA в заголовке
3. Приложение загружает все игры для этой консоли из RA и фильтрует по имени
4. Выберите нужную игру из списка
5. Данные об ачивках загрузятся автоматически

Чтобы отвязать игру: нажмите кнопку Отвязать (значок разорванной цепи) в заголовке секции RA. Это удалит данные трекера и ачивки для этой игры.

Трекер ачивок в карточке игры

Когда игра привязана к RA, в карточке отображается секция RetroAchievements:

• Статистика - всего ачивок, заработанные/всего очков, хардкор счётчик
• Бейдж награды - Mastered (золотой), Beaten (серебряный), Hardcore (оранжевый кружок)
• Прогресс прохождения - бары для progression и win condition ачивок
• Чипы фильтрации - Все, Полученные, Заблокированные, Missable, Progression, Win Condition
• Список ачивок - иконки, названия, описания, очки, даты получения
• Свернуть/Развернуть - кнопка сверху и снизу списка для удобной навигации
• Обновить - ручное обновление данных из RA API
• Открыть на RA - открывает страницу игры на retroachievements.org

Детали достижений загружаются при первом открытии карточки игры. Дальше они сохраняются локально, и повторные открытия мгновенны.

Синхронизация дат при открытии карточки

При открытии карточки игры с данными RA автоматически синхронизируются даты:

• Начато - дата самой ранней полученной ачивки
• Последняя активность - дата самой свежей полученной ачивки
• Завершено - дата награды (если beaten/mastered)

Это происходит и при первом открытии, и при нажатии «Обновить».

Обработка дубликатов

При импорте в существующую коллекцию:

• Игры, уже имеющиеся в коллекции, обновляются (а не пропускаются):
  • Статус всегда синхронизируется с данными RA (см. Правила синхронизации статуса выше)
  • Даты активности обновляются
  • Данные трекера (ачивки, награды) обновляются в базе трекера
• Вишлист дедуплицируется - существующие элементы с тем же именем не дублируются

Ограничение скорости

• RA API: 1 запрос в секунду между страницами пагинации
• IGDB: 300мс между поисковыми запросами
• Библиотека из 200 игр импортируется за 2-3 минуты

Советы

• Можно импортировать повторно для обновления данных - существующие элементы обновятся, а не задублируются
• Проверьте данные кнопкой Проверить подключение - она покажет ваш профиль с очками и датой регистрации
• Если IGDB не настроен, вверху экрана импорта появится предупреждение
• Импортёр загружает прогресс и даты наград параллельно для ускорения
• Детали достижений загружаются только при открытии карточки этой игры
• Данные трекера включаются в полные бэкапы и восстанавливаются автоматически
• Используйте мерцающий логотип RA для ручной привязки игр, не найденных при импорте