Pakiet misji

Pakiet funkcji Misje oferuje gotową funkcjonalność do tworzenia misji, które gracze mogą ukończyć, aby zdobyć nagrody i postępować w swojej grze. Wszystkie misje muszą mieć identyfikator, kategorię i listę zadań, które gracze muszą wykonać, aby zakończyć misję. Jednak lista zadań może być pusta, co pozwala na natychmiastowe odebranie nagród za misję.

Korzystając z opcji dostosowywania pakietu, możesz spersonalizować wszystkie misje, aby spełniały Twoje unikalne wymagania dotyczące rozgrywki, takie jak:

• Tworzenie misji, które wprowadzają nowych graczy do Twojej gry i poprawiają retencję D1.
• Celowanie w retencję D7 i D30 poprzez dodawanie celów średnio- i długoterminowych oraz poczucia postępu.
• Zwiększanie zaangażowania poprzez ujawnianie różnych systemów w Twojej grze i nagradzanie graczy za interakcję z nimi.

Pobierz pakiet

Sklep Twórcy to zakładka w Narzędziu, której możesz użyć do znalezienia wszystkich zasobów stworzonych przez Roblox i społeczność Roblox do wykorzystania w Twoich projektach, w tym modele, obrazy, siatki, dźwięki, wtyczki, filmy i czcionki. Możesz użyć Sklepu Twórcy, aby dodać jeden lub więcej zasobów bezpośrednio do otwartej gry, w tym pakiety funkcji!

Każdy pakiet funkcji wymaga pakietu funkcji Core, aby działał poprawnie. Gdy zasoby pakietu Core i Misje znajdują się w Twoim inwentarzu, możesz je ponownie wykorzystać w dowolnym projekcie na platformie.

Aby przenieść pakiety z inwentarza do gry:

1. Dodaj Core i Misje do swojego inwentarza w Studio, klikając link Dodaj do inwentarza w następującym zestawie komponentów.

   Pakiet funkcji Core

   Pakiet funkcji Core oferuje wspólną logikę przechowywania danych dla wszystkich pakietów funkcji.

   Dodaj do wyposażenia

   Pakiet funkcji Misje

   Pakiet funkcji Misje oferuje funkcjonalność do tworzenia misji, które gracze mogą ukończyć, aby zdobyć nagrody i postępować w swojej grze.

   Dodaj do wyposażenia

2. Z menu Okno w Studio lub z paska narzędzi zakładki Strona główna, otwórz Narzędzie.

3. W oknie Narzędzie kliknij zakładkę Inwentarz. Wyświetli się sortowanie Moje modele.

   

4. Kliknij kafelek Pakiet funkcji Core, a następnie kafelek Pakiet funkcji Misje. Oba foldery pakietów wyświetlą się w oknie Eksplorator.

5. Przeciągnij foldery pakietów do ReplicatedStorage.

Zdefiniuj misje

Każda misja do ukończenia zawiera zestaw zadań, które muszą być zakończone, aby ukończyć misję, opcje konfiguracyjne oraz opcjonalne metadane wyświetlania, które można zdefiniować w ReplicatedStorage.Missions.Configs.Missions, z typami eksportowanymi z skryptu Types w tym samym folderze.

Wymagane pola

Poniższe pola są wymagane dla każdej misji.

Warunki odblokowania

Domyślnie misje są automatycznie odblokowywane dla graczy i mogą być ukończone dokładnie raz. Możesz jednak użyć następujących opcjonalnych opcji konfiguracyjnych, aby zmienić to zachowanie.

Metadane

Misje mają metadane, które określają, jak będą wyświetlane w interfejsie użytkownika Misji. Możesz użyć następujących opcjonalnych pól, aby dostosować ich metadane.

Zdefiniuj zadania

Każda misja może mieć zero lub więcej zadań. Jeśli misja ma zero zadań, można ją odebrać natychmiast po odblokowaniu; jeśli misja ma jedno lub więcej zadań, po ich ukończeniu gracz może odebrać wszelkie nagrody związane z misją. Każde zadanie ma taskId, który jest kluczem związanym z zadaniem dla danej misji.

Zadania występują w dwóch typach:

• Zadania czasowe - Pozwalają na rozpoczęcie i zatrzymanie zadania w różnych momentach czasowych. Musi upłynąć określona ilość czasu, podczas gdy zegar zadania działa, a następnie zadanie jest ukończone.
• Zadania liczbowe - Pozwalają na dodawanie lub ustawianie postępu zadania. Gdy postęp osiągnie ustaloną wartość, zadanie jest ukończone.

Oba typy zadań mają następujące pola:

Pola zadań liczbowych

Zadania liczbowe mają wymaganą wartość. Gdy postęp zadania osiągnie tę wartość, zadanie jest ukończone.

Pola zadań czasowych

Zadania czasowe mają docelową ilość czasu spędzonego, a także są uruchamiane i zatrzymywane. Gdy docelowa ilość czasu zostanie osiągnięta, zadanie jest ukończone.

Skonfiguruj kategorie

Kategorie nie muszą być wyraźnie definiowane, aby mogły być używane, ponieważ kategoria dla misji ma domyślne wartości, które będą używane. Możesz jednak skonfigurować te wartości w ReplicatedStorage.Missions.Configs.Categories, aby dodać dodatkowe efekty do kategorii. Kategorie są identyfikowane przez unikalne CategoryIds, te same, które są odniesione w konfiguracji misji.

Zintegruj logikę serwera

Zobacz ReplicatedStorage.Missions.Server.Examples.MissionsExample, który pokazuje, jak Twój serwer będzie współdziałał z pakietem funkcji Misje.

Musisz głównie podłączyć cztery rzeczy po przeciągnięciu pakietu funkcji Misje do swojej gry:

1. Zdefiniuj misje w swojej konfiguracji misji.

2. Dodaj logikę do swojej gry, aby zaktualizować postęp zadań lub liczniki, do których postęp jest powiązany.

   README

   -- Zwiększa postęp w misji Skakanie z zadaniem Skoki
   Missions.addProgressToTask(player, "Skakanie", "Skoki", 1)
   
   -- Rozpoczyna zegar w misji CzasWalka z zadaniem CzasWBitwie
   Missions.startTimedTask(player, "CzasWalka", "CzasWBitwie")
   
   -- Zatrzymuje zegar w misji CzasWalka z zadaniem CzasWBitwie
   Missions.stopTimedTask(player, "CzasWalka", "CzasWBitwie")
   
   -- Zwiększa postęp we wszystkich zadaniach powiązanych z licznikiem Skoki
   CounterSystem.addCounter(player, "Skoki", 1)
   
   -- Rozpoczyna zegar we wszystkich zadaniach czasowych powiązanych z licznikiem CzasWBitwie
   CounterSystem.startTimer(player, "CzasWBitwie")
   
   -- Zatrzymuje zegar we wszystkich zadaniach czasowych powiązanych z licznikiem CzasWBitwie
   CounterSystem.stopTimer(player, "CzasWBitwie")

3. Ustaw obsługiwacze ukończenia misji, a opcjonalnie obsługiwacze odblokowania lub niepowodzenia. Użyj obsługiwacza ukończenia, aby nagrodzić nagrody z misji w swojej grze.

   README

   local function completeHandler(player: Player, missionId: Types.MissionId)
        print(`{player} ukończył misję {missionId}`)
        -- Nagradzaj gracza jego nagrodami.
    end
   
   Missions.setCompletionHandler(missionId, completeHandler)

4. Odblokuj misje, które nie są odblokowywane automatycznie. Logika pakietu funkcji Misje zapewnia, że wszystkie wymagania misji są spełnione przed ukończeniem misji, a jej nagrody są do odebrania.

   README

   Missions.unlockMission(player, "Ręczne")

Skonfiguruj stałe

Stałe dla pakietu funkcji Core znajdują się w dwóch miejscach:

• Wspólne stałe znajdują się w ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants.

• Stałe specyficzne dla pakietu, w tym przypadku pakietu funkcji Misje, znajdują się w ReplicatedStorage.Missions.Configs.Constants.

Dodatkowo możesz znaleźć ciągi do tłumaczenia rozdzielone w jednym miejscu: ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings.

Dostosuj komponenty UI

Poprzez modyfikację obiektów pakietu, takich jak kolory, czcionka i przezroczystość, możesz dostosować wizualną prezentację interfejsu użytkownika misji. Na przykład w ReplicatedStorage.Missions.Configs.Constants możesz włączyć SingleTaskMode, aby wyświetlić pasek postępu dla zadania bezpośrednio na misji dla misji, które mają tylko jedno zadanie.

Dodatkowo, jeśli Twoja gra już ma istniejący interfejs użytkownika, który chciałbyś zintegrować z pakietem funkcji Misje, klient ModuleScript MissionsClient zawiera wszystkie funkcje niezbędne do przesyłania informacji o misjach gracza z serwera.