Sistemas de jogo

Tutoriais de boas-vindas: um tour pelas telas reais

Como funcionam os tutoriais prontos do iDos Games: fluxos de boas-vindas que destacam qualquer elemento do jogo, uma dica com Próximo e Pular, passos que esperam uma ação real, uma recompensa e um funil, e como configurá-los no painel.

Os tutoriais são fluxos de boas-vindas sobre as telas reais do jogo: cada passo destaca um elemento, escurece o resto e mostra uma dica. Um passo pode esperar a ação real do jogador, e cada passo exibido entra no funil, então você vê onde os jogadores novos desistem.

O que o jogador vê

  • O elemento destacado de qualquer tela com o resto escurecido; o destaque acompanha o elemento quando o layout muda.
  • Um balão de dica com "Próximo" nos passos que o jogador fecha e "Pular" quando o fluxo permite.
  • Passos que esperam uma ação real: a dica fica até o jogador fazê-la no jogo.
  • A recompensa no fim do fluxo e a lista "Tutoriais" para rever os fluxos permitidos.
Lobby
12 450
320
Loja
Rankings
Jogar
Passo 3 de 5

Toque em “Jogar” para começar sua primeira rodada!

Pular
Próximo
Recompensa do tour: 50 gemas
O passo destaca qualquer elemento de qualquer tela; o resto escurece.
Um balão de dica com “Próximo” e “Pular” quando o fluxo permite.
Uma recompensa no final; cada passo mostrado vai para o funil.
Exemplo. Um passo de tutorial sobre o lobby: um botão destacado e uma dica.

Como funciona

  • Um passo aponta para um elemento pela âncora: data-tutorial-anchor em qualquer elemento de qualquer módulo.
  • Os fluxos podem começar sozinhos quando o título define, por exemplo na primeira visita.
  • Cada passo exibido é registrado, o que gera o funil de boas-vindas nas análises do painel.

Passo 01Adicione o sistema ao seu projeto

Peça ao programador de IA: "Adicione um tour de boas-vindas pelo lobby". Ele instala o sistema pronto com um tour de cinco passos e uma recompensa em gemas.

Passo 02Configure no painel

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

  • Crie um fluxo: seus passos, a âncora de cada passo e o texto da dica.
  • Escolha como um passo termina: o jogador o fecha, ou uma ação real no jogo.
  • Defina quando o fluxo começa, se pode ser pulado ou revisto, e a recompensa.

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 tutoriais funcionam por meio de client.tutorial no @idosgames/core; a sobreposição encontra os elementos pelas âncoras.

TypeScript
// Qualquer elemento de qualquer módulo pode ser uma âncora de tutorial
<button data-tutorial-anchor="play:start">Play</button>
// As abas do lobby são tab:{featureID}, o botão de perfil é lobby:profile,
// o botão "Jogar" de um jogo é play:{modeID}
  • Marque os elementos para os quais um fluxo aponta; uma âncora sem elemento simplesmente espera até ele aparecer.
  • Os passos são registrados com reportStepShown e concluídos com completeStep: a sobreposição faz isso por você.

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

Perguntas frequentes

Um passo pode esperar uma ação real?

Sim. Um passo pode terminar em um evento do jogo em vez de "Próximo", e assim o jogador aprende fazendo.

Dá para ver onde os jogadores desistem?

Sim. Cada passo exibido é registrado, então o funil do fluxo mostra a desistência passo a passo.

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.