Pakiet misji

Pakiet funkcji Misje oferuje funkcjonalność out-of-the-box do tworzenia misji, które gracze mogą ukończyć, aby uzyskać nagrody i postęp w swoim doświadczeniu.Wszystkie misje muszą mieć identyfikator, kategoriai listę zadań, które gracze muszą ukończyć, aby ukończyć misję.Jednak lista zadań może być pusta, umożliwiając natychmiastowe odebranie nagród misji.

Wykorzystując opcje personalizacji pakietu, możesz dostosować wszystkie misje, aby spełnić swoje unikalne wymagania dotyczące rozgrywki, takie jak:

• Tworzenie misji, które włączają nowych graczy do swojego doświadczenia i poprawiają zatrzymanie D1.
• Celowanie w zatrzymanie D7 i D30 poprzez dodanie celów średnioterminowych i poczucia postępu.
• Zwiększanie zaangażowania poprzez wyświetlanie różnych systemów w grze i nagradzanie graczy za interakcję z nimi.

Zdobądź pakiet

Sklep Twórców jest zakładką Toolbox, którą możesz użyć, aby znaleźć wszystkie zasoby, które są tworzone przez Roblox i społeczność Roblox do użytku w twoich projektach, w tym modele, obrazy, siatki, dźwięki, wtyczki, wideo i czcionki.Możesz użyć sklepu dla twórców, aby dodać jeden lub więcej zasobów bezpośrednio do otwartego doświadczenia, w tym pakietów funkcji!

Każdy pakiet funkcji wymaga, aby pakiet funkcji Rdzeń działał prawidłowo.Gdy pakiet funkcji Rdzeń i Misje będzie już w twoim wyposażenie, możesz ponownie ich użyć w dowolnym projekcie na platforma.

Aby otrzymać pakiety z twojego zapasu do twojego doświadczenia:

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

   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. W pasku narzędzi wybierz zakładkę Widok.

3. Kliknij Pudełko narzędzi . Okno Pudełko narzędzi wyświetla się.

   

4. W oknie Pudełko z narzędziami , kliknij zakładkę Ekwipunek . Wyświetlają się sortowania Moje modele .

   

5. Kliknij pasek Pakiet podstawowy funkcji , a następnie pasek Pakiet funkcji misji .Oba foldery pakietowe wyświetlają się w oknie Eksploratora .

6. Przeciągnij foldery pakietowe do ReplicatedStorage .

Określ misje

Każda ukończalna misja obejmuje zestaw zadań, które muszą zostać zakończone, aby ukończyć misję, opcje konfiguracji i opcjonalne metadane wyświetlania, które wszystkie mogą być zdefiniowane w ReplicatedStorage.Missions.Configs.Missions , z typami eksportowanymi z kodu Types ze skryptu w tym samym folderze.

Wymagane pola

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

Odblokuj warunki

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

Opis metadanych

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ć jego metadane.

Określ zadania

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

Zadania występują w dwóch typach:

• Zadania czasowe - Pozwala ci rozpocząć i zatrzymać zadanie w różnych punktach w czasie.Musi upłynąć pewna ilość czasu, gdy czasomierz zadania jest uruchomiony, a zadanie jest zakończone.
• Licz zadania - Pozwala dodawać lub ustawiać postęp zadania. Gdy postęp osiągnie określoną wartość, zadanie jest ukończone.

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

Licz pola zadań

Liczba zadań ma wymaganą wartość. Gdy postęp zadania spełnia tę kwotę, zadanie jest ukończone.

Pola zadań czasowych

Zadania czasowe mają określoną ilość czasu spędzonego i są uruchamiane i zatrzymywane. Gdy osiągnięta zostanie określona ilość czasu, zadanie jest zakończone.

Konfiguruj kategorie

Kategorie nie muszą być wyraźnie zdefiniowane, aby były używane, ponieważ kategoria dla misji ma domyślne wartości, które zostaną użyte.Jednak możesz skonfigurować te wartości w ReplicatedStorage.Missions.Configs.Categories , aby dodać dodatkowe efekty do kategorii.Kategorie są oznaczane unikalnym CategoryIds, tymi samymi, które są odwołane w konfiguracji misji.

Zintegruj logikę serwera

Spójrz na ReplicatedStorage.Missions.Server.Examples.MissionsExample, który pokazuje, w jaki sposób twój serwer będzie interakcjonował z pakietem funkcji Misje .

Głównie musisz podłączyć cztery rzeczy po przeciągnięciu pakietu funkcji Misje do swojego doświadczenia:

1. Określ misje w konfiguracji misji.

2. Dodaj logikę do swojego doświadczenia, aby zaktualizować postęp zadania lub liczniki, do których jest powiązany postęp.

   Przeczytaj README
   -- Zwiększenie postępu w misji Skoku z zadaniem skoku
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- Rozpoczyna minutnik w misji BattlingTime za pomocą zadania TimeInBattle
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Zatrzymuje minutnik w czasie misji BattlingTime za pomocą zadania TimeInBattle
   Missions.stopTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Zwiększa postęp we wszystkich zadaniach powiązanych z kontrofertaskoków
   CounterSystem.addCounter(player, "Jumps", 1)
   
   -- Rozpoczyna zegar na wszystkich zadaniach czasowych powiązanych z licznikiem czasu w kontroferta
   CounterSystem.startTimer(player, "TimeInBattle")
   
   -- Zatrzymuje czasomierz na wszystkich zadaniach czasowych powiązanych z licznikiem czasu w trybie kontroferta
   CounterSystem.stopTimer(player, "TimeInBattle")

3. Ustaw końcówki ukończenia misji i opcjonalnie odblokuj lub nie powiodą się końcówki.Użyj kompletora, aby przyznać nagrody z misji w swoim doświadczeniu.

   Przeczytaj README
   local function completeHandler(player: Player, missionId: Types.MissionId)
        print(`{player} completed mission {missionId}`)
        -- Nagradzaj graczy ich nagrodami.
    end
   
   Missions.setCompletionHandler(missionId, completeHandler)

4. Odblokuj misje, które nie są odblokowane automatycznie.Logika pakietu funkcji Misje zapewnia, że wszystkie wymagania misji zostaną spełnione przed ukończeniem misji i jej nagrody będą przedmiot kolekcjonerski.

   Przeczytaj README
   Missions.unlockMission(player, "Manual")

Konfiguruj stałe

Stałe dla pakietu funkcji Rdzenia żyją w dwóch miejscach:

• Wspólne konstytucje żyją w ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants .

• Konstytucje pakietowe, w tym przypadku pakiet funkcji Misje , żyją w ReplicatedStorage.Missions.Configs.Constants .

Ponadto możesz znaleźć struny do tłumaczenia rozdzielone w jednym miejscu: ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings .

Dostosuj komponenty interfejsu

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

Ponadto, jeśli twoje doświadczenie ma już istniejący interfejs, z którym chcesz się zintegrować z pakietem funkcji Misje, klient zawiera wszystkie funkcje niezbędne do uzyskania informacji o misjach gracza wysyłanych z serwera.