Tanıtım Yamipa | Resim Yerleştirme Eklentisi

Yamipa, Minecraft sunucunuzdaki herhangi bir yüzeye istediğiniz bir görüntüyü (resim, fotoğraf) yerleştirmenizi sağlayan bir Spigot eklentisidir.

Performans ve uyumluluk göz önünde bulundurularak tasarlanmıştır, bu nedenle en düşük özellikli sunucular bile çalıştırabilir.

Kurulum
En son için JAR dosyasını indirin ve diğer eklentilerde yaptığınız gibi Minecraft sunucunuzun "plugins" dizinine kopyalayın. İşte bu kadar!

Gereksinimler
Yamipa'yı kurmadan önce aşağıdaki gereksinimleri karşıladığınızdan emin olun:

• CraftBukkit, Spigot veya PaperMC 1.16 veya üstü olmalı.
• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
  v5.0.0 veya üstü olmalı.

Yapılandırma
Yamipa kurulur kurulmaz kullanıma hazırdır. Varsayılan olarak, plugins/YamipaPlugin dizini altında aşağıdaki dosya ve dizinleri oluşturur:

• cache: Oluşturma işlemini hızlandırmak için önbelleğe alınmış görüntüleri içeren bir dizin. İçeriğini değiştirmemelisiniz.
• images: Bu, Minecraft dünyanıza yerleştirmek istediğiniz görüntü dosyalarını koyduğunuz dizindir.
• images.dat: Sunucunuzdaki tüm yerleştirilmiş resimlerin listesini ve özelliklerini (örn. koordinatlar) tutan bir dosya. İçeriğini değiştirmemelisiniz.

Eklenti yapılandırma dizininde bir config.yml dosyası oluşturarak bu dosyaların yolunu değiştirebilirsiniz. Belirtmediğiniz takdirde varsayılan yapılandırma değerleri şunlardır:

verbose: false # Daha ayrıntılı günlüğe kaydetmeyi etkinleştirmek için "true" olarak ayarlayın
animate-images: true # GIF desteğini devre dışı bırakmak için "false" olarak ayarlayın
images-path: images # Görüntüler dizininin yolu
cache-path: cache # Önbellek dizininin yolu
data-path: images.dat # Yerleştirilen resimler veritabanı dosyasının yolu
allowed-paths: null # Erişilebilir görüntüleri oyuncularla sınırlamak için bir RegExp olarak ayarlayın
max-image-dimension: 30 # Görüntülerde izin verilen bloklar halinde maksimum genişlik veya yükseklik

Kullanım
Bu eklenti aşağıdaki komutları ekler:

• /image clear <x z world> <r> [<placed-by>]: Bir orijin etrafındaki r blok yarıçapındaki tüm yerleştirilmiş görüntüleri kaldırın.
• /image describe: Yerleştirilen bir görüntü hakkında ayrıntılı bilgi gösterin.
• /image download <url> <dosya adı>: Bir URL'den bir görüntü indirin ve görüntüler dizinine yerleştirin.
• /image give <player> <dosya adı> <miktar> <w> [<h>] [<bayraklar>]: Bir oyuncuya daha sonra yerleştirilebilecek görüntü öğeleri verin.
• /image list [<sayfa>]:Görüntüler dizinindeki mevcut tüm dosyaları listeler.
• /image place <dosya adı> <w> [<h>] [<bayraklar>]: wxh blok boyutunda bir görüntü yerleştirin.
• /image remove: Yerleştirilmiş bir görüntüyü, görüntü dosyasını silmeden dünyadan kaldırın.
• /image top: En çok yerleştirilen resimlere sahip oyuncuları listeleyin.

Örnekler

• Yardım göster
  /image
• Bir URL'den görüntü indirme ve başka bir adla kaydetme
  /image download "
  Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
  " imagename.jpg
• "Test.jpg" görüntüsü için "TestPlayer" isimli oyuncuya 10 resim öğesi verin (3x5 blok)
  /image give TestPlayer test.jpg 10 3 5
• "TestPlayer" isimli oyuncuya 10 resim öğesi, kaldırıldığında bir resim öğesini bırakmayacak
  /image give TestPlayer test.jpg 10 3 5 -DROP
• Genişliği 3 blok ve yüksekliği otomatik olan bir görüntü yerleştirmek için iletişim kutusunu başlatın
  /image place imagename.jpg 3
• 3-blok genişliğinde ve 2-blok yüksekliğinde bir görüntü yerleştirmek için iletişim kutusunu başlatın
  /image place imagename.jpg 3 2
• Karanlıkta parlayan bir görüntü yerleştirmek için iletişim kutusunu başlatın
  /image place imagename.jpg 3 2 +GLOW
• Orijinal dosyayı korurken yerleştirilmiş bir görüntüyü kaldırmak için iletişim kutusunu başlatın
  /image remove
• Spawn etrafında 5 blokluk bir yarıçap içinde yerleştirilmiş tüm görüntüleri kaldırın
  /image clear 0 0 world 5
• "EvilPlayer" tarafından nether'da 100 blokluk bir yarıçap içinde yerleştirilen tüm resimleri kaldırın
  /image clear 50 70 world_nether 100 EvilPlayer
• Tüm eski yerleştirilmiş görüntüleri kaldırın ("tarafından yerleştirildi" meta verileri olmadan)
  /image clear 0 0 world 9999999 00000000-0000-0000-0000-000000000000

İzinler


İzinlerin bir ağaç olarak çalıştığını unutmayın. Bu, bir izin verdiğinizde varsayılan olarak alt izinlerinin de verileceği anlamına gelir. Örneğin, yamipa.command.* ile tüm komutlara erişim izni verebilirsiniz. Benzer şekilde, yamipa.command.remove iznini verirseniz, yamipa.command.remove.own izni de verilecektir.

veya gibi bir izin eklentisi kullanarak bu komutların hangi rollere veya oyunculara verildiğini değiştirebilirsiniz. Bu eklentilerin her ikisi de Yamipa ile çalışacak şekilde test edilmiştir, ancak benzer herhangi bir eklenti de gayet iyi çalışacaktır.

Oyuncu değişkenleri
gibi bazı izin eklentileri, sunucu operatörlerinin varlıklara sanki izinlermiş gibi atamasına olanak tanır. Bu, farklı oyunculara veya gruplara farklı yetenekler vermek için kullanışlıdır.

Yamipa aşağıdaki değişkenleri arar ve bulunması halinde tüm oyuncular için geçerli olan varsayılan yapılandırma değerini geçersiz kılar:


Örneğin, sadece "test" oynatıcısı için görüntü boyutunu 5x5 blokla sınırlamak istiyorsanız, bu komutu çalıştırabilirsiniz:

# LuckPerms Kullanımı
/lp user test meta set yamipa-max-image-dimension 5

# GroupManager Kullanımı
/manuaddv test yamipa-max-image-dimension 5

Koruma alanları
Büyük sunucularda, oyuncularınızın resimleri istedikleri yere yerleştirmelerine ve kaldırmalarına izin vermek en mantıklı fikir olmayabilir. Bu gibi durumlar için Yamipa, dünya alanları oluşturmaya ve yönetmeye izin veren diğer Bukkit eklentileriyle uyumludur. Bu tür eklentilerden bir veya daha fazlasına sahipseniz, Yamipa izinleri otomatik olarak buna göre uygular ve oyuncuların yalnızca blok yerleştirebilecekleri veya kaldırabilecekleri yerlere resim yerleştirmelerine veya kaldırmalarına izin verir, ek yapılandırma gerekmez.

Desteklenen eklentiler şunlardır:

• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.

Bayraklar
Bu eklentideki resimler, davranışını değiştiren "flags" (Türkçesi "bayraklar") adı verilen bir dizi boolean niteliğe sahiptir. Olası değerler şunlardır:

• ANIM (animasyonlandırılabilir): Bir görüntünün animasyonlu olup olmayacağı, bir GIF görüntüsünün oynatılmasını istemediğinizde kullanışlıdır.
• REMO (kaldırılabilir): Bir görüntünün herhangi bir oyuncu tarafından sol tıklanarak kaldırılıp kaldırılamayacağı.
• DROP (düşürülebilir): Bir resim herhangi bir oyuncu tarafından kaldırıldığında bir resim öğesi düşürüp düşürmeyeceği.
• GLOW (parıltılı): Bir görüntünün karanlıkta parlayıp parlamadığı (yalnızca Minecraft 1.17 ve üzeri sürümlerde çalışır).

Varsayılan olarak, "/image place" komutuyla yerleştirilen görüntüler yalnızca ANIM bayrağına sahiptir. Benzer şekilde, "/image give" komutuyla verilen görüntü öğeleri ANIM, REMO ve DROP bayraklarına sahiptir.

Varsayılan bayraklar "flags" argümanı aracılığıyla değiştirilebilir. Varsayılan bayraklara bir bayrak eklemek için "+{FLAG_NAME}" (örneğin +GLOW), kaldırmak için ise "-{FLAG_NAME}" (örneğin -ANIM) kullanın. Birden fazla bayrağı virgülle ayırarak değiştirebilirsiniz (örn. +GLOW,-ANIM).

Çok teşekkürler