Pacchetto missioni

Il pacchetto di funzionalità Missioni offre funzionalità out-of-the-box per creare missioni che i giocatori possono completare per ottenere ricompense e progresso nella tua esperienza.Tutte le missioni devono avere un ID, una categoria e un elenco di compiti che i giocatori devono completare per terminare la missione.Tuttavia, l'elenco delle attività può essere vuoto, consentendo di richiedere immediatamente le ricompense della missione.

Usando le opzioni di personalizzazione del pacchetto, puoi personalizzare tutte le missioni per soddisfare i tuoi requisiti di gioco unici, come:

• Creazione di missioni che a bordo nuovi giocatori nella tua esperienza e migliorare la ritenzione di D1.
• Mirare a mantenimento di D7 e D30 aggiungendo obiettivi a medio e lungo termine e un senso di progresso.
• Aumentare l'impegno aumentando la superficie dei vari sistemi nel tuo gioco e ricompensando i giocatori per l'interazione con essi.

Ottieni il pacchetto

Il Creator Store è una scheda della Toolbox che puoi utilizzare per trovare tutte le risorse create da Roblox e dalla comunità Roblox per l'uso all'interno dei tuoi progetti, tra cui modello, immagine, Mesh, maglia, audio/suono, Collegare, video e font.Puoi usare il Creator Store per aggiungere uno o più asset direttamente in un'esperienza aperta, inclusi i pacchetti delle funzionalità!

Ogni pacchetto delle funzionalità richiede che il pacchetto delle funzionalità Core funzioni correttamente.Una volta che le risorse del pacchetto Nucleo e Missioni sono all'interno del tuo Inventario, reportorio, puoi riutilizzarle in qualsiasi progetto sulla Piattaforma.

Per ottenere i pacchetti dal tuo inventario nella tua esperienza:

1. Aggiungi il Nucleo e Missioni al tuo inventario all'interno di Studio facendo clic sul link Aggiungi all'inventario nel seguente set di componenti.

   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. Nella barra degli strumenti, seleziona la scheda Visualizza.

3. Fai clic su Toolbox . La finestra Toolbox viene visualizzata.

   

4. Nella finestra Toolbox , fai clic sulla scheda Inventario . Le visualizzazioni di Modelli miei sono ordinate.

   

5. Fai clic sul Piastrella Feature Package Core , quindi sul Piastrella Missions Feature Package .Entrambi i cartelletti del pacchetto vengono visualizzati nella finestra Explorer .

6. Trascina le cartelle del pacchetto in ReplicatedStorage .

Definire le missioni

Ogni missione completabile include un insieme di compiti che devono essere completati per completare la missione, le opzioni di configurazione e i metadati di visualizzazione opzionali, tutti i quali possono essere definiti entro ReplicatedStorage.Missions.Configs.Missions , con tipi esportati dallo script Types nella stessa cartella.

Campi richiesti

I seguenti campi sono richiesti per ogni missione.

Sblocca le condizioni

Per impostazione predefinita, le missioni sono sbloccate per i giocatori automaticamente e possono essere completate esattamente una volta.Tuttavia, puoi utilizzare le seguenti opzioni di configurazione opzionali per modificare questo comportamento.

Metadati

Le missioni hanno metadata che specificano come verranno visualizzate nell'interfaccia utente delle missioni.Puoi utilizzare i seguenti opzionali campi per personalizzare i suoi metadati.

Definire le attività

Ogni missione può avere zero o più compiti.Se una missione ha zero compiti, può essere reclamata immediatamente dopo essere stata sbloccata; se una missione ha uno o più compiti, una volta che i compiti sono completati, il giocatore può raccogliere qualsiasi ricompensa associata alla missione.Ogni attività ha un taskId, che è la chiave associata all'attività per una missione data.

Le attività si dividono in due tipi:

• Compiti temporali - Ti consente di avviare e interrompere il compito a punti diversi nel tempo.Deve trascorrere un certo periodo di tempo mentre il timer della task è in esecuzione, quindi la task è completata.
• Conta le attività - Ti consente di aggiungere o impostare il progresso dell'attività. Quando il progresso raggiunge un valore impostato, l'attività è completata.

Entrambi i tipi di compito condividono i seguenti campi:

Conta i campi delle attività

Le attività di conteggio hanno un valore richiesto. Quando il progresso del compito soddisfa questa quantità, il compito è completo.

Campi delle attività del tempo

Le attività temporali hanno un tempo target di spesa e vengono avviate e interrotte. Quando viene raggiunta la quantità target di tempo, l'attività è completata.

Configurare le categorie

Le categorie non devono essere definiti esplicitamente per essere utilizzati, poiché la categoria per una missione ha valori predefiniti che verranno utilizzati.Tuttavia, puoi configurare questi valori in ReplicatedStorage.Missions.Configs.Categories per aggiungere effetti aggiuntivi alla categoria.Le categorie sono identificate da uniche CategoryIds , le stesse citate nella configurazione delle missioni.

Integrare la logica del server

Dai un'occhiata a ReplicatedStorage.Missions.Server.Examples.MissionsExample, che mostra come il tuo server interagirà con il pacchetto funzionalità Missioni .

Devi principalmente collegare quattro cose una volta dopo aver trascinato il pacchetto funzione Missioni nella tua esperienza:

1. Definisci le missioni nella configurazione delle tue missioni.

2. Aggiungi logica alla tua esperienza per aggiornare i progressi delle attività o i contatori ai quali sono legati i progressi.

   LEGGIME
   -- Aumenta i progressi su una missione di Salto con un compito di Salto
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- Avvia il timer su una missione BattlingTime con un compito TimeInBattle
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Ferma il timer su una missione BattlingTime con un compito TimeInBattle
   Missions.stopTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Aumenta il progresso su tutti i compiti legati al contapassi dei salti
   CounterSystem.addCounter(player, "Jumps", 1)
   
   -- Avvia il timer su tutti i compiti temporali legati al contapassi TimeInBattle
   CounterSystem.startTimer(player, "TimeInBattle")
   
   -- Ferma il timer su tutte le attività programmate legate al contapassi TimeInBattle
   CounterSystem.stopTimer(player, "TimeInBattle")

3. Imposta i completatori della missione e, opzionalmente, sblocca o fallisce i completatori.Usa il completamento del handler per assegnare le ricompense dalla missione nella tua esperienza.

   LEGGIME
   local function completeHandler(player: Player, missionId: Types.MissionId)
        print(`{player} completed mission {missionId}`)
        -- Assegna al giocatore le sue ricompense.
    end
   
   Missions.setCompletionHandler(missionId, completeHandler)

4. Sblocca missioni che non vengono sbloccate automaticamente.La logica del pacchetto delle missioni garantisce che tutti i requisiti delle missioni siano soddisfatti prima che la missione sia completata e le sue ricompense siano Collezionabile.

   LEGGIME
   Missions.unlockMission(player, "Manual")

Configura le costanti

Le costanti per il pacchetto funzionale Core sono live in due punti:

• Le costanti condivise vivono in ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants .

• Costanti specifiche del pacchetto, in questo caso il pacchetto funzione Missioni , vive in ReplicatedStorage.Missions.Configs.Constants .

Inoltre, puoi trovare stringhe per la traduzione divise in una posizione: ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings .

Personalizza componenti dell'interfaccia utente

Modificando gli oggetti del pacchetto, come colori, caratteri e trasparenza, puoi regolare la presentazione visiva della tua interfaccia utente delle missioni.Ad esempio, in ReplicatedStorage.Missions.Configs.Constants , puoi abilitare SingleTaskMode a visualizzare una barra di progresso per una task direttamente sulla missione stessa per le missioni che hanno solo una singola task.

Inoltre, se la tua esperienza ha già un'interfaccia utente esistente che vorresti integrare con il pacchetto funzioni Missioni, il cliente > contiene tutte le funzioni necessarie per ottenere le informazioni sulle missioni di un Giocatoreinviate dal Server.