BentoBox ve BSkyBlock ile SkyBlock Kurulumu

BentoBox, Minecraft sunucularında SkyBlock ve benzeri ada tabanlı oyun modları kurmak için kullanılan modüler bir eklenti çerçevesidir. Klasik SkyBlock eklentilerinden farkı şu: BentoBox tek başına oyun kurmaz, altyapıyı kurar. Ada oluşturma, takım yönetimi, koruma bayrakları, rütbeler ve veri saklama çekirdekte durur; oynanışı ise üstüne taktığınız oyun modu eklentisi belirler.

Bu rehberde BentoBox mimarisini, doğru kurulum sırasını, ada şablonu (blueprint) seçimini ve düzenlemesini, ada boyutu ile aralık ayarlarını, Level eklentisiyle gelen ada seviyesi ve sıralamayı, ekonomi/mağaza bağlamayı, koruma bayraklarını ve dünya ayrımı ile chunk üretim yükünü bulacaksınız. Oyun modu tarafındaki genel kurguyu da Skyblock sunucusu nasıl kurulur sayfasında ele almıştık.

BentoBox mimarisi: çekirdek artı oyun modu#

BentoBox’ı anlamak için tek bir ayrımı kavramak yeterli: çekirdek ve eklenti (addon). Çekirdek plugins klasöründe normal bir jar olarak durur. Eklentiler ise plugins/BentoBox/addons/ klasörüne atılır ve Bukkit tarafından değil, BentoBox tarafından yüklenir. Bu yüzden bir oyun modu jar’ını yanlışlıkla plugins içine atarsanız hiçbir şey olmaz — konsolda hata bile görmeyebilirsiniz.

plugins/
├── BentoBox.jar
├── VaultUnlocked.jar
├── LuckPerms-Bukkit.jar
└── BentoBox/
    ├── config.yml
    ├── database/
    ├── blueprints/
    └── addons/
        ├── BSkyBlock.jar
        ├── Level.jar
        ├── Warps.jar
        └── Challenges.jar

Eklentiler ikiye ayrılır. Oyun modu eklentileri kendi dünyasını ve kendi /island komut ağacını getirir; en az bir tane kurmanız gerekir. Özellik eklentileri ise kurulu tüm oyun modlarına birden hizmet eder — Level, Warps, Challenges, Bank gibi. Aynı sunucuda birden çok oyun modunu yan yana çalıştırabilir, ortak özellikleri paylaştırabilirsiniz.

Hangi oyun modunu seçmelisiniz?#

Kurulum sırası (bu tabloya harfiyen uyun)#

BentoBox kurulumunda sıra gerçekten önemlidir; en sık gördüğümüz hata, addons klasörü daha oluşmadan oyun modu jar’ının kopyalanmaya çalışılması. Aşağıdaki sırayı bozmadan ilerleyin.

Eklenti kurulumunun genel mantığını bilmiyorsanız plugin kurulumu sayfası temel adımları anlatıyor. Sunucunuz henüz Paper değilse önce Paper sunucu kurulumunu tamamlayın.

Ada boyutu ve aralığı: en kritik iki sayı#

Dünya üretildikten sonra geri dönüşü olmayan tek ayar burasıdır, o yüzden ilk gün karar verin. İkisi de plugins/BentoBox/addons/BSkyBlock/config.yml dosyasındadır.

# plugins/BentoBox/addons/BSkyBlock/config.yml
world:
  friendly-name: BSkyBlock
  world-name: bskyblock_world
  difficulty: NORMAL
  distance-between-islands: 400
  protection-range: 50
  start-x: 0
  start-z: 0
  island-height: 80
  nether:
    generate: true
    islands: true
    roof: true
    spawn-radius: 25
    create-and-link-portals: false
  end:
    generate: true
    islands: true
    dragon-spawn: false
    create-obsidian-platform: false

island:
  max-team-size: 4
  max-homes: 1

Pratik öneri: distance-between-islands için 400 yerine 208 veya 256 gibi bir değer, küçük ve orta ölçekli sunucularda fazlasıyla yeterlidir ve üretilecek chunk sayısını ciddi biçimde düşürür. protection-range değerini ise başlangıçta düşük tutup ada seviyesi yükseldikçe büyütmek yaygın bir ödül tasarımıdır. island-height, adanın hangi Y seviyesinde doğacağını belirler; 80 iyi bir varsayılandır, çok düşük verirseniz oyuncuların aşağı doğru inşa alanı kalmaz.

Ada şablonu (blueprint) seçimi ve düzenlemesi#

Oyuncunun ilk açtığı ada, bir “blueprint” dosyasından basılır. BentoBox’ın blueprint sistemi WorldEdit’ten bağımsızdır; şablonlar düz JSON biçiminde .blueprint uzantısıyla saklanır, metin düzenleyiciyle açılabilir ve sürüm takibine alınabilir.

Şablonlar demet (bundle) hâlinde gruplanır. Bir demet en fazla üç ada içerir: normal dünya, nether ve end. Demete simge, açıklama ve yetki koşulu tanımlayabilirsiniz — böylece VIP oyunculara özel başlangıç adası verebilirsiniz. Oyuncu ada açarken, birden fazla demet varsa bir seçim paneli görür.

/bsb bp                 Blueprint yönetim panelini açar
/bsb bp pos1            Birinci köşeyi işaretler
/bsb bp pos2            İkinci köşeyi işaretler
/bsb bp copy            Seçili alanı panoya alır
/bsb bp copy air        Hava bloklarını da kopyalar
/bsb bp paste           Panodakini yapıştırır
/bsb bp save baslangic  baslangic.blueprint olarak kaydeder
/bsb bp load baslangic  Kayıtlı şablonu panoya yükler

Şablonu tasarlarken adaya ne koyduğunuza dikkat edin: başlangıç sandığındaki her eşya, sunucunuzun ekonomisine sıfırıncı günden itibaren enjekte edilen bir kaynaktır. Ada sıfırlama serbestse oyuncular sandığı boşaltıp adayı sıfırlayarak sonsuz kaynak üretebilir.

Ada seviyesi (Level) ve sıralama#

SkyBlock’ta rekabetin motoru ada seviyesidir. Bu özellik çekirdekte yoktur; Level eklentisini addons klasörüne atmanız gerekir. Eklenti, adadaki blokları tarar, her bloğun puan değerini toplar ve toplam puanı seviyeye çevirir.

/island level              Kendi adanızın seviyesini hesaplatır
/island top                İlk on adayı gösteren paneli açar
/island value diamond_block Bir bloğun kaç puan ettiğini gösterir
/bsbadmin level Emre       Bir oyuncunun adasını hesaplar
/bsbadmin top              İlk on adayı sohbete basar
/bsbadmin sethandicap Emre 5  Başlangıç seviyesini ayarlar

# plugins/BentoBox/addons/Level/config.yml
levelcost: 100
levelwait: 60
deathpenalty: 100

levelcost, bir seviyenin kaç puana denk geldiğini belirler; yükseltirseniz ilerleme yavaşlar. levelwait iki hesaplama arasındaki bekleme süresidir (saniye) — bunu düşürmeyin, çünkü her hesaplama adanın tüm bloklarını tarar ve büyük adalarda TPS’i zorlar. deathpenalty, her ölümde düşülecek puan miktarıdır; hardcore his veren sunucularda etkili bir dengeleyicidir.

Blok puanları blockconfig.yml dosyasında tutulur ve burada blok başına üst sınır (limits) da tanımlayabilirsiniz. Bu sınır, bir oyuncunun on bin taş bloğu yığıp sıralamayı ele geçirmesini engeller. Sıralamayı adil tutmanın en pratik yolu budur.

Ekonomi ve mağaza bağlama#

BentoBox kendi para birimini getirmez. Ekonomi zinciri şöyle kurulur: Vault köprüsü → ekonomi eklentisi → mağaza eklentisi. 26.2 sunucularında orijinal Vault yerine VaultUnlocked kullanmak daha güvenlidir; orijinal Vault’un son yayını 2020’de kalmıştır ve 26.x’i resmen listelemez.

# plugins/QuickShop-Hikari/config.yml
shop:
  display-protocol: 'packetevents'

Mağaza tarafında 26.2 için en sağlam seçenek QuickShop-Hikari’dir. Kritik ayrıntı şu: QuickShop bir protokol kütüphanesine ihtiyaç duyar ve ProtocolLib’in kararlı sürümü 26.x’i desteklemez. Bu yüzden PacketEvents kurup yukarıdaki anahtarı packetevents olarak ayarlamanız gerekir. Vault ve PlaceholderAPI ikilisinin ne işe yaradığını bu sayfada, mağaza kurulumunu shop eklentisi kurma rehberinde, para akışının tasarımını ise ekonomi sistemi kurma sayfasında ele aldık.

Ada bazlı ortak kasa isterseniz BentoBox’ın Bank eklentisi tam olarak bunu yapar: takım üyeleri ortak bir hesaba para yatırır, ada harcamaları buradan karşılanır. Kurulumu diğer özellik eklentileriyle aynı — jar’ı addons klasörüne atıp yeniden başlatmak yeterli.

Ada koruma bayrakları#

Bayraklar (flags), ada sınırları içinde neyin serbest neyin yasak olduğunu belirler; WorldGuard’ın bölge flag’lerine benzer bir mantıkla çalışır ama ada başına ve rütbe başına ayarlanır. İki katman vardır: yöneticinin belirlediği dünya varsayılanları ve ada sahibinin kendi adası için yaptığı değişiklikler.

/bsbadmin settings     Dünya genelindeki varsayılan bayrakları açar
/island settings       Ada sahibinin kendi bayrak panelini açar
/bentobox rank         Rütbe tanımlarını yönetir
/bentobox reload       Ayarları ve dil dosyalarını yeniden yükler

Her bayrak için “bunu hangi rütbe değiştirebilir” tanımı da yapılır. Yani ziyaretçi, güvenilen, üye ve ortak sahip rütbelerine farklı yetkiler verebilirsiniz. Kurulumdan sonra ilk yapmanız gereken şey, misafir hesabıyla başka bir adaya gidip gerçekten hiçbir şeye dokunamadığınızı doğrulamak. Bu testi atlayanların yarısı, açılış gününde ilk grief şikâyetiyle karşılaşıyor.

Dünyayı ayrı tutma ve chunk üretim yükü#

Oyun modu eklentisi kendi dünyasını kendisi üretir ve yönetir; world-name anahtarındaki isimle (varsayılan bskyblock_world) oluşur, yanına _nether ve _the_end eklenir. Bu dünyaları Multiverse ile yeniden içe aktarmaya çalışmayın — çift yönetim, oyun modu dünyalarında spawn ve teleport sorunlarına yol açar. Multiverse’i yalnızca ada dışındaki dünyalar (spawn, etkinlik, market) için kullanın; Multiverse rehberindeki komutlar o dünyalar için geçerlidir.

Performans tarafındaki yaygın yanılgı, “SkyBlock dünyası boş, o yüzden hafiftir” cümlesi. Doğru olan yarısı: boşluk üretmek vanilla arazi üretmekten ucuzdur, mağara ve yapı hesabı yoktur. Yanlış olan yarısı ise şu — herşey ada sayısına bağlı. Her yeni ada haritanın bakir bir noktasında chunk üretimi tetikler; her aktif ada kendi mob’unu, hopper’ını ve çiftliğini tick’ler. Beş yüz adalık bir sunucuda dünya klasörü rahatlıkla onlarca GB’a çıkar.

• Ada aralığını gereksiz büyük tutmayın. 400 yerine 208 seçmek, aynı ada sayısı için çok daha az chunk demektir.
• Açılıştan önce merkez bölgeyi ön üretin. Yöntem chunk ön üretimi sayfasında.
• Terk edilmiş adaları temizleyin. Uzun süredir girilmeyen adaların silinmesi hem disk hem tick yükü kazandırır.
• Nether ve End’i gerçekten kullanacak mısınız? Kullanmayacaksanız generate: false yapmak iki dünyanın yükünü tamamen kaldırır.
• Yedek almadan ayar değiştirmeyin. Yedekleme rehberindeki akışa plugins/BentoBox klasörünü de ekleyin.

Donanımda belirleyici olan çekirdek sayısı değil saat hızıdır; ana tick döngüsü tek çekirdekte koşar. Çok dünyalı bir SkyBlock sunucusu için 16 GB RAM, yüksek frekanslı AMD Ryzen 9 işlemci ve NVMe SSD ile başlayın, heap’i -Xms14G -Xmx14G verin. Oyuncu sayısına göre ayrıntılı tablo RAM rehberinde; hazır paketleri ise Minecraft sunucu paketleri sayfasında karşılaştırabilirsiniz.

Özetle#

BentoBox ile SkyBlock kurulumunun tamamı doğru sıraya bağlı: BentoBox jar’ını plugins içine atın, sunucuyu bir kez başlatıp durdurun, oluşan plugins/BentoBox/addons/ klasörüne oyun modu eklentisini (BSkyBlock, AOneBlock ya da AcidIsland) ve Level gibi özellik eklentilerini koyun, sonra yeniden başlatın. Bu sırayı bozmak, “eklentiyi attım ama görünmüyor” tipindeki sorunların neredeyse tek kaynağı.

Dünya üretilmeden önce iki sayıyı kesinleştirin: distance-between-islands ve protection-range. İkisi de yarıçaptır, gerçek genişlik iki katıdır ve aralık değeri sonradan değiştirilemez. Ardından [spawn_here] tabelasını unutmadan kendi blueprint’inizi hazırlayın, Level eklentisiyle sıralamayı açın, ekonomi zincirini VaultUnlocked üzerinden kurup mağazayı PacketEvents ile çalıştırın ve bayrak varsayılanlarını misafir hesabıyla test edin. Kurulum sırasında takıldığınız bir nokta olursa destek talebi açarak sistem ekibimizden yardım isteyebilirsiniz.