Dokununca Kaybolan Platform

Üzerine çıktığında kaybolan platformlar, engelli parkurlar gibi platformlu oyun modlarının başlıca unsurları arasındadır. Oyuncunun hızlı hareket etmesini ve düşmemek için nereye gideceğini planlamasını gerektirir.

Bu eğitimi izleyerek, oyuncu dokunduğunda kaybolup rastgele sayıda saniye sonra tekrar beliren bir platformu Fortnite İçin Unreal Editor’da (UEFN) Verse kullanarak nasıl oluşturacağını öğreneceksin. Bu örnekte, oyuncunun düşmemek için platformdan platforma atlaması gereken bir alanın nasıl oluşturulacağı gösteriliyor. Tam kod, referans olması için bu kılavuzun sonuna eklenmiştir.

Kullanılan Verse Dili Özelliği

• spawn: spawn ifadesi, platformu rastgele bir sayıda saniye sonra yeniden görünür hale getiren asenkron fonksiyonu çağırmak için kullanılır.

Kullanılan Verse API’leri

• Sleep(): Sleep() API’siUygulama Programı Arabirimi), platformun kaybolmasıyla rastgele bir süre sonra tekrar belirmesi arasındaki gecikmeleri eklemek için kullanılır.

• GetRandomFloat(): GetRandomFloat() API’si, platformun tekrar belirmesi öncesinde bir rastgele süre hesaplamak için kullanılır.

• Düzenlenebilir Özellikler: Platformun kaybolma ve yeniden belirme gecikmelerini kontrol edecek üç değişken ve platform referansının kendisi olmak üzere dört özellik UEFN’de kullanıma açılır.

• Cihaz Olayları: Bir oyuncunun platforma ne zaman çıktığını öğrenmek için Tetikleyici cihazın TriggeredEvent fonksiyonunu kullanırsın.

Bölümü Kurmak

Bu eğitimde başlangıç noktası olarak Verse Başlangıç Şablonu kullanılmaktadır. Başlamak için Verse Cihazı özellik örneğinden yeni bir proje oluştur.

Bu örnekte aşağıdaki nesne ve cihazlar kullanılıyor.

• 1 adet Oyuncu Doğma Karesi cihazı: Bu cihaz, oyuncunun oyun başlangıcında nerede doğacağını belirler.

• 4 x Kreatif Nesne: Kreatif nesneler, platformun görünürlüğünü ve çarpışmasını değiştirmek için Hide() ve Show() gibi Verse ile çağırabileceğin çeşitli davranışlara sahiptir. Bu eğitimde oyuncu etkileşimli platform olarak Airborne Hoverplatform A kullanılmaktadır. Bunu deneyiminin ihtiyaçlarına göre değiştirebilirsin.

• 4 adet Tetikleyici cihazı: Bir oyuncunun her platforma ne zaman çıktığını öğrenmek için bu tetikleyicileri kullanırsın.

Bölümünü ayarlamak için şu adımları izle:

1. Sahnene bir adet Airborne Hoverplatform A ekle. Zeminin üzerine yerleştir, böylece oyuncu kaybolan platformdan zamanında atlamazsa düşecektir. Anahat Düzenleyicisi’nde platformu RecyclePlatform olarak adlandır.

   

2. Sahnene bir Tetikleyici cihazı ekle ve bunu RecyclePlatform’un alt öğesi olarak ayarla. Bunu platformun en üstüne yerleştir ve platformun tamamına sığacak şekilde yeniden boyutlandır. Anahat Düzenleyicisi’nde, Oyunda Görünür ayarını False olarak ve Kaç Kez Tetiklenebilir ayarını 1 olarak ayarla.

   

3. Oyuncu Doğma Karesi cihazını platformun üzerine yerleştir. Oyun başladığında oyuncu burada doğacak. Anahat Düzenleyicisi’nde Oyunda Görünür seçeneğini devre dışı bırak; böylece oyuncu, doğduktan sonra doğma karesinde duramaz. Tamamlanmış ayarlar şu şekilde görünmelidir:

   

Cihazı Oluşturma

Bu örnekte, oyuncu üzerine çıktığında platformun kaybolmasını ve rastgele sayıda saniye sonra yeniden belirmesini sağlayan davranışı tanımlamak için bir Verse ile yazılmış cihaz kullanılıyor. Verse kullanarak bu cihazı oluşturmak için aşağıdaki adımları izle.

1. Verse Gezgini’ni kullanarak disappear_on_touch_platform adlı yeni bir Verse cihazı oluştur. Verse’te yeni bir cihazın nasıl oluşturulacağını öğrenmek için Verse Kullanarak Kendi Cihazını Oluşturma bölümüne bakabilirsin.

   

2. disappear_on_touch_platform cihazını İçerik Tarayıcısı’ndan bölümüne sürükle.

UEFN’de Cihaz Özelliklerini Düzenleme

Bu bölümde, editörde özelleştirebilmek için dört cihaz özelliğini UEFN'e nasıl açacağın gösteriliyor:

• Bölüme yerleştirdiğin kreatif objeye yönelik bir cihaz referansı.

• Oyuncu platforma dokunduğunda platformu gizlemeden önce ne kadar beklenmesi gerektiğini depolayacak DisappearDelay adlı bir kayan sayı sabit.

• Platformu yeniden görünür hale getirmeden önce beklenecek minimum ve maksimum süreyi depolayacak DelayMin ve DelayMax adlı iki float (kayan sayı) sabit. Bu iki değer, rastgele bir sayı alınırken izin verilen aralığı tanımlar.

Önceki kısımda oluşturduğun disappear_on_touch_platform cihazının bu özelliklerini kullanıma açmak için aşağıdaki adımları izle.

1. Verse Gezgini’ni aç ve disappear_on_touch_platform.verse dosyasına çift tıklayarak kodu Visual Studio Code ile aç.

2. disappear_on_touch_platform sınıf tanımına aşağıdaki alanları ekle:

   • DisappearDelay adlı bir düzenlenebilir kayan değer. Bu, oyuncu platforma dokunduktan sonra platformu gizlemeden önce ne kadar süre bekleneceğini belirtir. Bu değeri 1.0 yani bir saniye olarak başlat.

     Verse

       # How long to wait after the player touches the platform before hiding it.
       @editable
       DisappearDelay:float = 1.0
     

     Copy full snippet(3 lines long)

   • DelayMin adlı düzenlenebilir bir float. Bu, platformu yeniden görünür hale getirmeden önce beklenecek minimum süreyi belirtir. Bunu 3.0 yani üç saniye olarak başlat.

     Verse

       # The minimum amount of time to wait before making the platform reappear.
       @editable
       DelayMin:float = 3.0
     

     Copy full snippet(3 lines long)

   • DelayMax adlı düzenlenebilir bir float. Bu, platformu yeniden görünür hale getirmeden önce beklenecek maksimum süreyi belirtir. Bunu 4.0 yani dört saniye olarak başlat.

     Verse

       # The maximum amount of time to wait before making the platform reappear.
       @editable
       DelayMax:float = 4.0
     

     Copy full snippet(3 lines long)

   • DisappearingPlatform adlı bir düzenlenebilir creative_prop. Bu, periyodik olarak kaybolup görünecek olan bölüm içi platformu temsil eder. Yazdığın kod henüz bölümde bu objeye bir referans içermediğinden, bunu boş bir arketip creative_prop{} ile örneklendirirsin. Bu referansı daha sonra kayan platformuna atayabilirsin.

     Verse

       # Reference to the platform in the level.
       @editable
       DisappearingPlatform:creative_prop = creative_prop{}
     

     Copy full snippet(3 lines long)

   • PlatformTrigger adlı düzenlenebilir bir trigger_device. Bir oyuncunun platforma ne zaman çıktığını öğrenmek için bu cihazdan TriggeredEvent olayına ihtiyacın olacak.

     Verse

       # The zone a player enters when landing on the platform.
       @editable
       PlatformTrigger:trigger_device = trigger_device{}
     

     Copy full snippet(3 lines long)

3. disappear_on_touch_platform sınıf alanların şöyle görünmelidir:

   Verse

        # A Verse-authored creative device that can be placed in a level
        disappear_on_touch_platform := class(creative_device):
   		
            # How long to wait after the player touches the platform before hiding it.
            @editable
            DisappearDelay:float = 1.0
   		
            # The minimum amount of time to wait before making the platform reappear.
            @editable
            DelayMin:float = 3.0
   
   Expand code Copy full snippet(22 lines long)

   Kodlarındaki ToggleDelay gibi değerleri editörde kullanıma açmak için @editable özniteliğini kullanmak yararlıdır. Bu, her seferinde Verse kodunu yeniden oluşturmak zorunda kalmadan UEFN'deki değerlerini özelleştirmeni sağlar, böylece hızlı bir şekilde yineleyebilir ve oyun deneyimine uyan değerleri bulabilirsin.

4. Kodu Visual Studio Code içinde kaydet.

5. Bölümdeki disappear_on_touch_platform cihazını güncellemek için UEFN araç çubuğunda Verse’e tıklayıp ardından Verse Kodu Oluştur’a tıkla.

6. UEFN’deki Anahat Düzenleyicisi panelinde, cihazın Ayrıntılar panelini açmak için disappear_on_touch_platform cihazını seç.

7. Dokununca Kaybolan Platform’un altındaki Ayrıntılar panelinde, obje seçiciye tıklayarak ve görünüm penceresindeki platform cihazını seçerek Platform’u RecyclePlatform (bölüme eklediğin kreatif nesne) olarak ayarla.

8. Artık Verse cihazın tarafından referans verilen bir nesneye sahip olduğuna göre, her iki cihazı da seç ve oyuncunun birinden diğerine atlayabileceği bir dizi platform oluşturmak için bunları bölüm içinde birden fazla kez çoğalt. Oluşturduğun her yeni Verse cihazı kendi platformuna referans vermelidir.

   

Platformu Gizleme ve Gösterme

Artık bölümü ve cihazları ayarladığına göre, bir oyuncu platforma indiğinde platformu gösterme ve gizleme işlevini ekleyebilirsin. Bu davranışı disappear_on_touch_platform sınıfına eklemek için aşağıdaki adımları izle:

1. Creative_prop sınıfının görünürlüğünü açıp kapatmak için iki metot vardır: Hide() ve Show(). Visual Studio Code’da OnBegin() içinde, Hide() çağrısı yap ve ardından DisappearingPlatform’unda Show() çağır.

   Verse

        # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
   
            # Make the platform invisible.
            DisappearingPlatform.Hide()
   
            # Make the platform visible.
            DisappearingPlatform.Show()

   Copy full snippet(8 lines long)

   Bu kodu çalıştırdığında, Hide() ve Show() çağrıları birbirinin hemen ardından gerçekleştiği için platformun kaybolup yeniden belirdiği görülmez.

2. Platformun görünür/görünmez durumda daha uzun kalması için, Hide() veya Show() çağrısı yaparken Sleep() kullanarak bir gecikme ekleyebilirsin. Sleep() fonksiyonu bir yordamın yürütülmesini askıya alır, burada fonksiyona bir float bağımsız değişkeni ileterek yürütmenin askıya alınacağı süreyi (saniye olarak) belirtebilirsin. Her Hide() ve Show() çağrısından önce Sleep() çağrısı yap ve daha önce tanımladığın DisappearDelay değerini geçir.

   ~~~(verse) # Cihaz, çalışmakta olan bir oyunda başlatıldığında çalışır OnBegin<override>()<suspends>:void=

   # DisappearDelay saniyelerini bekle. Sleep(DisappearDelay)

   # Platformu görünmez yap. DisappearingPlatform.Hide()

   # DisappearDelay saniyelerini bekle. Sleep(DisappearDelay)

   # Platformu görünür yap. DisappearingPlatform.Show() ~~~

   Bu kodu çalıştırırsan oyunun geri kalanında platform görünür hale gelmeden önce bir saniye (DisappearDelay ile tanımlanan süre) boyunca görünmez olur.

   Sleep() fonksiyonu sadece bir asenkron bağlamda çağrılabilir. OnBegin() metodu, suspends belirleyicisine sahip olduğu için zaten bir asenkron bağlam olduğundan, başka bir şey yapmana gerek yoktur. Suspends belirleyicisi hakkında daha fazla bilgi edinmek için Belirleyiciler ve Öznitelikler sayfasına bakabilirsin.

3. Platformun tekrar belirme süresini değiştirmek, oyunu daha ilginç hale getirebilir. Her seferinde Sleep() fonksiyonuna aynı değeri vermek yerine, GetRandomFloat() fonksiyonuyla rastgele bir saniye sayısı elde edebilir ve bu değeri Sleep() fonksiyonuna iletebilirsin.

   • Dosyanın en üstüne using { /Verse.org/Random } ekleyerek GetRandomFloat() fonksiyonunu kullan.

     Verse

       using { /Fortnite.com/Devices }
       using { /Verse.org/Random }
       using { /Verse.org/Simulation }
       using { /UnrealEngine.com/Temporary/Diagnostics }
     
       # See https://dev.epicgames.com/documentation/en-us/uefn/create-your-own-device-in-verse for how to create a verse device.
     
       # A Verse-authored creative device that can be placed in a level
     
       disappear_on_touch_platform := class(creative_device):
     

     Copy full snippet(10 lines long)

   • Platformun tekrar belirmesi için bekleme süresini belirlerken GetRandomFloat() fonksiyonunu Sleep() için bir bağımsız değişken olarak kullan ve izin verilen saniye aralığını DelayMin ve DelayMax ile ayarla.

     Verse

       # Runs when the device is started in a running game
       OnBegin<override>()<suspends>:void=
     
       # Wait for DisappearDelay seconds.
       Sleep(DisappearDelay)
     
       # Make the platform invisible.
       DisappearingPlatform.Hide()
     
       # Wait between DelayMin and DelayMax seconds.
     
     Expand code Copy full snippet(14 lines long)

   Artık platform kaybolmadan önce 1.0 saniye bekleyecek ve ardından 3.0 ile 4.0 saniye arasında yeniden görünecektir.

Oyuncunun Platforma Çıktığını Algılama

Oyuncunun platforma ne zaman çıktığını algılamak için trigger_device sınıfının kullanıma açtığı TriggeredEvent olayına bağlanabilirsin. Tetikleyici, sadece bir oyuncu üzerinden geçtiğinde TriggeredEvent gönderir. Kaç Kez Tetiklenebilir ayarını bir olarak ayarladığından, tetikleyicinin durumunu sıfırlamak ve tekrar TriggeredEvent göndermesine izin vermek için tetikleyicide Reset() çağrısı yapman gerekir.

Oyuncu platforma dokunduğunda bunu algılamak için aşağıdaki adımları izle ve platformun gizlenip yeniden belirme yanıtını vermesi için önceki bölümde yazdığın kodu kullan.

1. TriggeredEvent, parametre olarak isteğe bağlı player ve dönüş türü olarak void içeren bir fonksiyon imzası gerektirir. Tetikleyici cihazları kod aracılığıyla da etkinleştirebildiğin için bu fonksiyonda aracı isteğe bağlıdır, bu nedenle onu etkinleştirenin bir oyuncu olup olmadığını kontrol etmen gerekir. disappear_on_touch_platform sınıfına OnPlayerTouch() adlı yeni bir metot ekle.

   Verse

        OnPlayerTouch(ActivatingPlayer:?agent):void=
   

   Copy full snippet(1 line long)

2. OnPlayerTouch() metodunda, bir if ifadesi içinde, oyuncuyu ActivatingPlayer seçeneğinden almaya çalış. Bu çağrı başarılı olursa, tetikleyiciyi kod yerine bir oyuncunun etkinleştirdiğini bilebilirsin.

   Verse

        OnPlayerTouch(ActivatingPlayer:?agent):void=
            if:
                Player := ActivatingPlayer?
            then:
                Print("A player touched a platform!")
   

   Copy full snippet(5 lines long)

3. OnBegin() fonksiyonunda, olay işleyicisi olarak OnPlayerTouch öğesini kullanarak PlatformTrigger.TriggeredEvent’e bağlan. Artık bir oyuncu bir platforma her çıktığında, TriggeredEvent etkinleştirilir ve OnPlayerTouch() çalışır.

   Verse

        OnBegin<override>()<suspends>:void=
   
            # Subscribe to the PlatformTrigger's TriggeredEvent to know
            # when a player lands on the platform.
            PlatformTrigger.TriggeredEvent.Subscribe(OnPlayerTouch)

   Copy full snippet(5 lines long)

4. Platform gizlendiğinde, platformun içinden geçmeleri gerektiği için oyuncular tetikleyiciyi etkinleştirememelidir. Bunu yapmak için, OnBegin() içinde, Hide() ve Show() fonksiyonlarından sonra sırasıyla PlatformTrigger.Disable() ve Enable() fonksiyonlarına çağrılar eklemelisin. Artık platformun gizliyken tetikleyicin etkileşime açık olmayacaktır.

   Verse

        OnBegin<override>()<suspends>:void=
   
            # Subscribe to the PlatformTrigger's TriggeredEvent to know
            # when a player lands on the platform.
            PlatformTrigger.TriggeredEvent.Subscribe(OnPlayerTouch)
   
            # Wait for DisappearDelay seconds.
            Sleep(DisappearDelay)
   
            # Hide the platform and disable the trigger.
   
   Expand code Copy full snippet(19 lines long)

Bir oyuncu üzerine çıktığında platformu gizlemen gerekse de, platformu gizleme ve göstermeyi sağlayan kodu doğrudan OnPlayerTouch() yöntemine ekleyemezsin. Sleep() fonksiyonu sadece asenkron bağlamda çağrılabilir ve TriggeredEvent olay işleyicisi olarak asenkron fonksiyonlara izin vermediği için OnPlayerTouch() fonksiyonuna suspends belirleyicisini ekleyemezsin. Bunun yerine, OnPlayerTouch() fonksiyonundan asenkron bir fonksiyonu çağırmak için spawn ifadesini kullanabilirsin. Asenkron fonksiyonunu eklemek için aşağıdaki adımları izle.

1. disappear_on_touch_platform sınıf tanımına yeni bir RecyclePlatform() metodu ekle. Bu kodun asenkron olarak çalışmasına izin vermek için <suspends> değiştiricisini ekle, platformu ve tetikleyiciyi gizlemeyi ve göstermeyi sağlayan kodu OnBegin kod blokundan RecyclePlatform() kod blokuna taşı.

   Verse

        # Hide the platform and reset the PlatformTrigger. Then wait a random amount of time and reactivate show the platform.
        RecyclePlatform()<suspends> : void =
   
            # Wait for DisappearDelay seconds.
            Sleep(DisappearDelay)
   
            # Hide the platform and disable the trigger.
            DisappearingPlatform.Hide()
            PlatformTrigger.Disable()
   
   
   Expand code Copy full snippet(16 lines long)

2. OnPlayerTouch() içinde, kodu asenkron olarak çalıştırmak için RecyclePlatform() üzerinde spawn{} çağrısı yap. Tamamlanmış RecyclePlatform() fonksiyonun şu şekilde görünmeli:

   Verse

        # Runs when a player lands on the platform. Calls RecyclePlatform() to hide the platform
        # and reset trigger state.
        OnPlayerTouch(ActivatingPlayer:?agent):void=
            if:
                Player := ActivatingPlayer?
            then:
                Print("A player touched a platform!")
                spawn{RecyclePlatform()}
   

   Copy full snippet(8 lines long)

   Bu kodu çalıştırdığında platform kaybolur ve ardından oyuncu platforma ilk çıktığında yeniden görünür.

   Asenkron, bir kod parçasının tamamlanmasının bir miktar zaman alabileceğini ifade eder. Burada, örneğin, platformun geri dönüşmesi tüm Sleep() çağrıları nedeniyle birkaç saniye alır. Asenkron işlevler, asenkron işlevi çağıran kodun yürütülmesini engellemeden işlemleri gerçekleştirmene olanak sağlar. Asenkron bağlamlar ve spawn ifadesi hakkında daha fazla bilgi edinmek için Eşzamanlılık sayfasına bakabilirsin.

3. Şu anda, TriggeredEvent yalnızca oyuncu platforma ilk kez çıktığında gönderilir. Olayı tekrar tetiklenebilir hale getirmek için tetikleyiciyi sıfırla fonksiyonunu çağırabilirsin. RecyclePlatform() içinde, Enable() fonksiyonunu çağırdıktan sonra PlatformTrigger üzerinde Reset() fonksiyonunu çağır.

   Verse

        # Hide the platform and reset the PlatformTrigger. Then wait a random amount of time and reactivate show the platform.
        RecyclePlatform()<suspends> : void =
   
            # Wait for DisappearDelay seconds.
            Sleep(DisappearDelay)
   
            # Hide the platform and disable the trigger.
            DisappearingPlatform.Hide()
            PlatformTrigger.Disable()
   
   
   Expand code Copy full snippet(19 lines long)

4. Kodu kaydet ve Verse’e tıklayıp ardından kodu derlemek için Verse Kodu Oluştur’a tıkla.

5. Bölümün oynanış testini yapmak için UEFN araç çubuğunda Oturumu Başlat düğmesine tıkla.

6. Şimdi bölümünün oynanış testini yaptığında, her platforma çıktığında platform kaybolmalı ve rastgele birkaç saniye sonra tekrar görünmelidir.

Tam Kod

Aşağıda, bir platformun oyuncu platforma çıktığında kaybolmasını ve rastgele birkaç saniye sonra yeniden ortaya çıkmasını sağlayacak tam kod verilmektedir.

using { /Fortnite.com/Devices }
using { /Verse.org/Random }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

# See https://dev.epicgames.com/documentation/en-us/uefn/create-your-own-device-in-verse for how to create a verse device.
# A Verse-authored creative device that can be placed in a level
disappear_on_touch_platform := class(creative_device):

    # How long to wait after the player touches the platform before hiding it.

Kendi Kendine Yapabileceklerin

Bu eğitimi tamamlayarak, bir platformun oyuncu üzerine çıktığında kaybolup rastgele sayıda saniye sonra tekrar belirmesini sağlayan bir cihazı Verse kullanarak nasıl yapacağını öğrenmiş oldun.

Öğrendiklerini kullanarak aşağıdaki işlemleri yapmaya çalış:

• İlgi çekici bir zorluk yaratmak için platformların boyutunu ve konumunu değiştirerek denemeler yap.

• Bu örnekte oyuncu herhangi bir puan kazanmıyor ve düştüğünde hiçbir şey olmuyor. Burada nasıl bir puanlama sistemi ve kaybetme koşulu uygulayabilirdin?