Spigot|Bukkit Eklenti Kodlama Rehberi Bölüm(1)
İlk olarak bu tür bir rehbere başlama sebebimi açıklayayım.
Bu konuda yaklaşık 4-5 aydır yoğunlaştım ve bu süre zarfında kaynağa ihtiyacım oldu.
Fakat ne yazık ki yeterli kaynak bulamadım , bulduysam da anlatımlarda hep yabancı dil kullanılmıştı.
Bu seri boyunca sizlerle yorumlar aracılığıyla etkileşim içinde olup, rehberimi sürdüreceğim.
Eksikleri veya istediğiniz kısımları yorum olarak belirtmekten çekinmeyin.
Çalışma Ortamının Hazırlanması
-İlk olarak Java dilinde yazdığımız kodların makine diline çevrilmesi için bir derleyiciye ihtiyacımız var.
Sizlere 2 adet derleyici önereceğim ilk olarak Eclipse ikinci olarak ise IntelliJIDEA(ücretlidir) .
Benim tavsiyem başlangıç için eclipseden yana çünkü kendisi ücretsiz bir derleyicidir.
Eclipse Orjinal Sitesi
Kurulum oldukça basittir.Bunu yaptığınızı varsayarak derse devam ediyorum.
Şimdi ise Java ile eklenti veya herhangi bir yazılım oluşturmak istiyorsanız JDK yani Java Development Kit'e ihtiyacınız var.
Bunu da aşağıdan temin edip hızlı bir kurulumla işlemi tamamlayabilirsiniz.
JDK Orjinal Sitesi
Daha sonra ise bize eklenti yazmamız için bir kütüphane gerek.Peki nedir bu kütüphane kavramı?
Burada kullandığımız kütüphane kavramı hemen hemen gerçek hayatta kullandığımız kütüphane kavramı ile eşdeğer.
Nasıl ki gerçek hayatta bilgi edinmek için kütüphaneyi kullanırız.Eklenti yazarken de kütüphaneden oyunumuza(Minecraft) dair daha önceden yazılmış ve tanımlı olan bilgileri edineceğiz.
Bu kütüphane kurulurken ihtiyacınız olan platformu belirlemeniz gerekir. Spigot için yazmak istiyorsanız Spigot , Bukkit için yazmak istiyorsanız Bukkit kütüphanesini edinmelisiniz.Benim tavsiyem şu an aşırı rövanşta ve güncel olan spigottan yana bu yüzden Spigotu kullandığımızı varsayacağım.
Alttaki linkten istediğiniz sürümü indirebilirsiniz.
Sürümünüze dikkat edin çünkü yazdığınız eklentiler yalnızca o sürümde çalışabilir.
Spigot Kütüphanesi Edinme
Bu kütüphaneyi bir yerde saklayın ileride lazım olacak.
İlk Eklentiyi Yazmak
Üstteki tüm adımları yaptıysanız artık eklenti yazmaya geçebilirsiniz.
İlk olarak Eclipseyi açıp yeni bir proje oluşturmamız gerek.
Burdan sonra next diyerek kütüphanemizi projemize eklememiz gerekir.
Next deyip devam etmemiz ve alttaki adımları yapmamız gerek.
Daha sonra ilk başta projemizi oluşturduğumuz gibi yani sol altta bulunan projemizdeki sekmeleri açıp src isimli bölüme sağ tıklayıp new deyip package kısmını seçmemiz gerek daha sonra alttaki gibi bir sayfa ile karşılaşacaksınız.
Burada package'e yani pakete verdiğiniz isim çok önemli mutlaka me.kalerda gibi bir etiketi olması gerek bunu kendinize göre değiştirip me.biber de yapabilirsiniz.
Daha sonra yine aynı şekilde ama bu sefer oluşturduğumuz package yani paketimize sağ tıklayarak yeni class oluşturuyoruz.
Ve karşımıza alttaki gibi bir pencere açılacak, bu pencere bizim kodlarımızı yazdığımız kısım.
Şuna dikkat edin /* ve */ arasındaki yazılar asla çalışmaz size daha rahat anlatabilmek adına yazdım.Normalde bu şekilde yazarsanız o satırlardaki yazılar kod olarak algılanmaz.
Daha sonra eklentinin bize ait olduğunu belirtmek adına projemizde plugin.yml isimli bir dosya açıyoruz.
Plugin.yml dosyamızda olmazsa olmaz 3 kural vardır.
1. Kesinlikle author: yazarismi olması gerekir.
2.Kesinlikle version: 1.0 şeklinde versiyon belirtmemiz gerekir.
3. Kesinlikle ana(main) sınıfımızın(class) yerini belirtmemiz gerekir.
Ana sınıfımızın yerini belirtmek için başta oluşturduğumuz paketimiz(package)'in ismi ve ana sınıfımızın ismine ihtiyacımız var.
Daha sonra ilk olarak paketimizin ismi ile ana sınıfımızın ismi arasına nokta(.) koyup ana sınıfımızın ismini yazıyoruz ve ana sınıfımızın yerini belirtmiş oluyoruz.
Son olarak artık eklentimizi export edip kullanıma hazır hale getirmemiz gerek.
Bunu ise şu şekilde yapıyoruz.
En son ekranın sol tarafında şu şekilde bir düzenle karşılaşmamız gerekir.
Eklentimizi sunucumuzun plugins klasörüne atıp çalıştıralım ve deneyelim.
Tebrikler eğer buraya kadar hatasız bir şekilde geldiyseniz kendinizi tebrik edip kutlayabilirsiniz.
Çünkü ilk eklentinizi başarıyla yazdınız.
:8
Arkadaşlar lütfen anlamadığınız veya yapamadığınız kısımları altta belirtin gerekirse tekrar güncellerim konuyu ve yorumlar kısmından sizlere yardımcı olurum.Rehber hoşunuza gittiyse elmas vermeyi ihmal etmeyin.
İyi Forumlar Dilerim...
Daha sonra eklentinin bize ait olduğunu belirtmek adına projemizde plugin.yml isimli bir dosya açıyoruz.
Plugin.yml dosyamızda olmazsa olmaz 3 kural vardır.
1. Kesinlikle author: yazarismi olması gerekir.
2.Kesinlikle version: 1.0 şeklinde versiyon belirtmemiz gerekir.
3. Kesinlikle ana(main) sınıfımızın(class) yerini belirtmemiz gerekir.
Ana sınıfımızın yerini belirtmek için başta oluşturduğumuz paketimiz(package)'in ismi ve ana sınıfımızın ismine ihtiyacımız var.
Daha sonra ilk olarak paketimizin ismi ile ana sınıfımızın ismi arasına nokta(.) koyup ana sınıfımızın ismini yazıyoruz ve ana sınıfımızın yerini belirtmiş oluyoruz.
Son olarak artık eklentimizi export edip kullanıma hazır hale getirmemiz gerek.
Bunu ise şu şekilde yapıyoruz.
En son ekranın sol tarafında şu şekilde bir düzenle karşılaşmamız gerekir.
Eklentimizi sunucumuzun plugins klasörüne atıp çalıştıralım ve deneyelim.
Tebrikler eğer buraya kadar hatasız bir şekilde geldiyseniz kendinizi tebrik edip kutlayabilirsiniz.
Çünkü ilk eklentinizi başarıyla yazdınız.
:8
Arkadaşlar lütfen anlamadığınız veya yapamadığınız kısımları altta belirtin gerekirse tekrar güncellerim konuyu ve yorumlar kısmından sizlere yardımcı olurum.Rehber hoşunuza gittiyse elmas vermeyi ihmal etmeyin.
İyi Forumlar Dilerim...
Son düzenleme: