Идеи и функции для игры

Ваша следующая функция

Достижения

Ключ открывается один раз на игрока. Ручной режим доверяет игре; пороги проверяются в той же транзакции затронутого отчёта.

SDK: developТребуется сессия игрока
Godot
Иллюстрация функции «Достижения»
Видимый результат

После действия first_steps разблокирован для того же игрока. Повтор ключа не даёт второго достижения или награды.

Видео появится позже

Для этого шага пока нет видео. Инструкция и запрос MCP уже доступны.

Достижения

Подготовьте тот же проект

  1. Выберите в панели тот же проект, что указан в конфигурации игры.

    Достижения →
  2. Создайте или используйте эти тестовые записи в форме панели. Это примеры значений, а не текущие данные проекта.

    Ключ
    first_steps
    Название
    First steps
    Правило открытия
    manual
    Активно
    true
    Скрыто до открытия
    false
    Без награды
    []

    Ключ открывается один раз на игрока. Ручной режим доверяет игре; пороги проверяются в той же транзакции затронутого отчёта.

  3. Сохраните, загрузите заново и проверьте записи до запуска примера. Сохраните остальные определения.

Добавьте эту функцию

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

SDK установлен, конфигурация проекта импортирована, игрок вошёл в систему.

Этот пример SDK использует develop. Проверьте наличие нужных API в установленном SDK.

Завершите подключение нужного игрока по быстрому старту. Вызовите run_reviewed_action() явной кнопкой или действием сцены. Открытие файла само по себе запрос не отправляет.

GDScript
res://scripts/achievements.gd
Вызов horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5# This explicit action unlocks the shown configured achievement key.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var user_id: String = Horizon.auth.getCurrentUser().userId
10 var loaded: Dictionary = await Horizon.achievements.getAchievements(user_id, "")
11 if not loaded.success:
12 push_warning(loaded.errorCode)
13 return
14 for progress in loaded.data.progress:
15 print(progress.key, ": ", progress.rewardState)
16​
17 # Configure manual first_steps; invoke on the corresponding game action.
18 var unlocked: Dictionary = await Horizon.achievements.unlock(user_id, "first_steps")
19 if not unlocked.success:
20 push_warning(unlocked.errorCode) # After timeout retry the same key.
21 return
22 # Complete progress has no unlock date or pending reward payload.
23 # Values were credited atomically. Refresh playerValues when displaying balances.
24 # No Inbox claim or local value addition. Retry the original key after an uncertain reply.
Открыть полный пример SDK ↗

Проверьте новую функцию.

После действия first_steps разблокирован для того же игрока. Повтор ключа не даёт второго достижения или награды.

Выберите в панели тот же проект, что указан в конфигурации игры.

Эндпоинты
  • GET/achievements
  • POST/achievements/unlock
  • POST/achievements/rewards/deliver
Все эндпоинты в справочнике API
Иллюстрация функции «Рейтинги»
Наше предложение для следующего шага

Добавьте рекорд для каждого раунда.

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