Bu sayfadaki adımları izleyerek Fortnite İçin Unreal Editor’de (UEFN) “Merhaba dünya!” diyen bir Verse programını oluşturmayı, çalıştırmayı, düzenlemeyi ve bununla ilgili sorunları gidermeyi öğrenebilirsin.
UEFN’e erişim hakkında bilgi için Fortnite İçin Unreal Editor’ü Başlatma bölümüne bakabilirsin.
İlk Verse Programın
VKT - Verse Cihazı Başlangıç Oyunları şablonu, Verse ile oluşturulmuş cihazları tanıman için geliştirilmiştir ve örnek olarak inceleyebileceğin birden fazla cihaz içerir. Aşağıdaki adımları izleyerek, bu şablonda yeni bir Verse cihazı oluşturup düzenlemeyi öğreneceksin.
Tüm UEFN özellik örneklerini görüntülemek için Proje Tarayıcısı penceresinde Özellik Örnekleri öğesini seç.
Özellik örnekleri listesinden Verse Cihazı seçeneğini tıklayarak vurgula.
Ekranın altındaki Proje Adı altında projene MyVerseProject adını ver, ardından Oluştur butonuna tıkla.
Menü Çubuğu içindeki Verse > Verse Gezgini seçeneğine git.
Verse Gezgini‘nde projenin adına sağ tıkla ve Projeye yeni Verse dosyası ekle’yi seçerek Verse Kodu Oluştur penceresini aç.
Verse Kodu Oluştur penceresinde şablonun olarak seçmek üzere Verse Cihazı’na tıkla ve Oluştur’a tıkla.
Menü Çubuğu’nda Verse > Verse Kodu Oluştur seçeneğine giderek yeni oluşturduğun Verse cihazının proje klasöründe göründüğünden emin ol.
İçerik Tarayıcısı’nda proje klasörüne git.
İçerik Tarayıcısı açık değilse Menü Çubuğu içindeki Pencere öğesine tıkla, ardından İçerik Tarayıcısı’nı veya UEFN penceresinin sol alt kısmındaki İçerik Çekmecesi’ni seç.
Klasörün yolu Tümü > MyVerseProject > hello_world_device olmalıdır.
hello_world_device cihazına tıkla ve onu bölüme sürükle.
Araç çubuğunda Oturumu Başlat butonuna tıklayarak adanın oynanış testini yap.
Büyütmek için görsele tıkla.
Değişiklikleri projeye kaydetmek için, İçeriği Kaydet penceresinde Seçileni Kaydet butonuna tıkla.
Sunucu projeyi yüklemeyi tamamladığında Ana Menü’yü aç ve Oyunu Başlat’a tıkla.
İstemcide, Escape tuşuna basarak Ana Menü ekranını aç ve Ada Ayarları’na tıkla. Ardından, günlüğü görüntülemek için üst gezinme çubuğundaki Günlük bölümüne tıkla.
Günlükte "Merhaba dünya!" (Hello, world!) ve sonraki satırında "2 + 2 = 4" yazan satırı bul. Bu satırlar hello_world_device.verse dosyasına aittir. Verse ile oluşturulmuş cihazı bölümüne eklediğin için oyunu başlattığında cihazın kodu çalıştırıldı.
Artık ilk Verse programını yazdığına göre şimdi hello_world_device.verse dosyasındaki kodu değiştirmenin vakti geldi. Bir sonraki bölüm için istemciyi çalışır durumda tut.
Programı Değiştir
Önceki bölümde cihazı oluşturan hello_world_device.verse dosyasını görüntülemek ve ardından yeni bir kod satırı eklemek için aşağıdaki adımları izle.
Projendeki tüm Verse dosyalarını görmek için Menü Çubuğu üzerindeki Verse > Verse Gezgini kısmına tıkla.
Projenin adının altında yer alan hello_world_device.verse dosyasını çift tıklayarak aç.
Verse dosyası, program yazmaya yarayan Visual Studio Code (VSC) editöründe açılır. Bilgisayarında Visual Studio Code yoksa yüklemeni isteyen bir istem görüntülenir.
Büyütmek için görsele tıkla.
Verse kod uzantısı, Verse hata denetimi ve sözdizimi vurgulaması sağlayan, ayrıca değişiklikleri derleyip doğrudan VS Code üzerinden Verse koduna göndermene izin veren bir VS Code uzantısıdır.
UEFN ile birlikte gelen Verse uzantısı, Verse için resmi olarak desteklenen tek dil uzantısıdır. Bu uzantı, UEFN’i başlattığında otomatik olarak etkinleştirilir. Uzantıyı kaldırırsan UEFN’i tekrar başlattığında yeniden yüklenir.
Verse kod uzantısının kurulduğunu, VS Code penceresinin üst kısmında Editor Focus (Editör Odağı), Build Verse Changes (Verse Değişiklikleri Derle) ve Push Verse Change (Verse Değişikliğini Gönder) düğmelerinin bulunup bulunmadığına bakarak doğrulayabilirsin.
Büyütmek için görsele tıkla.
Bu kodun geri kalanının nasıl çalıştığını daha sonra göreceksin ancak şimdilik OnBegin<override>()<suspends>:void= satırının altına girdiğin her kod oyun başladığında çalışacağı için dosyanın sonuna aşağıdaki kodu girmelisin:
Print("This is my first line of Verse code!")
Verse dosyan şu şekilde görünmelidir:
using { /Fortnite.com/Devices }
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
hello_world_device := class(creative_device):
# Runs when the device is started in a running game
# simgesinden sonra gelen metinler kod açıklaması olarak kabul edilir ve program çalıştırılırken bilgisayar tarafından yok sayılır. Kod açıklamaları sen ve kodunu okuyan diğer herkes için faydalıdır çünkü bunlar kodunla ilgili açıklamalar içerebilir. Bu örnekte # Cihaz devam eden bir oyunda başlatıldığında çalışır ve #TODO: Bunu kodunla değiştir ifadeleri kod açıklamasıdır.
Değişikliklerinizi Kaydedin
hello_world_device.verse dosyasını Visual Studio Code’da kaydet.
UEFN araç çubuğunda Verse ve ardından Verse Kodu Oluştur seçeneğine tıklayarak kodunu derle.
Büyütmek için görsele tıkla.
Derleme başarılı olduktan sonra Verse butonunun üzerinde yeşil bir onay işareti görünür. Derleme sırasında sorun oluşursa kırmızı bir durdurma simgesi görüntülenir ve tüm hataları çözene kadar kodunu derleyemezsin. Böyle bir durumda kodunu düzeltme ipuçları için Kodundaki Sorunları Giderme bölümüne bakabilirsin.
Büyütmek için görsele tıkla.
Kodun derlenmesi bittiğinde, UEFN araç çubuğunda Değişiklikleri Gönder ve Verse Değişikliklerini Gönder seçenekleri görünür. Değişiklikleri Gönder seçeneği, istemcini editörde yapılan nesne ekleme ve kaldırma, obje özelliklerini değiştirme ve Verse kodunda yapılan değişiklikler gibi tüm değişikliklerle günceller. Verse Değişikliklerini Gönder yalnızca Verse kodunu günceller ve Değişiklikleri Gönder seçeneğinden daha hızlıdır. Bu ikinci seçenek, oturumunu yenilemeden kodunda küçük, artımlı değişiklikler yapmak istediğin durumlarda faydalıdır. İstemcini güncellemek için Verse Değişikliklerini Gönder düğmesine tıkla.
Büyütmek için görsele tıkla.
Sunucu projeyi güncellemeyi tamamladığında Ana Menü’yü aç ve Oyunu Başlat butonuna tıkla.
Günlükte “Bu benim ilk Verse kodu satırım!” (This is my first line of Verse code!) ifadesini bul. Biraz önce koda bunu eklemiştin!
Sıralı Yürütme
Metni günlüğe yazdırmak için bu kod satırını eklediğinde "İşte bu benim ilk Verse kod satırım!" yazısı "2 + 2 = 4" ifadesinden sonra günlüğe yazılır. Bunun nedeni, söz konusu kod satırlarının OnBegin<override>()<suspends>:void= satırı altına yazıldıkları sırayla yürütülmesidir.
Yazdırma satırlarının sırasını değiştirirsen metin günlüğe yeni sırayla yazılır ve "İşte bu benim ilk Verse kod satırım!" yazısı "2 + 2 = 4" ifadesinin önüne koyulur:
OnBegin<override>()<suspends>:void=
#TODO: Replace this with your code
Print("Hello, world!")
Print("This is my first line of Verse code!")
Print("2 + 2 = {2 + 2}")Kod genellikle ifadelerin göründüğü sırayla satır satır yürütülür. Buna sıralı yürütme denir. Verse ile programlama hakkında daha fazla bilgi edindikçe programının davranışını değiştirmek için yürütme akışını nasıl şekillendireceğini öğreneceksin.
Kodundaki Sorunları Giderme
Artık ilk Verse kod satırını yazıp çalıştırdığına göre kod yazarken karşılaşabileceğin sorunları nasıl gidereceğini aşağıda bulabilirsin.
İki tür hata ile karşılaşabilirsin: derleyici hataları ve diğer hatalar.
Derleyici Hataları
Her yazıda olduğu gibi kodunda da yazım yanlışları olabilir. Bu yazım yanlışları, programdan yapmasını istediğin şeyi derleyicinin anlamasını engelleyebilir. Bunlar programın derlemesini önlediği için derleyici hataları olarak adlandırılır ve çoğunlukla sözdiziminde yapılan hatalardır. Bu hatalar, oynanış testinde kodunu çalıştırmanı engeller.
Visual Studio Code (VSC) bazı derleyici hatalarını algılayabilir ve dosya sekmesinde ve Explorer panelinde dosya adını kırmızıya dönüştürerek seni hatalar konusunda bilgilendirebilir.
VSC aynı zamanda bir sorun algıladığında satırına altına kırmızı bir dalgalı çizgi ekler. Dalgalı çizginin üzerine geldiğinde VSC'nin sunabileceği hızlı bir düzeltme varsa onu da içeren bir hata mesajı görüntülenir.
VSC tüm derleyici hatalarını algılamayabilir, bu nedenle herhangi bir hatayı erkenden yakalamak için kodunu çalıştırmayı denemeden önce kodu oluşturmak iyi bir uygulamadır. Bunu yapmak için Verse seçeneğine ve ardından UEFN araç çubuğundaki Verse Kodu Oluştur seçeneğine tıkla. Bu seçenek projedeki tüm Verse dosyalarını derler ve yazdığın kodu bilgisayar tarafından yürütülebilir talimatlara çevirir.
Büyütmek için görsele tıkla.
Kodun başarıyla oluşturulursa çıktı günlüğü bir başarı mesajı veya oynanış testi sırasında kodunu kullanmadan önce düzeltmen gereken hataları gösterir.
Verse Kodu Oluştur’u seçtiğinde bir derleme hatası varsa açılır bir mesaj da görüntülenir.
Açılır mesajda Hatalara Bak bağlantısına tıkladığında Mesaj Günlüğü penceresi açılır ve VS Code’un algılayabildiği tüm hataları gösterir.
Büyütmek için görsele tıkla.
Herhangi bir hatayı düzeltmeden önce kodu tekrar derleyebilir ve UEFN araç çubuğunda Verse Kodları Oluştur’a tekrar tıklayarak ya da açılır mesajdaki Yeniden Oluştur seçeneğine tıklayarak kodunun başarıyla oluşturulduğunu doğrulayabilirsin.
Hatalar
Kodun başarıyla derlendiğinde ancak programın beklediğin eylemleri gerçekleştirmediğinde bu sorunlara hata (bug) adı verilir. Hatalar kodundaki mantıkla ilgili sorunlardır ve onları bulmanın bir yolu günlüğe yazdırmaktır.
hello_world_device dosyasındaki kod, oyunu başlattığında kodun çalışıp çalışmadığını doğrulamak için günlüğe yazdırmanın nasıl kullanıldığına güzel bir örnektir.
OnBegin<override>()<suspends>:void=
#TODO: Replace this with your code
Print("Hello, world!")
Print("This is my first line of Verse code!")
Print("2 + 2 = {2 + 2}")Kodun beklediğin şekilde çalışıp çalışmadığını test etmek için değerleri de yazdırabilirsin. Aşağıdaki kodu çalıştırdığında günlükte "2 + 2 = 4" metni görünür:
Print("2 + 2 = {2 + 2}")
Metin günlüğe yazdırılmadan önce {2 + 2} ifadesinin 4 olup olmadığı değerlendirilir. Son satırda çift tırnakların " " içindeki süslü ayraçlar {} ifadenin metne dönüştürülmeden önce değerlendirilmesi gerektiği anlamına gelir. Bunun gibi bir dizeye değer eklemek dize ilişkilendirmesinin bir örneğidir.
Süslü ayraçların arasındaki ifadeyi değiştirirsen yazdırılan değer değişecektir. Aşağıdaki örnekte ifade {2 + 3} olarak değiştiğinden günlükte “2 + 2 = 5” görünür:
nBegin<override>()<suspends>:void=
#TODO: Replace this with your code
Print("Hello, world!")
Print("This is my first line of Verse code!")
Print("2 + 2 = {2 + 3}")
Sonraki Adımlar
Şimdi Verse’e kısa bir giriş yaptığına ve kodunu çalıştırıp sorunlarını giderme hakkında bilgi aldığına göre, genel programlama bilgini geliştirmek ve bu programlama aracından nasıl yararlanacağını öğrenmek için Verse’te Kod Yazmanın Temellerini Öğren bölümüne git.
Doğduğunda konsoldaki düğmeyle etkileşime girerek Verse Cihazları Başlangıç Şablonu mini oyununu da oynayabilirsin. Bu mini oyunun nasıl oluşturulduğunu Verse Başlangıç Şablonu bölümünü inceleyerek öğrenebilir ve Verse Gezgini’nde bu projede kullanılan kod dosyalarını inceleyebilirsin!