Convide amigos: códigos, links e recompensas
Como funciona o sistema de convites pronto do iDos Games: um código e um link de convite pessoais, um presente para o novato e uma escada de recompensas pelos amigos que vieram, e como ativá-lo no painel.
Os convites trazem jogadores novos: cada jogador tem um código curto e um link para compartilhar, o novato ganha um presente, e quem convidou sobe uma escada de recompensas pelos amigos que vieram. O sistema faz parte de todo projeto novo, mas os convites ficam desligados até você ativá-los.
O que o jogador vê
- O código curto do próprio jogador com "Copiar" e "Compartilhar link" (a janela de compartilhamento do sistema ou a área de transferência).
- Quantos amigos vieram pelo código e a escada de recompensas por eles; recolha uma ou todas.
- Digitar o código de um amigo: mostra o presente do novato e o paga uma vez.
- "Você entrou pelo código de um amigo" para um jogador vinculado no login por um link de convite.
Como funciona
- O servidor gera o código quando a tela abre; 8 letras, e separadores e maiúsculas são ignorados.
- Um novato que chegou por um link de convite é vinculado sozinho a quem convidou no login.
- Enquanto os convites estiverem desligados, a tela avisa e não faz nenhuma requisição.
Passo 01Adicione o sistema ao seu projeto
Não há nada a adicionar: a tela de convite faz parte de todo projeto novo e aparece sempre no lobby.
Passo 02Configure no painel
Abra o painel, escolha seu projeto e vá em Operações ao vivo → v2 → Indicação.
- Ative os convites: eles vêm desligados por padrão.
- Defina o presente do novato e as recompensas por 1, 3, 5 ou mais amigos.
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
Os convites funcionam por meio de client.referral no @idosgames/core.
// O código e o estado de convites do jogador, depois o código de um amigo vindo de um novato
await client.referral.getUserState()
const res = await client.referral.activateReferralCode('KD7QPX2M') // o link inteiro também funciona
if (!res.ok) return showError(res.error)
await client.referral.claimInviteRewardsBatch(['friends_1', 'friends_3'])activateReferralCodeaceita só o código ou o link inteiro que o jogador colou.- Recolha todas as recompensas prontas de uma vez com
claimInviteRewardsBatch.
Todos os campos estão descritos na habilidade referral-system, servida pelo servidor MCP do SDK.
Perguntas frequentes
Por que a tela de convite diz que os convites estão desligados?
Os convites vêm desligados por padrão. Ative-os na seção Indicação do painel.
Um novato pode digitar o código depois?
Sim, uma vez: a janela do código paga o presente do novato uma única vez.
Veja também
- Amigos no seu jogo: pedidos, sugestões e novidadesComo funciona o sistema de amigos pronto do iDos Games: uma lista de amigos, pedidos, sugestões de jogadores ativos, uma caixa de novidades, adicionar por ID e amigos do idosgames.com, e onde configurá-lo.
- Correio no jogo: cartas, recompensas e presentesComo 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.
- Recompensas diárias de login: um calendário para voltarComo funcionam as recompensas diárias prontas do iDos Games: um calendário de login com um grande prêmio no último dia, que abre sozinho enquanto há recompensa à espera, e como configurá-lo 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.