plugin.yml güncelleme

Eklentiler için önemli olan plugin.yml güncelleme işlemi hakkında bilinmesi gerekenleri bu başlık altında rehber olarak hazırladık.

Minecraft sunucusu yönetirken Spigot veya Bukkit gibi bir yazılım kullanıldığında eklenti desteğine yer verilir. Plugin olarak isimlendirilen bu eklentilerin içerisinde “plugin.yml” isminde bir dosya olur. Bu dosya, eklenti için çeşitli ayarlara yer veriyor. Eğer bu dosya olmasaydı eklentinin nasıl çalışacağı belirlenemezdi. Özetle “plugin.yml” dosyası, eklentiler için oldukça önemli bir yapı sunuyor.

Buna şu şekilde örnek verelim: Bir ürün satın aldınız diyelim. Ürün montajlanmamış olsun. Ürünün nasıl kurulacağını öğrenmek için bir kılavuz kullanırsınız. İşte bu kılavuz, eklenti için “plugin.yml” olarak adlandırılıyor.

plugin.yml güncelleme

Plugin.yml Nedir?

Öncelikle bu dosyanın ne olduğundan ve içeriğinden kısaca bahsedelim. Bu dosya, eklenti ile ilgili çeşitli bilgiler içeren bir format sunuyor. YML biçiminde kayıt edilen bu dosyada eklentinin ana sınıfı, eklenti sürümü, API sürümü ve bağımlılıklar gibi birçok bilgiye yer veriliyor.

Şöyle bir örnek vererek YML dosyasının ne işe yaradığını daha iyi anlamanızı istiyoruz. Bu dosya ile birlikte hangi eklentilerin gerekli olduğu belirlenebiliyor. Sunucu başlatılırken bu eklenti için diğer eklentilerin varlığı incelenir. Sonrasında ana eklenti başlar.

plugin.yml güncelleme

Plugin.yml Nerede Yer Alır?

Sizlere plugin.yml güncelleme hakkında bilgiler sunmadan önce bu dosyanın nerede yer aldığını açıklamak istiyoruz. Bu dosyanın konumu eklenti dosyasının içerisindedir. Eklenti, JAR dosyası olarak bulunuyor. Eğer bu dosyaya WinRar gibi bir uygulama ile girilir ise ana dizindeplugin.yml” dosyasıyla karşılaşılacak. Eklenti kodlarken de bu dosya, gerektiğinde güncellenmeli.

Plugin.yml Güncelleme Nasıl Yapılır?

Bu dosyayı güncellemek için eklentiyi geliştirirken eklentinin ana dizinindekiplugin.yml” dosyası açılmalı ve istenen değişkenler ile değerler eklenmeli. Bunları sizler için bu başlık altında tek tek açıklamış olacağız. Öncelikle olmazsa olmaz değişkenlerden bahsedelim. Sonrasında diğer değişkenleri açıklayalım.

plugin.yml güncelleme

Bir değişken eklemek için satır şu şekilde olmalı: “name: PluginName”. YML’de format genel olarak bu şekilde olsa da şunu belirtelim ki değişkenlerin alt değişkenleri de olabiliyor. Bir değişkene birden fazla değişken eklemek için değişkeni ekledikten sonra alt satıra geçip TAB tuşuna basılmalı.

İlk değişkenimiz “name”. Bu değişken, eklentinin adını belirliyor. Bir diğer değişken ise “author” olarak yer alıyor. Bu da eklentinin sahibini belirtmek için kullanılıyor. Eklenti sürümünü belirtmek için ise “version” değişkeni eklenmeli.

En önemli değişkenlerden birisi “main” olarak yer almakta. Bu değişken, ana eklenti sınıfını belirtmek için kullanılıyor. Örneğin eklenti, proje içerisinde “plugin/main.java” olarak yer alabilir. Bu durumda yapılması gereken şey değer olarak “plugin.main” eklemek. Evet, slash işareti yerine nokta kullanmak ve uzantıyı eklememek gerekiyor.

plugin.yml güncelleme

Bir diğer değişken “commands” olmakta. Bu değişkenin alt değişkenleri bulunuyor. Alt değişkenler, komutlar olacak. Eklentide yer alan tüm komutlar buraya eklenmeli, yoksa kod olarak eklenen komut çalışmaz.

Bunlar, kullanılması gereken değişkenler olsa da 1.13 sürümünden sonra “api-version” değişkenini de kullanmak gerekiyor. Bu değişken, eklentinin API sürümünü belirtir. Yani sunucuyu geliştirirken hangi sürüm kullanılacak ise o API sürümüne yer verilmeli.

Plugin.yml” dosyasında zorunlu olarak bulunması gereken 3 değişken var. Bunlar “main, name ve version”. Diğer değişkenler eğer gerekirse eklenmeli. Misal eğer komutlar eklediyseniz “commands” değişkenine yer vermelisiniz.

Aşağıdaki tabloda plugin.yml güncelleme işlemi yapmak isteyenler için tüm değişkenlerin bir listesini yayınlıyoruz.

mainEklentinin ilk olarak çalıştırılacak olan sınıfının yolunu belirtir.
nameEklenti ismidir.
versionEklenti sürümüdür.
descriptionEklenti için açıklama ekler.
api-version1.13 ve sonraki sürümler için Spigot API sürümünü belirtir.
loadEklentinin ne zaman yükleneceğini açıklar. “STARTUP” başlangıçta, “POSTWORLD” ise dünya yüklendikten sonra eklentiyi yükler.
authorEklenti sahibidir.
authorsBirden fazla eklenti sahibi var ise yazılmalı.
websiteWeb sitesi paylaşmak için kullanılmalı.
dependGerekli olan eklentiler buraya eklenmeli.
softdependZorunlu olmayan fakat olduğunda ek özellikler açılacak ise bu eklentiler bu değişkenin içerisine yazılmalı.
prefixEklentiye ön ek eklemek için kullanılır.
loadbeforeEğer eklenti yüklendikten sonra yüklenmesi gereken eklentiler var ise buradan belirtilmeli. Bu, öncelik sırasını ayarlar.
librariesEklentinin ihtiyaç duyduğu kitaplıklara burada yer verilmeli.
commandsKomut listesi burada bulunmalı.
permissionsKomutların yetkileri buraya eklenmeli.
plugin.yml güncelleme

Örnek Plugin.yml Dosyası

main: plugin.batihostplugin.core.main

name: Batıhost Plugin

version: 1.0

description: Batıhost oyuncularına özel eklenti.

load: POSTWORLD

author: Erkan_Babadagi

depend: [WorldEdit, WorldGuard, Essentials]

commands:

Ekonomi:

description: Ekonomi bilgileri yer alır.

permission: batihost.economy

Hesap:

Yardım:

Eğer sen de sunucu kurmak istiyorsan hemen Minecraft server kirala!

Konuyu nasıl buldun?
0
0
0
0
0

Bir yanıt yazın

E-posta hesabınız yayımlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir