Paquete de misiones

El paquete de funciones Misiones ofrece funcionalidad de la caja para crear misiones que los jugadores puedan completar para lograr recompensas y progreso en tu experiencia.Todas las misiones deben tener un ID, categoría y una lista de tareas que los jugadores deben completar para terminar la misión.Sin embargo, la lista de tareas puede estar vacía, permitiendo que las recompensas de la misión se reclamen inmediatamente.

Al usar las opciones de personalización del paquete, puedes personalizar todas las misiones para cumplir con tus requisitos únicos de juego, como:

• Crear misiones que a bordo de nuevos jugadores en tu experiencia y mejora la retención de D1.
• Apuntar a la retención de D7 y D30 agregando objetivos a medio y largo plazo y un sentido de progreso.
• Aumentar el compromiso al hacer visible los diversos sistemas en tu juego y recompensar a los jugadores por interactuar con ellos.

Obtener paquete

La tienda de creadores es una pestaña de la caja de herramientas que puedes usar para encontrar todos los recursos que se crean por Roblox y la comunidad de Roblox para su uso dentro de tus proyectos, incluidos aplicación de modelado, imágenes, mallas, sonido, audio, complemento, vídeo y fuentes.Puedes usar la Tienda de creadores para agregar uno o más recursos directamente a una experiencia abierta, incluidos paquetes de funciones!

Cada paquete de características requiere que el paquete de características Núcleo funcione correctamente.Una vez que los recursos del paquete de características Núcleo y Misiones estén dentro de tu inventario, puedes volver a utilizarlos en cualquier proyecto en la plataforma.

Para obtener los paquetes de su inventario en su experiencia:

1. Añade el Núcleo y Misiones a tu inventario dentro de Studio haciendo clic en el enlace Añadir al inventario de los siguientes 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. En la barra de herramientas, seleccione la pestaña Ver.

3. Haga clic en Caja de herramientas . Se muestra la ventana Caja de herramientas .

   

4. En la ventana Caja de herramientas , haga clic en la pestaña Inventario . Se muestran los ordenados Mis modelos .

   

5. Haga clic en el azulejo Núcleo del mosaicode características , luego en el azulejo mosaicode características de misiones .Ambas carpetas de paquete se muestran en la ventana Explorador .

6. Arrastra las carpetas del paquete a ReplicatedStorage .

Define misiones

Cada misión completable incluye un conjunto de tareas que deben terminar para completar la misión, opciones de configuración y metadatos de visualización opcionales, todos los cuales se pueden definir dentro de ReplicatedStorage.Missions.Configs.Missions , con tipos exportados del script Types en la misma carpeta.

Campos requeridos

Los siguientes campos son requeridos para cada misión.

Desbloquear condiciones

Por defecto, las misiones se desbloquean automáticamente para los jugadores y se pueden completar exactamente una vez.Sin embargo, puedes usar las siguientes opciones de configuración opcionales para alterar este comportamiento.

Metadatos

Las misiones tienen metadatos que especifican cómo se mostrarán en la interfaz de usuario de misiones.Puedes usar los siguientes campos opcionales opcionales para personalizar su metadato.

Definir tareas

Cada misión puede tener cero o más tareas.Si una misión tiene cero tareas, se puede reclamar inmediatamente después de que se desbloquee; si una misión tiene una o más tareas, una vez que las tareas estén completas, el jugador puede recoger cualquier recompensa asociada a la misión.Cada tarea tiene un taskId, que es la clave asociada con la tarea para una misión determinada.

Las tareas vienen en dos tipos:

• Tareas programadas - Te permite iniciar y detener la tarea en diferentes puntos en el tiempo.Debe pasar una cierta cantidad de tiempo mientras el temporizador de la tarea está en marcha, luego la tarea está completa.
• Contar tareas - Le permite agregar o establecer el progreso de la tarea. Cuando el progreso llega a un valor establecido, la tarea está completa.

Ambos tipos de tarea comparten los siguientes campos:

Contar campos de tareas

Los contadores de tareas tienen un valor requerido. Cuando el progreso de la tarea llega a esta cantidad, la tarea se completa.

Campos de tareas de tiempo

Las tareas de tiempo tienen una cantidad objetivo de tiempo gastado, y se inician y se detienen. Cuando se cumple la cantidad objetivo de tiempo, la tarea se completa.

Configurar categorías

Las categorías no tienen que ser definidas explícitamente para ser utilizadas, ya que la categoría para una misión tiene valores predeterminados que se utilizarán.Sin embargo, puedes configurar estos valores en ReplicatedStorage.Missions.Configs.Categories para agregar efectos adicionales a la categoría.Las categorías se identifican por únicas CategoryIds, las mismas que se mencionan en la configuración de misiones.

Integrar lógica del servidor

Echa un vistazo a ReplicatedStorage.Missions.Server.Examples.MissionsExample, que muestra cómo interactuará tu servidor con el paquete de características Misiones .

Necesitas principalmente conectar cuatro cosas una vez que arrastres el paquete de características Misiones a tu experiencia:

1. Define misiones en tu configuración de misiones.

2. Añade lógica a tu experiencia para actualizar el progreso de la tarea o los contadores a los que está vinculado el progreso.

   LEERME
   -- Aumenta el progreso en una misión de salto con una tarea de saltos
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- Inicia el temporizador en una misión de tiempo de batalla con una tarea de TimeInBattle
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Detiene el temporizador en una misión de tiempo de batalla con una tarea de TimeInBattle
   Missions.stopTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Aumenta el progreso en todas las tareas vinculadas al contador de saltos
   CounterSystem.addCounter(player, "Jumps", 1)
   
   -- Inicia el temporizador en todas las tareas programadas vinculadas al contador de tiempo en contraoferta
   CounterSystem.startTimer(player, "TimeInBattle")
   
   -- Detiene el temporizador en todas las tareas programadas vinculadas al contador de tiempo en contraoferta
   CounterSystem.stopTimer(player, "TimeInBattle")

3. Establecer los gestores de finalización de misiones y, opcionalmente, desbloquear o fallar los gestores.Usa el handler de finalización para otorgar las recompensas de la misión en tu experiencia.

   LEERME
   local function completeHandler(player: Player, missionId: Types.MissionId)
        print(`{player} completed mission {missionId}`)
        -- Recompensa al jugador sus recompensas.
    end
   
   Missions.setCompletionHandler(missionId, completeHandler)

4. Desbloquea misiones que no se desbloquean automáticamente.La lógica del paquete de funciones Misiones garantiza que se cumplan todos los requisitos de misiones antes de que la misión esté completa y sus recompensas sean coleccionable.

   LEERME
   Missions.unlockMission(player, "Manual")

Configurar constantes

Las constantes para el paquete de características Núcleo viven en dos lugares:

• Las constantes compartidas viven en ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants .

• Las constantes específicas del paquete, en este caso el paquete de características Misiones , viven en ReplicatedStorage.Missions.Configs.Constants .

Además, puedes encontrar cadenas para la traducción separadas en una ubicación: ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings .

Personalizar componentes de UI

Al modificar los objetos del paquete, como colores, fuente y transparencia, puedes ajustar la presentación visual de la interfaz de usuario de tus misiones.Por ejemplo, en ReplicatedStorage.Missions.Configs.Constants , puedes habilitar SingleTaskMode para mostrar una barra de progreso para una tarea directamente en la misión para misiones que solo tienen una sola tarea.

Además, si tu experiencia ya tiene una interfaz de usuario existente con la que te gustaría integrarte con el paquete de características Misiones, el cliente contiene todas las funciones necesarias para obtener la información sobre las misiones de un jugador enviada desde el servidor.