Аватар аккаунта: персонаж игрока 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.
- В редакторе вещи авторов лежат в тех же разделах, что официальные: поиск по названию, «Мои», источник и порядок (новые, популярные, по цене). Следующие вещи подгружаются при прокрутке.
- Вещь проверяется теми же правилами, что любая официальная, точная копия существующей вещи не принимается. Вид вещи после публикации не меняется.
- Вещь сразу у автора, с каждой продажи автор получает долю. Игроки жалуются на плохие вещи: вещь с множеством открытых жалоб скрывается сама, пока модератор не решит.
- Вещи авторов сами появляются в магазине аватара вашего приложения рядом с вещами платформы. Скрытая вещь снимается со всех игроков.
Разработчикам
// 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, и все приложения, которые им пользуются, получают новый облик.
Что получает гость?
Аватара нет: рисуйте облик по умолчанию гостям и игрокам без облика.
Смотрите также
- Профиль игрока: имя, настройки и языкКак работает готовый профиль игрока iDos Games - имя по правилам сервера, ID, звук, громкость, меньше анимаций, язык игры и выход - он есть в каждом новом проекте.
- Герои и персонажи: характеристики, ранги и снаряжениеКак работает готовая система героев iDos Games - список героев, улучшение характеристик, ранги, сила, которую считает сервер, слоты снаряжения и облики - и как настроить её в кабинете.
- TypeScript SDK и устройство проектаКак устроен проект на iDos Games - npm-пакеты @idosgames, оболочка со входом и лобби, модули систем и игр и один файл настроек вида.
Сделайте свою игру
Опишите идею одним предложением - ИИ-кодер соберёт её, и она откроется по своей ссылке.