iDos Games
Create
Игровые системы

Инвентарь: предметы и валюты игрока

Как работает готовый инвентарь iDos Games - предметы по категориям и редкости, количество и уровень, карточка предмета и переход к героям и сундукам - и как настроить предметы и валюты в кабинете.

Обновлено: English

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

Что видит игрок

  • Вкладки категорий: снаряжение, расходники, прочее.
  • Рамки редкости, количество и уровень у каждого предмета.
  • Карточку предмета с описанием.
  • Переход: снаряжение открывает экран героев, сундук или ключ - сундуки.
Инвентарь
12 450
320
Снаряжение
Расходники
Прочее
МечLv 5
ЩитLv 2
Зельеx12
Ключx3
Сундукx1
ТопорLv 1
Звездаx40
Рубинx7
Сундук

Открывается ключом. Внутри снаряжение любой редкости.

К сундукам
Вкладки категорий; инвентарь виден в лобби всегда.
Предметы в рамках редкости, с количеством и уровнем.
Карточка предмета; снаряжение ведёт к героям, сундуки и ключи - к сундукам.
Пример. Инвентарь: вкладки категорий, предметы по редкости и карточка предмета.

Как устроено

  • Инвентарь читает кэш SDK и своих запросов не делает.
  • Предметы-стопки хранятся числом, уникальные (снаряжение) - экземплярами со своим уровнем.
  • Каждая система, которая выдаёт или тратит предметы, меняет один и тот же инвентарь на сервере.

Шаг 01Добавьте систему в проект

Добавлять не нужно: инвентарь есть в каждом новом проекте, и его вкладка видна даже до того, как у тайтла появятся предметы.

Шаг 02Настройте в кабинете

Откройте кабинет, выберите проект и перейдите в LiveOps → v2 → Предмет.

  • Создайте предметы в разделе Предмет: название, категория, редкость, стопка или уникальный и что он делает.
  • Создайте валюты в разделе Валюта: мягкую и твёрдую валюту игры.

Кнопка ИИ на странице открывает помощника: опишите, что нужно, он предложит правки, а вы проверите их и нажмёте Сохранить.

Шаг 03Проверьте и выпустите

Проверьте систему в тестовой версии приложения. В живое приложение настройки уходят отдельным действием - см. публикация и ссылки.

Для разработчиков

Предметы и валюты работают через client.item и client.currency из @idosgames/core; состояние лежит в кэше SDK.

TypeScript
// Инвентарь уже в кэше SDK после входа, лишнего запроса нет
const inv = client.data.user.state?.Inventory
inv?.VirtualCurrencies?.['GOLD'] // баланс валюты
inv?.Items?.['potion']?.TotalAmount // стопкой хранящийся предмет
Object.values(inv?.UnstackableItems ?? {}) // экземпляры снаряжения с уровнями
  • Рисуйте из кэша: он обновляется сам после каждой покупки, награды и крафта.
  • Выдавайте предметы только через системы (награды, магазин, сундуки): клиент сам предметы не добавляет.

Подробное описание полей - в навыке item-system, его отдаёт MCP-сервер SDK.

Частые вопросы

Инвентарь нужно добавлять?

Нет. Он есть в каждом новом проекте и всегда виден в лобби.

Где настраиваются валюты?

В разделе Валюта кабинета. Предметы - в разделе Предмет.

Смотрите также

Сделайте свою игру

Опишите идею одним предложением - ИИ-кодер соберёт её, и она откроется по своей ссылке.

СоздатьПодключить ИИ-агента