Hareketli Hedef İşaretleyici

Hedef işaretleyiciler, bir oyuncuyu bir sonraki hedefe veya konuma yönlendirmek için birçok oyunda kullanılır. Bu eğitimde Harita Göstergesi cihazı ve Verse kullanarak yeniden kullanılabilir bir hedef işaretleyiciyi nasıl yapacağını öğreneceksin.

Kullanılan Verse Dili Özellikleri

• Yapı: Farklı türlerdeki değişkenleri bir yapı halinde gruplayabilirsin.

• Uzatma metodu: Var olan bir sınıfın veya türün bir üyesi gibi hareket eden ancak yeni bir tür veya alt sınıf oluşturulmasını gerektirmeyen özel bir fonksiyon türüdür. Bu eğitimde yapı için bir uzatma metodu oluşturacaksın.

• Adlandırılmış bağımsız değişken: Bir fonksiyon çağrısına parametre adı belirtilerek gönderilen bir bağımsız değişken.

Kullanılan Verse API’leri

• creative_prop API: creative_prop API (Uygulama Programı Arabirimi), nesne hareketi için metotlar sağlar.

• Düzenlenebilir Özellikler: Hızlı test için hem cihazlara referans vermek hem de değişken değerlerini güncellemek için çeşitli özellikler kullanılır.

Talimatlar

Birden fazla hedefe veya konuma hareket edebilen bir hedef işaretleyici cihazının nasıl kurulacağını öğrenmek için bu adımları takip et. Tam kodlar referans olması için bu kılavuzun sonuna eklenmiştir.

Bölümü Kurmak

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

• 1 adet Bina Nesnesi: Harita Göstergesi cihazını hareket ettirmek için kullanılacak nesne.

• 1 adet Harita Göstergesi cihazı: Mini haritada ve genel bakış haritasında özel işaretleri görüntüleyecek cihaz.

• 1 adet Oyuncu Doğma Karesi cihazı: Oyuncunun nesnenin yakınında doğması için bu cihazı nesnenin yakınına ekle.

Nesne API’sini Kullanma

Bir cihazı Verse ile hareket ettirmenin ilk adımı, Nesne API’siyle bir nesneyi hareket ettirmektir. Bölümünde bir nesneyi hareket ettirmek için aşağıdaki adımları izle.

1. objective_coordinator_device adlı yeni bir Verse cihazı oluştur.

2. Verse dosyasının üst kısmındaki varsayılan using ifadeleri altına SpatialMath modülü için bir using ifadesi ekle. Bu modül, nesneleri hareket ettirmek için referans vereceğin kodu içerir.

   Verse

        using { /UnrealEngine.com/Temporary/SpatialMath }
   

   Copy full snippet(1 line long)

3. Şu iki düzenlenebilir özelliği ekle:

   • Hareketli nesneye verilen referansı depolamak için RootProp adlı bir creative_prop sabiti.

   • Nesnenin ona doğru hareket edeceği konumu depolamak için Destination adlı bir transform sabiti.

     Verse

       objective_coordinator_device<public> := class<concrete>(creative_device):
     
           @editable
           RootProp<public> : creative_prop = creative_prop{}
     
           @editable
           Destination<public> : transform = transform{}

     Copy full snippet(7 lines long)

4. Bu kodu çalıştırıp objective_coordinator_device cihazını bölümüne sürüklediğinde bu iki özelliği Ayrıntılar panelinde göreceksin.

5. Bir nesneyi hareket ettiren asıl şey, TeleportTo[] metodudur. Metodu bir if ifadesi içinde çağırmalısın ve TeleportTo[] bir başarısız olabilir ifade olduğundan parantez yerine köşeli ayraç kullanmalısın. if ifadesi bir başarısızlık bağlamı oluşturur.

   Verse

        if(RootProp.TeleportTo[Destination.Translation, Destination.Rotation]):
            Print("Prop move successful")
        else:
            Print("Prop move failed")
   

   Copy full snippet(4 lines long)

6. TeleportTo[] metodunun bağımsız değişkenleri Yer Değiştirme veDönme’dir. Her ikisi de Varış noktası özelliğinden gelir.

7. Editöre geri dönüp İçerik Tarayıcısı’nda Fortnite > Galeriler > Nesneler altından bir nesneyi editöre sürükle. Bu eğitimde Coastal Buoy 02B adlı nesneyi kullanıyoruz ancak Nesneler klasöründeki herhangi bir şeyi kullanabilirsin.

8. Anahat Düzenleyicisi’nde hedef koordinatör cihazını seç. Ayrıntılar panelinde RootProp bileşenini nesnene ayarla. Bu örnekte RootProp bileşeni Coastal Buoy 02B olarak ayarlanır.

   

9. Ayrıntılar panelinde Varış Noktası öğesini genişlet. Varış Noktası transform türünde olduğundan Ölçek, Dönme ve Yer Değiştirme’den oluşur. Nesneyi hareket ettirmek için yalnızca Yer Değiştirme ayarını değiştirmen gerekir, bu nedenle bu ayarı genişlet. X ile biten alanı 5000,0 olarak ayarla.

   

   Kodu test ederken etkisinin fark edilir olması için değerlerde büyük değişiklikler yapmak işe yarar bir yoldur. Küçük değişikler, kodunun istediğin gibi çalışıp çalışmadığını görmeni zorlaştırabilir.

   Verse

    using { /Verse.org/Simulation }
    using { /Fortnite.com/Devices }
    using { /UnrealEngine.com/Temporary/SpatialMath }
   
    objective_coordinator_device<public> := class<concrete>(creative_device):
   
        @editable
        RootProp<public> : creative_prop = creative_prop{}
   
        # Where the marker will be moved to
   
   Expand code Copy full snippet(19 lines long)

10. Verse ve ardından Verse Kodu Oluştur seçeneğine tıkladıktan sonra Oturumu Başlat düğmesine tıkla. Son olarak, Oyunu Başlat düğmesine tıkla. Şimdi nesnenin hareket ettiğini görüyor olmalısın.

Üst Öğeler ve Yapılar

Artık bölümünde hareket eden bir nesneye sahipsin ancak asıl amaç, oyuncuların bir ara nokta olarak kullanabilmesi için Harita Göstergesi cihazını hareket ettirmek. Bölümüne bir Yapı Nesnesi ve Harita Göstergesi cihazı ekleyip, Harita Göstergesi cihazını Yapı Nesnesine tutturmak için aşağıdaki adımları izle.

1. Bağlam menüsünü açmak için İçerik Tarayıcısı içinde sağ tıkla.

2. Bağlam menüsünden Blueprint Sınıfı’nı seç.

   

3. Üst Sınıf Seç penceresinde Bina Nesnesi’ne tıkla.

   

4. İçerik Tarayıcında yeni bir Blueprint Sınıfı görünür. Bu sınıfı BuildingProp olarak yeniden adlandır.

   

5. Yapı Nesnesini bölümüne sürükle. Bu nesnenin örgüsü yoktur, bu nedenle yalnızca onun dönüştürme gizmosunu göreceksin.

   

6. Anahat Düzenleyicide, Harita Göstergesi Cihazını Yapı Nesnesinin üzerine sürükle. Bu, Yapı Nesnesini Harita Göstergesi Cihazının üst öğesi yapar. Şimdi, Yapı Nesnesi hareket ettiğinde Harita Göstergesi Cihazı da onunla birlikte hareket eder.

   

Verse kullanarak cihaz oluşturmayı zaten biliyorsun ancak kendi cihazı olmayan Verse dosyaları da oluşturabilirsin.

1. Yeni bir Verse dosyası oluştur ve objective_marker olarak adlandır. Bu dosya, cihaz oluşturmayacak. Bunun yerine, daha önce oluşturduğun Verse cihazının kullanımına verilecek olan bir struct tanımı içerecek.

2. İlk olarak objective_marker adlı bir struct bildirerek başla. Bu yapının iki üyesi olacak: RootProp ve MapIndicator. Bu üyelerin ikisi de @editable belirleyicisine sahip olmalıdır.

   Verse

        objective_marker<public> := struct<concrete>:
   
        @editable
        RootProp<public> : creative_prop = creative_prop{}
   
        @editable
        MapIndicator<public> : map_indicator_device = map_indicator_device{}

   Copy full snippet(7 lines long)

Uzatma Metotları ve Adlandırılmış Bağımsız Değişkenler

RootProp üyesini ve buna tutturulan Harita Göstergesi cihazını hareket ettirecek olan MoveMarker metodunu bildir. Bu yöntem, uzatma yöntemleri ve adlandırılmış bağımsız değişkenler olmak üzere iki dil özelliğini getirir.

(Marker : objective_marker).MoveMarker<public>(Transform : transform, ?OverTime : float)<suspends> : void =

• Uzatma metotları: MoveMarker() metodunu objective_marker yapısına ekliyorsun. Bir uzatma yöntemi, bir parantez içinde bir tanımlayıcı ve iki noktayla ayrılan tür kullanılarak bildirilir. Örneğimizde şu şekilde bildiriliyor: (Marker : objective_marker).

• Adlandırılmış bağımsız değişkenler: İkinci bağımsız değişken ?OverTime, MoveMarker fonksiyon çağrısında adlandırılması gerektiğini ? karakteriyle belirtir. Bu, MoveMarker çağrısını okuyan veya yazan herhangi bir geliştiricinin float bağımsız değişkeninin ne yaptığını anlamasına yardımcı olur.

MoveMarker(), Nesne API’sinden iki metottan birini çağırır: Daha önce kullandığın TeleportTo[] veya MoveTo(). OverTime parametresinin 0.0 değerinden büyük olup olmadığını anlamak için bir if..else bloku oluştur. Büyükse MoveTo() metodunu çağır. Bu, hedefin anında ışınlanmak yerine bir sonraki konumuna belirlediğin süre boyunca gitmesini sağlar.

(Marker : objective_marker).MoveMarker<public>(Transform : transform, ?OverTime : float)<suspends> : void =

 if (OverTime > 0.0):
        Marker.RootProp.MoveTo(Transform.Translation, Transform.Rotation, OverTime)
    else:
        if:
            Marker.RootProp.TeleportTo[Transform.Translation, Transform.Rotation]

Kodu şimdi derlersen başarılı olur ancak İçerik Tarayıcısı’ndaki CreativeDevices klasöründe yeni bir cihaz görülmez. Bunun nedeni, objective_marker cihazının creative_device üst sınıfından devralan bir sınıf değil bir struct (yapı) olmasıdır.

Hedef Koordinatörü Cihazını Güncelleme

Artık referans verilecek yeni bir türe sahip olduğuna göre, buna referans vermek için objective_coordinator_device öğesini güncellemen gerekiyor.

1. RootProp özelliğini silip yerine objective_marker türünde PickupMarker adlı bir özellik getir. Bu, burada oluşturduğun türdür.

2. MoveMarker() metodu float türünde bir bağımsız değişken gerektirdiğinden, bu değişkeni MoveTime adlı bir düzenlenebilir özellik olarak oluştur.

3. TeleportTo[] çağrısını sil. Bunun yerine, objective_marker için oluşturduğun MoveMarker() metodunu çağır. Bu metot, ?OverTime adlandırılmış bağımsız değişkenini gerektirir.

   Verse

        objective_coordinator_device<public> := class<concrete>(creative_device):
   
            @editable
            PickupMarker<public> : objective_marker = objective_marker{}
   
            # Where the marker will be moved to
            @editable
            Destination<public> : transform = transform{}
   
            # How much time the marker should take to reach its new location
   
   Expand code Copy full snippet(16 lines long)

Bu kodu derle ve hedef koordinatörü cihazının Ayrıntılarını kontrol et. PickupMarker ve MoveTime özellikleri bulunmalı ve PickupMarker özelliği, RootProp ve MapIndicator alanlarını içermelidir.

1. RootProp alanını BuildingProp olarak, MapIndicator alanınıysa Harita Göstergesi Cihazı (Map Indicator Device) olarak ayarla.

   

2. Kodunu derleyip Oturumu Başlat düğmesine tıkla. Oyunun başladıktan kısa bir süre sonra mini haritanda hareket eden bir işaretleyici görmelisin. İşaretleyicinin hareketini, MoveTime alanını 0,0 dahil farklı değerlere ayarlayarak dene. Farklı senaryolar için hangi hareketin en iyi düzeyde uygun olacağını düşün.

GetPlayers() ve ActivateObjectivePulse()

Oyuncularına bir sonraki hedeflerine ulaşmaları için biraz daha yardım etmenin bir yolu var. Buna hedef atımı adı verilir ve etkinleştiğinde oyuncudan Harita Göstergesi Cihazı’na doğru hareket eden noktalı bir çizgi gösterir. Hedef koordinatörü cihazına bir hedef atımı eklemek için aşağıdaki talimatları izle.

Hedef atımını etkinleştirmek için kullanacağın metot, agent türünde bir bağımsız değişken gerektiren ActivateObjectivePulse() adlı metottur. Oyuncu karakterini temsil eden agent örneğini almak için metodu oluşturarak işe başla.

1. Dönüş değeri void olan ve <private> olarak ayarlanan FindPlayer() adlı bir fonksiyonu bildir.

2. Self.GetPlayspace().GetPlayers() ile bölümündeki tüm oyuncuları içeren bir diziyi al. Diziyi AllPlayers adlı bir değişkende depola.

   Verse

        FindPlayer<private>() : void =
   
            AllPlayers := Self.GetPlayspace().GetPlayers()

   Copy full snippet(3 lines long)

3. Bölümündeki tek oyuncuya referans almak için ilk dizi öğesini kendi değişkenine ata. Bir diziye erişim, bir başarısız olabilir ifadedir, bu nedenle onu bir if ifadesi içine yerleştir.

   Verse

        if (FirstPlayer := AllPlayers[0]):
   

   Copy full snippet(1 line long)

4. Oyuncunu (player) bir değişkene atamak başarısız olabileceğinden, kodunda oyuncuya referans verirken option (seçenek) türünde bir değişken kullanmalısın. İsteğe bağlı bir ?player oyuncu değişkeni bildir. Bu değişken, diğer üye değişkenlerle uyumlu olmalıdır.

   Verse

        objective_coordinator_device<public> := class<concrete>(creative_device):
   
        var PlayerOpt<private> : ?player = false
   
        @editable
        PickupMarker<public> : objective_marker = objective_marker{}
   
        # Where the marker will be moved to
        @editable
        Destination<public> : transform = transform{}
   
   Expand code Copy full snippet(14 lines long)

5. Yeni değişkenini ayarlayıp bir oyuncunun bulunamadığını sana söyleyecek olan bir Print() ifadesine sahip bir else bloku oluştur. Artık FindPlayer() fonksiyonun tamamlandı.

   Verse

        FindPlayer<private>() : void =
   
            # Since this is a single player experience, the first player [0]
            # should be the only one available.
   
            AllPlayers := Self.GetPlayspace().GetPlayers()
   
            if (FirstPlayer := AllPlayers[0]):
                set PlayerOpt = option{FirstPlayer}
                Print("Player found")
   
   Expand code Copy full snippet(13 lines long)

Şimdi OnBegin() fonksiyonuna geri dönüp iki değişiklik daha yapman gerekiyor:

1. FindPlayer() fonksiyonunu çağır.

   Verse

        OnBegin<override>()<suspends> : void =
   
            FindPlayer()

   Copy full snippet(3 lines long)

2. MoveMarker() çağrısından sonra, isteğe bağlı oyuncu değişkenini yeni bir değişkene ayarlamak için başka bir if ifadesi kullan ve onu PickupMarker.MapIndicator.ActivateObjectivePulse() fonksiyonuna bağımsız değişken olarak ilet.

   Verse

        if (FoundPlayer := PlayerOpt?):
            PickupMarker.MapIndicator.ActivateObjectivePulse(FoundPlayer)
   

   Copy full snippet(2 lines long)

Şimdi kodu çalıştırdığında bölümde karakterinden hedef işaretleyicinin bulunduğu konumu işaret eden hedef atımını göreceksin!

Tam Kodlar

Objective_marker.verse

using { /Verse.org/Simulation }
using { /Fortnite.com/Devices }
using { /UnrealEngine.com/Temporary/SpatialMath }
using { /Fortnite.com/Devices/CreativeAnimation }

objective_marker<public> := struct<concrete>:

    # The prop that will be moved
    @editable
    RootProp<public> : creative_prop = creative_prop{}

Objective_coordinator_device.verse

using { /Verse.org/Simulation }
using { /Fortnite.com/Devices }
using { /Fortnite.com/Playspaces }
using { /UnrealEngine.com/Temporary/SpatialMath }

objective_coordinator_device<public> := class<concrete>(creative_device):

    var PlayerOpt<private> : ?player = false

    @editable

Kendi Kendine Yapabileceklerin

Burada yazdığın hareket ettirme kodunun tüm nesneler için çalışacağını unutma. Hareket edebilir bir nesneyi bir cihazın üst öğesi yapabilirsen cihaz da nesneyle birlikte hareket edecektir. Başka nesneleri ve cihazları hareket ettirmeyi dene ve bunlardan başka hangi oyunlarda yararlanabileceğini düşün.

Sonraki Adımlar

Bu kılavuzu bir Toplama / Dağıtma oyunu inşa etmek için kullanıyorsan bir sonraki adımın Geri Sayım Süreölçeri özelliğini nasıl oluşturacağını öğrenmek olacak.