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

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

Предметы

Уникальное снаряжение со свойствами, правилами каталога и инвентарём выбранного проекта.

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

После сохранения каталог содержит starter_sword. После проверенной покупки текущий инвентарь содержит его уникальный instanceId.

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

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

Предметы

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

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

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

    Ключ
    starter_sword
    Название
    Quickstart Sword
    Тип
    equipment
    Редкость
    common
    Активен
    true
    Базовые свойства
    {"damage":5}
    Правила свойств
    []

    Предметы имеют собственные идентификаторы и свойства. Счётные ресурсы остаются в Значениях игрока, а чисто визуальная косметика в Профиле игрока.

    Подготовьте coins по руководству значений. Сохраните активное предложение starter-sword: стоимость 10 coins, награда 1 starter_sword.

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

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

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

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

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

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

GDScript
res://scripts/items.gd
Вызов horizOn
1extends Node
2​
3# Connect and restore the existing player first. Each function is an explicit action.
4func read_inventory() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.items.getInventory(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 for item in result.data.instances:
13 print(item.instanceId, ": ", item.itemKey)
14 # Keep result.data.revision for a separately reviewed mutation.
15​
16func read_catalog_page() -> void:
17 var user = Horizon.auth.getCurrentUser()
18 if user == null:
19 return
20 var result = await Horizon.items.getCatalog(user.userId, "", 1)
21 if not result.success:
22 push_warning(result.errorCode)
23 return
24 print("Catalog revision: ", result.data.revision)
25 # Explicit Next retains revision and nextAfterKey; no automatic page loop.
26# Durable mutations: addons/horizon_sdk/examples/features/items_example.gd.
27# Preserve original instance/body/revision and the original PV purchase operationId.
28# Initial success may include item references; retained replay may return empty applied/items.
29# Read the current inventory separately; never reconstruct earlier item references.
30# A failed refresh never authorizes another purchase or a local item grant.
Открыть полный пример SDK ↗

Использовать сохранённый предмет

Импортируйте официальный пример и вспомогательные файлы. Проверьте предложение и выполните последовательность с текущим игроком. Дождитесь каждого шага и подтвердите покупку один раз. Сохраните исходный запрос при неопределённом ответе.

items_example.gd: load_catalog_page() → review_offer("starter-sword") → purchase_reviewed_offer() → refresh_inventory()

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

После сохранения каталог содержит starter_sword. После проверенной покупки текущий инвентарь содержит его уникальный instanceId.

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

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

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

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