Как добавить достижения

Раздел: Документация разработчика · Обновлено 20.10.2026

Достижения в играх

Достижения — необязательный элемент игры. Их видят и открывают владельцы игры в ПК-лаунчере Atomia в разделе «Библиотека». Открытые достижения отображаются в профиле игрока (клик по карточке «Достижения»). Достижение открывается автоматически по игровому событию либо вручную самим игроком, а об открытии приходит уведомление в лаунчер и на сайт.

Шаг 1. Откройте редактирование игры

Войдите в аккаунт автора, откройте «Мои игры» и выберите игру → «Редактировать». Блок «Достижения» расположен в форме редактирования игры под основными полями.

Шаг 2. Заполните достижение

  • Название — краткое имя, например «Первая победа».
  • Описание — как игрок получает достижение (необязательно).
  • Иконка — иконка Boxicons, класс вида bx-trophy, bx-star, bx-medal. Полный список — на boxicons.com.
  • Тип получения:
    • Вручную — игрок открывает достижение кнопкой «Получить» в лаунчере.
    • При покупке — открывается автоматически, как только игра появляется в библиотеке игрока.
    • За время в игре — открывается после накопленного времени в игре (значение указывается в часах).
    • По числу запусков — открывается после указанного количества запусков игры через лаунчер.
    • По действию — открывается по игровому событию/счётчику (значение указывается ключом действия).
  • Значение — для типа «За время в игре»: сколько часов нужно отыграть (например, 5); для иных типов — требуемое количество/ключ.

Нажмите «Добавить» — достижение появится в списке ниже, где его можно удалить.

Как ведётся учёт

  • Игровое время считает лаунчер, пока игра запущена; данные периодически отправляются на сервер.
  • Число запусков игры также засчитывается лаунчером.
  • Прогресс по каждому достижению виден в библиотеке лаунчера; если у игры нет достижений, отображается «—».
  • Открытые достижения собираются в профиле игрока — карточка «Достижения» на странице профиля.
  • Об открытии достижения приходит уведомление в лаунчер и на сайт.

Советы

  • Создавайте осмысленные достижения: стартовый бонус — тип «При покупке», прогресс — «За время в игре» или «По числу запусков», сюжетные/особые — «Вручную».
  • Значения для типа «За время в игре» указывайте в часах, например 1, 5, 20.