Sistemas de jogo

Avatar da conta: um visual em todos os apps

Como o avatar da conta iDos Games funciona no seu app: o visual voxel do jogador em idosgames.com, quais slots mostrar, limites de altura e como desenhá-lo com o SDK.

O avatar da conta é o personagem iDos Games do jogador: um visual para todos os apps, editado em idosgames.com. O seu app decide se usa e o que mostra dele; sem ele, o app desenha os próprios personagens.

O que o jogador vê

  • O próprio avatar no perfil e no seu app, quando o app o usa.
  • Os avatares de outros jogadores em salas, chats e rankings, desenhados do mesmo jeito.
  • Mudar avatar no perfil abre o editor em idosgames.com.

Como funciona

  • O visual fica na conta do jogador, não no seu app: uma edição chega a todos os apps de uma vez.
  • O servidor envia cada visual já ajustado às suas regras: slots ocultos retirados, altura trazida aos seus limites.
  • Os visuais são lidos por revisão: um visual sem mudança volta sem dados.

Passo 01Adicione ao projeto

Nada a instalar: o perfil de todo novo projeto já mostra o avatar quando está ligado. Para os personagens do seu jogo, use o SDK abaixo.

Passo 02Configure no painel

Abra o painel, escolha o projeto e vá em Live Operations → v2 → Avatar.

  • Usar o avatar da conta: desligado por padrão.
  • O que o app mostra: desmarque slots para retirar esses itens de todos os jogadores neste app.
  • Altura: limites de 0.9 a 1.1 na escala do padrão.

O botão IA na página abre um assistente: descreva o que precisa, ele propõe mudanças, e você as revisa e clica em Salvar.

Passo 03Teste e publique

Verifique o avatar na versão de teste do seu app. As configurações vão para o app ao vivo em uma ação separada: veja publicação e links.

Nos modelos

  • Construtor de jogos: nos gêneros 3D o herói do jogador aparece como o avatar dele, com corrida, pulo, ataques e dança da vitória. Os gêneros 2D mantêm seus próprios personagens.
  • Jogo de tabuleiro: o peão do jogador vira o avatar dele. No modo “Com amigos” os amigos veem os avatares uns dos outros no mesmo tabuleiro.
  • Convidados e jogadores sem visual recebem o herói ou peão do próprio jogo.

Loja do avatar

  • Os itens iniciais são grátis para todos; os itens novos são pagos e vendidos pela plataforma por Aspis.
  • Um item comprado fica com o jogador para sempre, em todos os apps. Ele o veste no editor em idosgames.com.
  • O perfil mostra a loja abaixo do avatar. Quando um jogador compra um item dentro do seu app, você recebe uma parte do preço; itens dos slots que você ocultou não são vendidos no seu app.
  • O perfil mostra os itens mais novos, e Todos os itens abre a loja inteira: busca por nome, Meus, vendedor e ordem (mais novos, populares, por preço). Mais itens carregam conforme você rola.
  • A compra sempre precisa da confirmação do jogador em idosgames.com. Na versão de teste do seu app nada é cobrado e nenhum item é entregue.

Itens de criadores

  • Quando a plataforma abrir os itens de criadores, qualquer pessoa com conta poderá criar um item no idosgames.com (Avatar, depois Criar seu próprio item): escolher onde ele é usado, começar de uma forma, mudar o nome, as cores e a imagem e definir um preço em Aspis.
  • No editor, os itens de criadores ficam nas mesmas seções dos oficiais: busca por nome, Meus, origem e ordem (mais novos, populares, por preço). Mais itens carregam conforme você rola.
  • O item é verificado pelas mesmas regras de qualquer item oficial, e uma cópia exata de um item existente é recusada. A aparência do item não muda depois de publicado.
  • O item é do criador na hora, e o criador recebe uma parte de cada venda. Jogadores denunciam itens ruins: um item com muitas denúncias abertas fica oculto sozinho até um moderador decidir.
  • Os itens de criadores aparecem sozinhos na loja do avatar do seu app, ao lado dos itens da plataforma. Um item oculto é tirado de todos os jogadores.

Para desenvolvedores

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 })

// Comprar um item por Aspis (o jogador confirma em 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))
  • Convidados e jogadores sem visual chegam com hasAvatar: false: desenhe DEFAULT_AVATAR ou randomAvatar para eles.
  • Redesenhe no evento avatar:changed; leia os visuais recebidos com client.avatar.peek(userID).
  • getShop() traz o que está à venda, o que o jogador tem e as receitas dos itens; sempre envie o preço que o jogador viu: se ele mudou, nada é cobrado.
  • browseShop() lê a loja página por página para milhares de itens: slot, busca, ownedOnly, vendedor e ordem; passe o next da resposta como cursor para a próxima página.

Todos os campos estão descritos no SDK, servido pelo servidor MCP do SDK.

Perguntas frequentes

O jogador pode mudar o avatar dentro do meu app?

Não: o jogador edita em idosgames.com, e todos os apps que o usam recebem o novo visual.

O que um convidado recebe?

Nenhum avatar: desenhe um visual padrão para convidados e jogadores sem visual.

Veja também

Crie o seu próprio jogo

Descreva a ideia em uma frase: o programador de IA cria o jogo, e ele vai ao ar com um link próprio.