Sistemas de jogo

Correio no jogo: cartas, recompensas e presentes

Como funciona o correio pronto do iDos Games: cartas com recompensas do publisher, recompensas perdidas de outros sistemas, presentes diários e transferências entre amigos, e como ativá-lo no painel.

O correio é a caixa de entrada do jogador: cartas suas com recompensas, recompensas perdidas de outros sistemas e presentes entre amigos. Ele faz parte de todo projeto novo e aparece no lobby quando você ativa o correio.

O que o jogador vê

  • Abas por categoria: todas, recompensas, presentes, sistema.
  • Uma carta com o texto no idioma do jogador, o remetente, um banner, recompensas e um botão para uma tela ou página.
  • "Pegar" e "Pegar tudo" em uma única operação no servidor; recompensas de outros sistemas ainda não recolhidas ficam no topo.
  • "Enviar presentes": um presente diário grátis para amigos ("para todos" com um toque) e transferências de moedas ou itens próprios para um amigo.
Correio
12 450
320
Todas3
Recompensas
Presentes
Boas-vindas!Da equipe · 500 moedas
Pegar
Ranking semanal: 7ºRecompensa à espera
Pegar
Presente de Mira50 moedas
Enviar presentes
Para todos
Pegar tudo
Cartas por categoria; o selo do lobby conta cartas e recompensas não lidas.
Cartas com recompensas; recompensas perdidas de outros sistemas também são recolhidas aqui.
Um presente diário grátis para amigos e “Pegar tudo” em uma operação.
Exemplo. O correio: cartas com recompensas, presentes e “Pegar tudo”.

Como funciona

  • Recompensas perdidas de outros sistemas (uma rodada de ranking, o prêmio de um evento de equipe, recompensas de convite) são recolhidas aqui mesmo.
  • Transferências recusadas ou vencidas voltam para quem enviou.
  • O servidor cuida dos limites, da verificação de amizade, do vencimento e do que pode ser transferido.

Passo 01Adicione o sistema ao seu projeto

Não há nada a adicionar: o correio faz parte de todo projeto novo. A aba fica oculta até o correio ser ativado.

Passo 02Configure no painel

Abra o painel, escolha seu projeto e vá em Operações ao vivo → v2 → Caixa de correio.

  • Ative o correio.
  • Crie modelos de carta e envie mensagens em massa para os jogadores.
  • Defina o presente diário e quais moedas e itens os amigos podem transferir.

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

O correio funciona por meio de client.mailbox no @idosgames/core.

TypeScript
// As cartas de uma categoria, depois recolher tudo o que está à espera em uma operação
const mail = await client.mailbox.getMessages({ category: 'Reward' })
const res = await client.mailbox.claimAll()
// Um presente diário grátis para vários amigos de uma vez
await client.mailbox.sendGift('daily_coins', [friendA, friendB])
  • Uma transferência para um amigo é sendTransfer; o servidor confere a amizade e os limites.
  • O selo é getUnreadCount: cartas não lidas e recompensas à espera.

Todos os campos estão descritos na habilidade mailbox-system, servida pelo servidor MCP do SDK.

Perguntas frequentes

Posso enviar uma carta com recompensa para todos os jogadores?

Sim. Os envios em massa com recompensa saem da seção Caixa de correio do painel.

Os jogadores podem enviar moedas uns aos outros?

Sim, para amigos, dentro dos limites que você definir. Uma transferência recusada ou vencida volta.

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.