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

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

Матчи

Пошаговые игры с явными ревизиями, непрозрачным состоянием и отдельными отчётами о результатах.

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

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

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

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

Пошаговые матчи

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

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

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

    Используйте две отдельные сессии: создайте лобби, присоединитесь, задайте порядок, чередуйте байтовые состояния и независимо сообщите одинаковый конечный результат.

    Первый пример читает данные. Он не создаёт группу, матч или объект. Пустой список является допустимым первым ответом.

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

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

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

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

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

GDScript
res://scripts/matches.gd
Вызов horizOn
1extends Node
2​
3# Explicit action after restoring the SAME existing player identity.
4func read_my_matches() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.matches.getMatches(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 print("Ledger revision: ", result.data.revision)
13 for row in result.data.recent:
14 print(row.id, " ", row.status) # May still be active after this player's forfeit.
15 # Respect result.data.pollAfterSeconds. No background poll.
16# Full two-player, durable-original example in the verified SDK:
17# addons/horizon_sdk/examples/features/matches_example.gd
18# read_matches()/create_reviewed(options), read_match(id), perform_reviewed(kind, body).
19# Each is an explicit player action. Original project+player intent survives host changes.
20# SDK methods: joinMatch(userId,id,originalRevision), startMatch(userId,id,originalRevision,order),
21# submitTurn(userId,id,originalRevision,PackedByteArray,finish),
22# reportResult(userId,id,originalFinalRevision,PackedByteArray,sortedWinnerIds).
23# Unknown create: recovery reads and explicit reconciliation, never a replacement create.
24# Report agreement is ordinary consensus, not validated combat or an automatic reward.
Открыть полный пример SDK ↗

Два игрока, один исходный ход

Используйте две отдельные сессии: создайте лобби, присоединитесь, задайте порядок, чередуйте байтовые состояния и независимо сообщите одинаковый конечный результат.

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

Отчёты используют неизменную конечную ревизию. Совпадение не доказывает достоверную победу; разногласия и отсутствующие отчёты не определяют победителя.

Рейтинговые запуски требуют подтверждённого рейтингового матча и существующего процесса Validated Actions. Обычные отчёты не выдают награды.

PHP поддерживает обычные REST-маршруты матчей. Рейтинговая проверка и реальное время недоступны; при необходимости возвращается FEATURE_NOT_SUPPORTED.

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

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

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

Эндпоинты
  • GET/matches
  • GET/matches/limits
  • GET/matches/open
  • GET/matches/{matchId}
  • POST/matches
  • POST/matches/{matchId}/join
  • POST/matches/{matchId}/decline
  • POST/matches/{matchId}/start
  • POST/matches/{matchId}/turn
  • POST/matches/{matchId}/timeout
  • POST/matches/{matchId}/leave
  • POST/matches/{matchId}/cancel
  • POST/matches/{matchId}/result
  • POST/matches/{matchId}/ranked-run
Все эндпоинты в справочнике API
Иллюстрация функции «Рейтинги»
Наше предложение для следующего шага

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

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