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

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

Проверенные действия

Проверяйте игровые действия на сервере.

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

Допустимое действие принимается, а недопустимое отклоняется.

Проверять игровые действия3:12

Этот урок воспроизводится на английском.

Открыть видео отдельно ↗

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

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

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

    Ключ (slug)
    weekly
    Принимать результаты только из проверенных забегов
    true
    Максимальный результат
    20000
    Минимальная длительность (секунды)
    0
    Этап обязателен
    false

    Сохраните эти правила в тестовом проекте без других ограничений. Фиксированные байты quickstart проверяют протокол. Счёт 18250 должен приниматься. Начните новый забег с 20001 для проверки отказа. В игре записывайте реальные действия.

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

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

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

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

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

Сохраните GDScript, добавьте к узлу главной сцены и запустите сцену. Проверьте Output.

GDScript
res://scripts/validated_actions.gd
Вызов horizOnПодготовка
1# Прикрепи этот скрипт к узлу в главной сцене.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # Подготовка: инициализация, подключение и вход игрока.
9 var connected = await Horizon.connect_to_server()
10 if not connected:
11 print("Failed to connect to horizOn server")
12 return
13 if not Horizon.auth.isSignedIn():
14 var signed_in: bool
15 if Horizon.auth.hasCachedAnonymousToken():
16 signed_in = await Horizon.auth.restoreAnonymousSession()
17 else:
18 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
19 if not signed_in:
20 return
21​
22 # horizOn: начать забег, записать ввод, отправить проверенный результат.
23 # 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
24​
25 # 2. Round start: single-use ticket plus server seed
26 var run: Dictionary = await Horizon.validatedActions.startRun("weekly")
27 if run.is_empty():
28 print(Horizon.validatedActions.getLastErrorCode()) # e.g. RUN_RATE_LIMITED
29 return
30 var rng := RandomNumberGenerator.new()
31 rng.seed = run["seed"]
32​
33 # Protocol test input only. Replace it with actual recorded game inputs in your game.
34​
35 # 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
36 var result: Dictionary = await Horizon.validatedActions.submitValidated(18250, input_log)
37 if result.is_empty():
38 print(Horizon.validatedActions.getLastErrorCode())
39 return
40 print("Accepted score=", result.get("score"), ", rank=", result.get("rank"))
Открыть полный пример SDK ↗

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

Допустимое действие принимается, а недопустимое отклоняется.

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

Эндпоинты
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Все эндпоинты в справочнике API
Иллюстрация функции «Рейтинги»
Наше предложение для следующего шага

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

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

Обучающее видео

Проверенные действияGodot6:05

Этот урок воспроизводится на английском.

Открыть видео отдельно ↗
Значения, управляемые серверомGodot4:58

Этот урок воспроизводится на английском.

Открыть видео отдельно ↗
Журнал вводаGodot5:45

Этот урок воспроизводится на английском.

Открыть видео отдельно ↗