Inventário: os itens e moedas do jogador
Como funciona o inventário pronto do iDos Games: itens por categoria e raridade, quantidades e níveis, cartões de item e passagem para heróis e baús, e como configurar itens e moedas no painel.
O inventário mostra tudo o que o jogador tem: itens por categoria e raridade, com quantidades e níveis. Ele faz parte de todo projeto novo e aparece sempre no lobby; os itens e as moedas em si são configurados uma vez no painel e usados por todos os outros sistemas.
O que o jogador vê
- Abas por categoria: equipamento, consumíveis, outros.
- Molduras de raridade, quantidades e níveis em cada item.
- Um cartão de item com a descrição.
- Passagem: um equipamento abre a tela de heróis, um baú ou uma chave abre os baús.
Abre com uma chave. Contém equipamentos de qualquer raridade.
Como funciona
- O inventário lê o cache do SDK: ele não faz requisição própria.
- Itens empilháveis são guardados como quantidade; os únicos (equipamento), como instâncias com nível próprio.
- Todo sistema que concede ou gasta itens altera o mesmo inventário no servidor.
Passo 01Adicione o sistema ao seu projeto
Não há nada a adicionar: o inventário faz parte de todo projeto novo, e a aba aparece mesmo antes de o título ter itens.
Passo 02Configure no painel
Abra o painel, escolha seu projeto e vá em Operações ao vivo → v2 → Item.
- Crie itens em Item: nome, categoria, raridade, empilhável ou único, e o que fazem.
- Crie moedas em Moeda: as moedas comuns e premium do jogo.
O botão IA da página abre um assistente: descreva o que precisa, ele propõe as mudanças, e você revisa e aperta Salvar.
Passo 03Teste e lance
Confira o sistema 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.
Para desenvolvedores
Itens e moedas funcionam por meio de client.item e client.currency no @idosgames/core; o estado fica no cache do SDK.
// O inventário já está no cache do SDK depois do login, sem requisição extra
const inv = client.data.user.state?.Inventory
inv?.VirtualCurrencies?.['GOLD'] // o saldo de uma moeda
inv?.Items?.['potion']?.TotalAmount // um item empilhável
Object.values(inv?.UnstackableItems ?? {}) // instâncias de equipamento com seus níveis- Desenhe a partir do cache: ele se atualiza sozinho depois de cada compra, recompensa e criação.
- Conceda itens só pelos sistemas (recompensas, loja, baús): o cliente nunca adiciona itens.
Todos os campos estão descritos na habilidade item-system, servida pelo servidor MCP do SDK.
Perguntas frequentes
Preciso adicionar o inventário?
Não. Ele faz parte de todo projeto novo e aparece sempre no lobby.
Onde as moedas são configuradas?
Na seção Moeda do painel. Os itens ficam na seção Item.
Veja também
- 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.
- Caixas de loot e baús no seu jogoComo funcionam as caixas de loot prontas do iDos Games: baús abertos com moeda, um item-baú ou uma chave, dez de uma vez, com resultado sorteado pelo servidor, e como configurá-las no painel.
- Criação no seu jogo: receitas de troca para cimaComo funciona a criação pronta do iDos Games: receitas que transformam vários itens de uma raridade em um melhor, um contrato com itens seus, preenchimento automático e um resultado sorteado pelo servidor, e como configurá-la no painel.
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.