As missões são um sistema de tarefas pronto: missões diárias, semanais e únicas com recompensas, uma trilha de pontos com baús e um bônus por concluir um grupo de tarefas. As missões fazem parte de todo projeto novo. O servidor conta o progresso e as recompensas; o jogo só informa o que o jogador fez e mostra o resultado.
O que o jogador vê
- Ciclos em abas: diárias, semanais, conquistas, com o tempo até o próximo ciclo.
- Barras de progresso em cada tarefa e uma janela de detalhes com todos os objetivos.
- Um botão "Pegar tudo" para as tarefas concluídas.
- Uma trilha de pontos com baús que abrem conforme os pontos se acumulam.
- Um selo na aba quando há tarefas concluídas à espera.
Como as missões são montadas
- Ciclo: um conjunto de tarefas com cronograma: diário, semanal, permanente ou um evento temporário. Um ciclo pode correr em fases, uma após a outra, por exemplo uma temporada de oito semanas, cada semana com suas tarefas e sua trilha de pontos.
- Missão: um ou mais objetivos, cada um com seu contador ("derrotar 20 monstros"), e uma recompensa. Uma missão pode exigir que outra seja concluída antes: é assim que se montam sequências.
Há três tipos de recompensa, e todos funcionam ao mesmo tempo:
- Recompensa da missão: quando todos os objetivos são cumpridos.
- Baús na trilha de pontos: uma missão recolhida soma pontos do ciclo, e um baú abre no total necessário.
- Bônus de grupo: quando um número definido de missões de um grupo é concluído.
De onde vem o progresso
| Fonte | Exemplo | O que você precisa fazer |
|---|---|---|
| O jogo informa | Um monstro derrotado, uma fase vencida | Uma linha de código onde isso acontece |
| O servidor conta | Uma compra na loja, outra missão recolhida | Nada, só escolher o evento |
| Um script no servidor | Sua própria regra no cloud code | Uma chamada a partir do script |
Passo 01Crie um ciclo
Abra o painel, escolha seu projeto e vá em Operações ao vivo → v2 → Missão. Na aba Ciclos, crie um ciclo, por exemplo diário, e adicione uma trilha de pontos com baús se quiser.
Passo 02Adicione tarefas
Na aba Missões, crie uma missão: nome, ciclo, objetivos e recompensa. Para cada objetivo, escolha de onde vem o
progresso. Se for o jogo que conta, escolha um nome de contador, por exemplo monsters_defeated.
O botão IA da página abre um assistente: "Crie três missões diárias: por vitórias, por compras na loja e por melhorias de herói". Ele propõe as mudanças, e você revisa e aperta Salvar.
Passo 03Ensine o jogo a informar o progresso
Para os objetivos que o jogo conta, peça ao programador de IA: "Conte monsters_defeated toda vez que um monstro for derrotado". Ele coloca a chamada no lugar certo do código. O modelo de RPG idle já informa as fases vencidas e as melhorias de herói.
Para desenvolvedores
As missões funcionam por meio de client.quest no @idosgames/core. O progresso é enviado pelo nome do contador, não
por missão: o servidor o repassa a todas as tarefas ativas que escutam aquele contador.
// Onde acontece: um monstro foi derrotado
await client.quest.addQuestProgress('monsters_defeated', 1)
// A tela de missões: o progresso do jogador; os ciclos avançam sozinhos
const state = await client.quest.getUserQuestState()
// Recolher a recompensa de uma missão concluída
const claim = await client.quest.claimQuestReward('daily_win_20', 'daily')
if (!claim.ok) return showError(claim.error)addQuestProgresssó move objetivos cuja fonte é o jogo. Objetivos que o servidor conta sozinho são recusados.- Nunca envie um valor "por garantia": se um objetivo tem um máximo por chamada, ultrapassá-lo bane a conta do jogador.
- As recompensas concedidas já são aplicadas aos saldos no cache do SDK; não é preciso recarregá-los.
Todos os campos estão descritos na habilidade quest-system, servida pelo servidor MCP do SDK.
Perguntas frequentes
Preciso adicionar missões ao meu projeto?
Não. As missões fazem parte de todo projeto novo. A aba de missões aparece para os jogadores assim que pelo menos uma missão é configurada no painel.
Como o jogo sabe que uma tarefa foi concluída?
O servidor conta o progresso. Algumas tarefas ele conta sozinho (compras, outras missões); sobre ações dentro do jogo, como derrotar um monstro, o jogo avisa o servidor com uma linha de código.
Posso fazer um passe de batalha?
A trilha de pontos de um ciclo oferece uma mecânica parecida. Cada missão recolhida soma pontos, e a trilha tem baús que abrem quando o jogador chega aos pontos necessários.
Veja também
- Loja no jogo: vitrines, ofertas e preçosComo funciona a loja pronta do iDos Games: vitrines com ofertas que se revezam, preços em moeda do jogo ou dinheiro de verdade, presentes grátis e limites de compra, e como configurá-la no painel sem código.
- Ranking no jogo: classificação, rodadas e recompensasComo funciona o ranking pronto do iDos Games: placares com rodadas, recompensas por posição e por pontos, proteção contra pontuações infladas, e como configurá-lo no painel.
- O modelo de RPG idle: herói, ondas e chefesUm modelo pronto de RPG idle no iDos Games: o herói enfrenta sozinho ondas de monstros e chefes, o ouro se acumula mesmo com o jogador fora e os atributos são melhorados com ouro. O que vem dentro e como transformá-lo no seu jogo.
- O que vem em um projeto novoTodo projeto novo no iDos Games começa com login, um lobby e seis sistemas prontos; outros sistemas, como loja, rankings, eventos ou multijogador, entram quando o app precisa deles.
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.