Импорт из RetroAchievements
============================

Общая информация
-------------------

Функционал импорта платин из RetroAchievements позволяет быстро синхронизировать прогресс достижений из вашего профиля RetroAchievements в раздел Platinum на сайте.

Для использования функционала необходимо:

- Иметь добавленный RetroAchievements аккаунт в личном кабинете

Добавление RetroAchievements аккаунта
---------------------------------------

Перед импортом необходимо добавить RetroAchievements аккаунт в личном кабинете:

1. Перейдите в личный кабинет → раздел "Профиль"
2. Найдите секцию "RetroAchievements аккаунты"
3. Нажмите "Добавить RetroAchievements аккаунт"
4. Укажите имя пользователя RetroAchievements (Username)
5. Сохраните аккаунт

.. tip::

    Имя пользователя можно найти в вашем профиле на сайте https://retroachievements.org/ - это ваш логин

Выбор RetroAchievements аккаунта
----------------------------------

На странице импорта отображаются все ваши добавленные RetroAchievements аккаунты. Для начала импорта:

1. Нажмите на кнопку с именем нужного RetroAchievements аккаунта
2. Система загрузит список завершенных игр из вашего профиля RetroAchievements
3. Отобразятся игры, доступные для импорта


Доступные для импорта игры
----------------------------

После выбора RetroAchievements аккаунта отображается список игр, которые:

- Есть в вашем профиле RetroAchievements с прогрессом достижений
- Имеют систему достижений (минимум 1 достижение)
- Присутствуют в базе данных сайта (поиск по точному совпадению названия)
- Ещё не добавлены в ваш раздел Platinum

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

- Название игры
- Прогресс достижений (полученные/всего)
- Процент выполнения
- Прогресс-бар с визуализацией прогресса
- Чекбокс для выбора игры

.. note::

    Прогресс-бар становится зеленым при 100% выполнении достижений

Импорт платин
--------------

Для импорта игр:

1. Отметьте галочками игры, которые хотите импортировать
2. Нажмите кнопку "Импортировать выбранные"

При импорте:

- Автоматически заполняется общее количество достижений (MaxPossible)
- Автоматически заполняется количество полученных достижений (NumAwarded)
- Платформа автоматически устанавливается как **RetroAchievements**
- Статус рассчитывается автоматически на основе прогресса:
  
  - **"Не начат"** - 0% достижений
  - **"В процессе"** - от 1% до 99% достижений
  - **"Завершено"** - 100% достижений

.. important::

    При статусе "Завершено" автоматически проставляется текущая дата получения платины

.. note::

    RetroAchievements API возвращает только игры с прогрессом достижений, поэтому в списке будут только те игры, в которых вы получили хотя бы одно достижение

Игры не в базе
---------------

Если в вашем профиле RetroAchievements есть игры с достижениями, которых нет в базе данных сайта, они отображаются в отдельном разделе "Игры не в базе".

Для таких игр:

- Отображается название и прогресс достижений
- Импорт невозможен до добавления игры в базу
- Доступна кнопка "Предложить" для отправки заявки на добавление игры

При нажатии на кнопку "Предложить":

1. Вы перенаправляетесь на страницу предложения игры
2. Поле "Название игры" заполняется автоматически
3. Необходимо заполнить остальные обязательные поля (жанр, описание, ссылка на покупку и т.д.)
4. Отправить заявку на рассмотрение администратору

.. note::

    После одобрения администратором игра появится в базе и станет доступна для импорта при следующей загрузке списка игр

.. important::

    Поиск игр в базе данных осуществляется по точному совпадению названия. Если игра называется в RetroAchievements иначе, чем в базе данных сайта, она не будет найдена автоматически

Требования к профилю RetroAchievements
----------------------------------------

Для корректной работы импорта необходимо:

**Настройки профиля RetroAchievements:**

- Профиль должен быть публичным (по умолчанию все профили публичные)
- Прогресс достижений должен быть виден другим пользователям

.. note::

    В отличие от Steam, RetroAchievements по умолчанию имеет открытые профили, поэтому дополнительных настроек обычно не требуется

После импорта
--------------

После успешного импорта:

- Отображается количество импортированных игр
- Происходит автоматическое перенаправление в личный кабинет в раздел Platinum
- Импортированные игры появляются в списке с актуальным прогрессом

.. tip::

    Вы можете в любой момент вернуться на страницу импорта и добавить новые игры из RetroAchievements

Обновление прогресса
---------------------

Для обновления прогресса достижений:

1. Вернитесь на страницу импорта
2. Выберите тот же RetroAchievements аккаунт
3. Система покажет только новые игры (уже добавленные не отображаются)
4. Для обновления прогресса существующих игр используйте ручное редактирование в разделе Platinum

Особенности RetroAchievements
------------------------------

**Поддерживаемые платформы:**

RetroAchievements поддерживает достижения для игр с множества ретро-платформ, включая:

- Nintendo (NES, SNES, N64, Game Boy, GBA, DS)
- Sega (Genesis/Mega Drive, Master System, Game Gear, Saturn, Dreamcast)
- Sony (PlayStation, PlayStation 2, PSP)
- Atari, Neo Geo, PC Engine и многие другие

.. tip::

    Если вы играете в ретро-игры через эмуляторы с поддержкой RetroAchievements, весь ваш прогресс будет автоматически синхронизирован и доступен для импорта