Игровые системы

Аватар аккаунта: один облик во всех приложениях

Как аватар аккаунта iDos Games работает в вашем приложении: воксельный облик игрока с idosgames.com, какие слоты показывать, пределы роста и рисование через SDK.

Аватар аккаунта: персонаж игрока iDos Games, один облик на все приложения, правится на idosgames.com. Приложение решает, пользоваться ли им и что из него показывать; без него у приложения свои персонажи.

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

  • Свой аватар в профиле и в вашем приложении, если оно им пользуется.
  • Аватары других игроков в комнатах, чатах и лидербордах, нарисованные так же.
  • Изменить облик в профиле открывает редактор на idosgames.com.

Как это работает

  • Облик живёт на аккаунте игрока, а не в приложении: одна правка сразу доходит до всех приложений.
  • Сервер присылает облик уже по вашим правилам: скрытые слоты сняты, рост приведён к вашим пределам.
  • Облики читаются по ревизии: неизменённый облик приходит без данных.

Шаг 01Добавьте в проект

Ставить ничего не нужно: профиль каждого нового проекта уже показывает аватар, когда он включён. Для своих персонажей игры используйте SDK ниже.

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

Откройте кабинет, выберите проект и перейдите в Live Operations → v2 → Avatar.

  • Использовать аватар аккаунта: по умолчанию выключено.
  • Что показывает приложение: снимите галочки, и эти вещи снимутся со всех игроков в этом приложении.
  • Рост: пределы от 0.9 до 1.1 по шкале эталона.

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

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

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

В шаблонах

  • Конструктор игр: в 3D-жанрах героя игрока рисует его аватар, вместе с бегом, прыжком, ударом и победным танцем. В 2D-жанрах остаются свои персонажи.
  • Настольная игра: фишка игрока становится его аватаром. В режиме «С друзьями» друзья видят аватары друг друга на одной доске.
  • Гостям и игрокам без облика игра показывает своего героя или фишку.

Магазин вещей

  • Стартовые вещи бесплатны у всех, новые вещи платные: их продаёт платформа за Aspis.
  • Купленная вещь остаётся у игрока навсегда, во всех приложениях. Надевает он её в редакторе на idosgames.com.
  • Профиль показывает магазин под аватаром. Когда игрок покупает вещь внутри вашего приложения, вы получаете долю цены; вещи скрытых слотов в вашем приложении не продаются.
  • В профиле видны новые вещи, «Все вещи» открывает весь магазин: поиск по названию, «Мои», продавец и порядок (новые, популярные, по цене). Следующие вещи подгружаются при прокрутке.
  • Покупку игрок всегда подтверждает на idosgames.com. В тестовой версии приложения ничего не списывается и вещь не выдаётся.

Вещи от авторов

  • Когда платформа откроет приём вещей от авторов, любой с аккаунтом сделает вещь на idosgames.com (Аватар, затем «Создать свою вещь»): выбрать, куда она надевается, начать с формы, поменять название, цвета и картинку, назначить цену в Aspis.
  • В редакторе вещи авторов лежат в тех же разделах, что официальные: поиск по названию, «Мои», источник и порядок (новые, популярные, по цене). Следующие вещи подгружаются при прокрутке.
  • Вещь проверяется теми же правилами, что любая официальная, точная копия существующей вещи не принимается. Вид вещи после публикации не меняется.
  • Вещь сразу у автора, с каждой продажи автор получает долю. Игроки жалуются на плохие вещи: вещь с множеством открытых жалоб скрывается сама, пока модератор не решит.
  • Вещи авторов сами появляются в магазине аватара вашего приложения рядом с вещами платформы. Скрытая вещь снимается со всех игроков.

Разработчикам

TypeScript
// The player's own look (null: the app does not use the account avatar)
const mine = await client.avatar.getMine()

// Looks of other players of this app: a room, a leaderboard page
const res = await client.avatar.get(userIDs)

// Draw it with @idosgames/characters
import { AvatarActor, avatarFromServer, DEFAULT_AVATAR, renderAvatarCanvas } from '@idosgames/characters/voxel'
const look = avatarFromServer(mine.ok ? mine.data : null)
const actor = new AvatarActor(look?.spec ?? DEFAULT_AVATAR, look?.items ?? {})
const sprite = look && renderAvatarCanvas(look.spec, look.items, { frame: 'full', size: 128 })

// Купить вещь за Aspis (игрок подтверждает на idosgames.com)
const shop = await client.avatar.getShop()
const page = await client.avatar.browseShop({ slot: 'hat', query: 'crown', sort: 'price_asc' })
const r = await client.credits.pay((id) => client.avatar.buyItem('hat.crown', 250, id))
  • Гости и игроки без облика приходят с hasAvatar: false: рисуйте им DEFAULT_AVATAR или randomAvatar.
  • Перерисовывайте по событию avatar:changed; полученные облики читайте через client.avatar.peek(userID).
  • getShop() отдаёт то, что продаётся, купленное игроком и рецепты вещей; передавайте цену, которую видел игрок: если она изменилась, ничего не списывается.
  • browseShop() читает магазин страницами под тысячи вещей: слот, поиск, ownedOnly, продавец и порядок; next из ответа передавайте как cursor за следующей страницей.

Все поля описаны в SDK, его отдаёт MCP-сервер SDK.

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

Игрок может сменить аватар внутри моего приложения?

Нет: игрок правит его на idosgames.com, и все приложения, которые им пользуются, получают новый облик.

Что получает гость?

Аватара нет: рисуйте облик по умолчанию гостям и игрокам без облика.

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

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

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