Görevler paketi

Görevler özellik paketi, oyuncuların tamamlayabileceği görevler oluşturarak ödüller kazanmasını ve oyununuzda ilerlemesini sağlamak için hazır işlevsellik sunar. Tüm görevlerin bir ID'si, kategorisi ve oyuncuların görevi tamamlamak için tamamlaması gereken bir görev listesi olmalıdır. Ancak, görev listesi boş olabilir, bu da görevin ödüllerinin hemen alınabilmesini sağlar.

Paketin özelleştirme seçeneklerini kullanarak, tüm görevleri benzersiz oyun deneyimi gereksinimlerinizi karşılayacak şekilde kişiselleştirebilirsiniz, örneğin:

• Oyuncuları oyununuzda yeni başlayanlar için görevlere yönlendirmek ve D1 tutma oranını artırmak.
• Orta ve uzun vadeli hedefler ekleyerek D7 ve D30 tutma oranlarını hedeflemek ve bir ilerleme hissi yaratmak.
• Oyuncuların oyundaki çeşitli sistemlerle etkileşimde bulunmalarını ödüllendirerek katılımı artırmak.

Paketi alın

Yaratıcı Mağaza, projelerinizde kullanılmak üzere Roblox ve Roblox topluluğu tarafından oluşturulan tüm varlıkları bulmak için kullanabileceğiniz Araç Kutusu'nun bir sekmesidir; model, resim, ağ, ses, eklenti, video ve yazı tipi varlıkları dahil. Yaratıcı Mağaza'yı, açık bir oyuna bir veya daha fazla varlık eklemek için kullanabilirsiniz; bu, özellik paketlerini de içerir!

Her özellik paketi, düzgün çalışması için Çekirdek özellik paketini gerektirir. Çekirdek ve Görevler özellik paketi varlıkları envanterinize alındıktan sonra, bunları platformdaki herhangi bir projede yeniden kullanabilirsiniz.

Envanterinizdeki paketleri oyununuzda almak için:

1. Aşağıdaki bileşenler setinde Envantere Ekle bağlantısına tıklayarak Çekirdek ve Görevler'i Studio içinde envanterinize ekleyin.

   Çekirdek Özellik Paketi

   Çekirdek özellik paketi, tüm özellik paketleri için paylaşılan veri deposu mantığı sunar.

   Envantere ekle

   Görevler Özellik Paketi

   Görevler Özellik Paketi, oyuncuların tamamlayabileceği görevler oluşturma işlevselliği sunar.

   Envantere ekle

2. Studio'nun Pencere menüsünden veya Ana Sayfa sekmesi araç çubuğundan Araç Kutusunu açın.

3. Araç Kutusu penceresinde, Envanter sekmesine tıklayın. Modellerim sıralaması görüntülenir.

   

4. Özellik Paketi Çekirdek karosuna, ardından Görevler Özellik Paketi karosuna tıklayın. Her iki paket klasörü de Keşfedin penceresinde görüntülenir.

5. Paket klasörlerini ReplicatedStorage içine sürükleyin.

Görevleri tanımlayın

Her tamamlanabilir görev, görevi tamamlamak için bitirilmesi gereken bir dizi görev, yapılandırma seçenekleri ve isteğe bağlı görüntüleme meta verileri içerir; bunların tümü ReplicatedStorage.Missions.Configs.Missions içinde tanımlanabilir ve türler aynı klasördeki Types betiğinden dışa aktarılır.

Gerekli alanlar

Her görev için aşağıdaki alanlar gereklidir.

Kilitlenme koşulları

Varsayılan olarak, görevler oyuncular için otomatik olarak kilitlenir ve tam olarak bir kez tamamlanabilir. Ancak, bu davranışı değiştirmek için aşağıdaki isteğe bağlı yapılandırma seçeneklerini kullanabilirsiniz.

Meta veriler

Görevlerin, Görevler kullanıcı arayüzünde nasıl görüntüleneceğini belirten meta verileri vardır. Meta verilerini özelleştirmek için aşağıdaki isteğe bağlı alanları kullanabilirsiniz.

Görevleri tanımlayın

Her görev sıfır veya daha fazla göreve sahip olabilir. Eğer bir görev sıfır görev içeriyorsa, açıldıktan hemen sonra talep edilebilir; eğer bir görev bir veya daha fazla göreve sahipse, görevler tamamlandığında oyuncu göreve bağlı ödülleri toplayabilir. Her görevin bir taskId'si vardır; bu, belirli bir görev için göreve bağlı anahtardır.

Görevler iki türde gelir:

• Zamanlı Görevler - Görevi farklı zaman noktalarında başlatıp durdurmanıza olanak tanır. Görev zamanlayıcısı çalışırken belirli bir süre geçmelidir, ardından görev tamamlanır.
• Sayım Görevleri - Görevin ilerlemesini artırmanıza veya ayarlamanıza olanak tanır. İlerleme belirli bir değere ulaştığında, görev tamamlanır.

Her iki görev türü de aşağıdaki alanları paylaşır:

Sayım görevleri alanları

Sayım görevlerinin bir zorunlu değeri vardır. Görev ilerlemesi bu miktara ulaştığında, görev tamamlanır.

Zaman görevleri alanları

Zaman görevleri, harcanan hedef süreye sahiptir ve başlatılıp durdurulabilir. Hedef süre karşılandığında, görev tamamlanır.

Kategorileri yapılandırın

Kategorilerin kullanılmak üzere açıkça tanımlanması gerekmez, çünkü bir görev için kategori varsayılan değerler kullanılır. Ancak, bu değerleri ReplicatedStorage.Missions.Configs.Categories içinde yapılandırarak kategoriye ek etkiler ekleyebilirsiniz. Kategoriler, görevler yapılandırmasında referans verilen benzersiz CategoryIds ile tanımlanır.

Sunucu mantığını entegre edin

ReplicatedStorage.Missions.Server.Examples.MissionsExample'a göz atın; bu, sunucunuzun Görevler özellik paketi ile nasıl etkileşime gireceğini gösterir.

Görevler özellik paketini oyununuza sürükledikten sonra dört şeyi bağlamanız gerekir:

1. Görevler yapılandırmanızda görevleri tanımlayın.

2. Görev ilerlemesini veya ilerlemenin bağlı olduğu sayaçları güncellemek için oyununuzda mantık ekleyin.

   README

   -- Jumps görevine sahip Jumping görevinde ilerlemeyi artırır
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- BattlingTime görevinde TimeInBattle görevinde zamanlayıcıyı başlatır
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- BattlingTime görevinde TimeInBattle görevinde zamanlayıcıyı durdurur
   Missions.stopTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Jumps sayacına bağlı tüm görevlerde ilerlemeyi artırır
   CounterSystem.addCounter(player, "Jumps", 1)
   
   -- TimeInBattle zamanlayıcı sayacına bağlı tüm zamanlı görevlerde zamanlayıcıyı başlatır
   CounterSystem.startTimer(player, "TimeInBattle")
   
   -- TimeInBattle zamanlayıcı sayacına bağlı tüm zamanlı görevlerde zamanlayıcıyı durdurur
   CounterSystem.stopTimer(player, "TimeInBattle")

3. Görev tamamlama işleyicilerini ayarlayın ve isteğe bağlı olarak açma veya başarısız olma işleyicileri ekleyin. Tamamlama işleyicisini, oyununuzda görevden ödülleri vermek için kullanın.

   README

   local function completeHandler(player: Player, missionId: Types.MissionId)
        print(`{player} görev {missionId} tamamlandı`)
        -- Oyuncuya ödüllerini ver.
    end
   
   Missions.setCompletionHandler(missionId, completeHandler)

4. Otomatik olarak açılmayan görevleri açın. Görevler özellik paketi mantığı, görevin tamamlanabilmesi için tüm görev gereksinimlerinin karşılandığından emin olur ve ödülleri toplanabilir hale getirir.

   README

   Missions.unlockMission(player, "Manual")

Sabitleri yapılandırın

Çekirdek özellik paketi için sabitler iki yerde bulunur:

• Paylaşılan sabitler ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants içinde bulunur.

• Paket özel sabitleri, bu durumda Görevler özellik paketi, ReplicatedStorage.Missions.Configs.Constants içinde bulunur.

Ayrıca, çeviri için dizeleri bir yerde bulabilirsiniz: ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings.

UI bileşenlerini özelleştirin

Paket nesnelerini, renkler, yazı tipi ve saydamlık gibi değiştirerek, görevler UI'nizin görsel sunumunu ayarlayabilirsiniz. Örneğin, ReplicatedStorage.Missions.Configs.Constants içinde SingleTaskMode'u etkinleştirerek, yalnızca tek bir görevi olan görevler için görevin kendisinde bir ilerleme çubuğu görüntüleyebilirsiniz.

Ayrıca, oyununuzda zaten mevcut bir UI varsa ve bunu Görevler özellik paketi ile entegre etmek istiyorsanız, istemci ModuleScript MissionsClient, sunucudan bir oyuncunun görevleri hakkında bilgi almak için gerekli tüm işlevleri içerir.