Görevler paketi

Görevler özellik paketi, oyuncuların ödüller kazanmak ve deneyiminizde ilerlemek için tamamlayabileceği görevler oluşturmak için hazır işlevsellik sunar. Tüm görevlerin bir ID, kategori ve oyuncuların görevi tamamlamak için tamamlaması gereken bir görevler listesi olmalıdır. Ancak, görevler listesi boş olabilir, bu da görevin ödüllerinin hemen talep edilmesine olanak tanır.

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

• Deneyiminizde yeni oyuncuları yeni başlayanlar için tanıtan görevler oluşturmak ve D1 bağlılık'ı artırmak.
• Orta ve uzun vadeli hedefler ekleyerek D7 ve D30 bağlılığını hedeflemek.
• Katılımı artırmak için oyununuzdaki çeşitli sistemleri öne çıkarıp oyuncuların onlarla etkileşimde bulunmaları için ödüllendirmek.

Paketi alın

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

Her özellik paketi, doğru çalışması için Core özellik paketini gerektirir. Core ve Görevler özellik paketi varlıkları envanterinizde olduğunda, bunları platformdaki herhangi bir projede yeniden kullanabilirsiniz.

Envanterinizdeki paketleri deneyiminize almak için:

1. Aşağıdaki bileşen setindeki Envantere Ekle bağlantısına tıklayarak Studio'daki Core ve Görevler'i envanterinize ekleyin.

   Core Özellik Paketi

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

   Envantere ekle

   Görevler Özellik Paketi

   Görevler Özellik Paketi, oyuncuların tamamlayabileceği görevler oluşturmak için işlevsellik sunar ve deneyiminizde ödüller kazanmanıza yardımcı olur.

   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 Core 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 görevler seti, 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örde bulunan Types komut dosyasından dışa aktarılabilir.

Gereken alanlar

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

Kilitlenme koşulları

Varsayılan olarak, görevler oyuncular için otomatik olarak kilitsizdir ve yalnızca 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. Aşağıdaki isteğe bağlı alanları kullanarak meta verilerini özelleştirebilirsiniz.

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öreve sahipse, kilitlendikten hemen sonra talep edilebilir; eğer bir görev bir veya daha fazla göreve sahipse, görevler tamamlandığında oyuncu, görevle ilişkili ödülleri toplayabilir. Her görevin bir taskId'si vardır; bu, belirli bir görev için görevle ilişkili anahtarını belirtir.

Görevler iki türde gelir:

• Zamanlı Görevler - Görevi farklı zamanlarda başlayıp durdurmanıza olanak tanır. Görevin zamanlayıcısı çalışırken belirli bir süre geçmeli, ardından görev tamamlanır.
• Sayım Görevleri - Görevin ilerlemesini eklemenize veya ayarlamanıza olanak tanır. İlerleme belirlenen 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 gerekli bir değeri vardır. Görev ilerlemesi bu miktara ulaşırsa, görev tamamlanır.

Zaman görevleri alanları

Zaman görevleri, harcanması gereken hedef bir süreye sahiptir ve başlatılıp durdurulur. Hedef süre dolduğunda, görev tamamlanır.

Kategorileri yapılandırın

Kategoriler, kullanılmak üzere açıkça tanımlanmalarına gerek yoktur, çünkü bir görevin kategorisi varsayılan değerleri kullanı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 aynı benzersiz CategoryIds ile tanımlanır.

Sunucu mantığını entegre edin

Görevler özellik paketiyle sunucunuzun nasıl etkileşimde bulunacağını gösteren ReplicatedStorage.Missions.Server.Examples.MissionsExample'a göz atın.

Görevler özellik paketini deneyiminize sürükledikten sonra dört şeyle bağlantı kurmanız gerekir:

1. Görev yapılandırma ayarlarınızı tanımlayın.

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

   README
   -- Jumps görevinde bir görev tamamlayarak ilerlemeyi artırır
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- TimeInBattle görevinde BattlingTime görevinin zamanlayıcısını başlatır
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- TimeInBattle görevinde BattlingTime görevinin zamanlayıcısını durdurur
   Missions.stopTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Jumps sayacıyla 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şlemcilerini ayarlayın ve isteğe bağlı olarak kilitleme veya başarısızlık işlemcilerini ekleyin. Tamamlama işlemcisini, deneyiminizde görevin ödüllerini 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 kilitlenmeyen görevleri kilitleyin. Görevler özellik paketi mantığı, görevin tamamlandığından emin olmak için tüm görev gerekliliklerinin karşılandığını kontrol eder ve ödüllerinin alınabilir olmasını sağlar.

   README
   Missions.unlockMission(player, "Manual")

Sabitleri yapılandırın

Core özellik paketi için sabitler iki yerde bulunur:

• Paylaşılan sabitler ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants içinde yer alır.

• Paket spesifik sabitler, bu durumda Görevler özellik paketi ise, ReplicatedStorage.Missions.Configs.Constants içinde bulunur.

Ayrıca, çevrimiçi diller için İfade dizilimini ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings içinde bulabilirsiniz.

UI bileşenlerini özelleştirin

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

Ayrıca, deneyiminiz zaten mevcut bir UI'ye sahipse 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.