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
// 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: desenheDEFAULT_AVATARourandomAvatarpara eles. - Redesenhe no evento
avatar:changed; leia os visuais recebidos comclient.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 onextda resposta comocursorpara 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
- Perfil do jogador: nome, configurações e idiomaComo funciona o perfil do jogador pronto do iDos Games: nome pelas regras do servidor, ID, som, volume, menos animações, o idioma do jogo e sair, parte de todo projeto novo.
- Heróis e personagens: atributos, níveis e equipamentoComo funciona o sistema de heróis pronto do iDos Games: um elenco de heróis, melhorias de atributos, níveis, Poder calculado pelo servidor, slots de equipamento e skins, e como configurá-lo no painel.
- SDK TypeScript e estrutura do projetoComo um projeto iDos Games é montado: os pacotes npm @idosgames, uma casca com login e lobby, módulos para sistemas e jogos e um arquivo de configuração para o visual.
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.