Pacote de Missões

O pacote de recursos Missões oferece funcionalidade fora da caixa para criar missões que os jogadores podem concluir para obter recompensas e progresso em sua experiência.Todas as missões devem ter um ID, categoria e uma lista de tarefas que os jogadores devem concluir para terminar a missão.No entanto, a lista de tarefas pode estar vazia, permitindo que as recompensas da missão sejam reivindicadas imediatamente.

Usando as opções de personalização do pacote, você pode personalizar todas as missões para atender aos seus requisitos de jogabilidade únicos, como:

• Criar missões que embarquem novos jogadores em sua experiência e melhorem a retenção D1.
• Alcançando retenção de D7 e D30 adicionando metas de médio a longo prazo e um senso de progresso.
• Aumentar engajamento aumentando ao expor os vários sistemas em seu jogo e recompensando os jogadores por interagirem com eles.

Obtenha o pacote

A Loja do Criador é uma aba da Caixa de Ferramentas que você pode usar para encontrar todos os recursos que são feitos por Roblox e a comunidade Roblox para uso dentro de seus projetos, incluindo modelo, imagem, malha, áudio, plugin, vídeo e fontes.Você pode usar a Loja do Criador para adicionar um ou mais recursos diretamente em uma experiência aberta, incluindo pacotes de recursos!

Cada pacote de recursos requer que o pacote de recursos Núcleo funcione corretamente.Uma vez que os recursos do pacote de recursos Núcleo e Missões estejam dentro do seu inventário, você pode reutilizá-los em qualquer projeto na plataforma.

Para obter os pacotes do seu inventário para a sua experiência:

1. Adicione o Núcleo e Missões ao seu inventário dentro do Studio clicando no link Adicionar ao Inventário na seguinte série de componentes.

   Core Feature Package

   The Core feature package offers shared data store logic for all feature packages.

   Missions Feature Package

   The Missions Feature Package offers functionality to create missions that players can complete to achieve rewards and progress in your experience.

2. Na barra de ferramentas, selecione a aba Ver.

3. Clique em Caixa de Ferramentas . A janela Caixa de Ferramentas é exibida.

   

4. Na janela da Caixa de ferramentas , clique na aba Inventário . Os displays de Meus modelos são classificados.

   

5. Clique no mosaico tijolode Recursos de Destino, então no mosaico tijolode Recursos de Missão.Ambas as pastas de pacote são exibidas na janela Explorer .

6. Arraste as pastas do pacote para Armazenamento Replicado .

Definir missões

Cada missão completável inclui um conjunto de tarefas que devem ser concluídas para completar a missão, opções de configuração e metadados de exibição opcionais, todos os quais podem ser definidos dentro de ReplicatedStorage.Missions.Configs.Missions , com tipos exportados do script Types na mesma pasta.

Campos obrigatórios

Os seguintes campos são necessários para cada missão.

Desbloquear condições

Por padrão, as missões são desbloqueadas para os jogadores automaticamente e podem ser concluídas exatamente uma vez.No entanto, você pode usar as seguintes opções de configuração opcionais para alterar esse comportamento.

Metadados

Missões têm metadados que especificam como elas serão exibidas na interface do usuário de Missões.Você pode usar os seguintes opcionais campos para personalizar seu metadado.

Defina tarefas

Cada missão pode ter zero ou mais tarefas.Se uma missão tiver zero tarefas, ela pode ser reivindicada imediatamente após ser desbloqueada; se uma missão tiver uma ou mais tarefas, uma vez que as tarefas sejam concluídas, o jogador pode coletar quaisquer recompensas associadas à missão.Cada tarefa tem um taskId, que é a chave associada à tarefa para uma missão dada.

As tarefas vêm em dois tipos:

• Tarefas Cronometradas - Permite que você inicie e pare a tarefa em diferentes pontos no tempo.Um certo período de tempo deve passar enquanto o cronômetro da tarefa está em execução, então a tarefa está concluída.
• Contar tarefas - Permite que você adicione ou defina o progresso da tarefa. Quando o progresso chegar a um valor definido, a tarefa estará concluída.

Ambos os tipos de tarefa compartilham os seguintes campos:

Contar campos de tarefas

As tarefas contam têm um valor necessário. Quando o progresso da tarefa atinge esse valor, a tarefa está concluída.

Campos de tarefas de tempo

As tarefas de tempo têm uma quantidade alvo de tempo gasto e são iniciadas e interrompidas. Quando a quantidade alvo de tempo é atingida, a tarefa é concluída.

Configurar categorias

As categorias não precisam ser definidas explicitamente para serem usadas, pois a categoria para uma missão tem valores padrão que serão usados.No entanto, você pode configurar esses valores em ReplicatedStorage.Missions.Configs.Categories para adicionar efeitos adicionais à categoria.Categorias são identificadas por únicas CategoryIds, as mesmas referenciadas na configuração das missões.

Integar lógica do servidor

Dê uma olhada em ReplicatedStorage.Missions.Server.Examples.MissionsExample, que mostra como o seu servidor interagirá com o pacote de recursos Missões .

Você precisa principalmente conectar quatro coisas uma vez que arrasta o pacote de recursos Missões para sua experiência:

1. Defina missões na sua configuração de missões.

2. Adicione lógica à sua experiência para atualizar o progresso da tarefa ou os contadores a que o progresso está vinculado.

   LEIAME
   -- Aumenta o progresso em uma missão Pular com uma tarefa de Pulos
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- Inicia o cronômetro em uma missão BattlingTime com uma tarefa TimeInBattle
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Para o cronômetro em uma missão BattlingTime com uma tarefa TimeInBattle
   Missions.stopTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Aumenta o progresso em todas as tarefas vinculadas ao contador de Saltos
   CounterSystem.addCounter(player, "Jumps", 1)
   
   -- Inicia o cronômetro em todas as tarefas agendadas vinculadas ao contador de tempo do TimeInBattle
   CounterSystem.startTimer(player, "TimeInBattle")
   
   -- Para o cronômetro em todas as tarefas agendadas vinculadas ao contador de tempo do TimeInBattle
   CounterSystem.stopTimer(player, "TimeInBattle")

3. Defina os manipuladores de conclusão de missão e, opcionalmente, desbloqueie ou falhe os manipuladores.Use o manipulador de conclusão para conceder as recompensas da missão em sua experiência.

   LEIAME
   local function completeHandler(player: Player, missionId: Types.MissionId)
        print(`{player} completed mission {missionId}`)
        -- Dê ao jogador suas recompensas.
    end
   
   Missions.setCompletionHandler(missionId, completeHandler)

4. Desbloqueie missões que não são desbloqueadas automaticamente.A lógica do pacote de recursos de Missões garante que todos os requisitos de missão sejam atendidos antes que a missão seja concluída e suas recompensas sejam colecionáveis.

   LEIAME
   Missions.unlockMission(player, "Manual")

Configurar constantes

Constantes para o pacote de recursos Núcleo vivem em dois locais:

• Constantes compartilhadas vivem em ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants .

• Constantes específicas do pacote, neste caso o pacote de recursos Missões, vive em .

Além disso, você pode encontrar strings para tradução divididas em um local: ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings .

Personalizar componentes de UI

Ao modificar os objetos do pacote, como cores, fontes e transparência, você pode ajustar a apresentação visual da sua interface de missões.Por exemplo, em ReplicatedStorage.Missions.Configs.Constants , você pode habilitar SingleTaskMode a exibir uma barra de progresso para uma tarefa diretamente na própria missão para missões que só têm uma única tarefa.

Além disso, se a sua experiência já possui uma interface existente que você gostaria de integrar com o pacote de recursos Missões, o cliente contém todas as funções necessárias para obter as informações sobre as missões de um jogador enviadas do servidor.