WorldEdit ve WorldGuard ile Bölge Koruma ve Harita Düzenleme

WorldEdit ve WorldGuard, bir Minecraft sunucusunda hem haritayı hızlı düzenlemek hem de bölge koruma kurmak için kullanılan iki temel eklentidir. WorldEdit seçtiğiniz alandaki binlerce bloğu tek komutla değiştirir; WorldGuard ise aynı seçim aracıyla tanımladığınız alanı grief’e, PvP’ye, patlamaya veya sandık açmaya karşı kilitler. İkisi aynı ekip (EngineHub) tarafından geliştirilir ve WorldGuard, WorldEdit olmadan başlamaz.

Bu rehberde Minecraft 26.2 üzerinde doğru jar sürümlerini seçmeyi, kurulumu, WorldEdit’in gerçekten işe yarayan komutlarını, WorldGuard bölge tanımlamayı ve en çok kullanılan flag’lerin tam listesini bulacaksınız. Eklenti kurulumunun temelini bilmiyorsanız önce Minecraft sunucusuna plugin kurulumu sayfasına göz atın.

WorldEdit ve WorldGuard ne işe yarar?#

İki eklenti sık sık birlikte anılır ama işleri tamamen farklıdır. Karıştırmamak için basit ayrım şu: WorldEdit blokları değiştirir, WorldGuard blokları korur.

Sunucunuzda grief sorunları yaşıyorsanız WorldGuard tek başına çözüm değildir; log tutan bir eklentiyle birlikte kullanılmalıdır. Bu konudaki bütünsel yaklaşım için Minecraft griefing nasıl önlenir rehberine bakın.

2026 sürüm uyumluluğu: hangi jar’ı indirmelisiniz?#

Minecraft 26.1 ile birlikte Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı. Bu bir ABI kırılmasıdır: NMS’e dokunan her eklenti yeniden derlenmek zorunda kaldı. Dolayısıyla 1.21.11 döneminden kalma bir WorldEdit veya WorldGuard jar’ı 26.x sunucusunda yüklenmez, konsola NoClassDefFoundError yağdırır.

Kurulum: iki eklentiyi doğru sırayla yükleme#

WorldEdit ve WorldGuard, Paper ve Spigot tabanlı tüm sunucularda aynı şekilde kurulur. Vanilla sunucu jar’ında eklenti desteği olmadığı için önce Paper sunucu kurulumu adımlarını tamamlamış olmanız gerekir.

1. Sunucuyu durdurun#

   Konsola stop yazın. Eklentileri sunucu çalışırken kopyalamak yarım yüklenmiş jar’lara ve bozuk yapılandırmaya yol açar.

2. Jar dosyalarını plugins klasörüne kopyalayın#

   Klasör yapısı şu şekilde olmalı:

   sunucu/
   ├── paper-26.2-112.jar
   ├── server.properties
   └── plugins/
       ├── LuckPerms-Bukkit-5.5.57.jar
       ├── worldedit-bukkit-7.4.5.jar
       └── worldguard-bukkit-7.0.18.jar

3. Sunucuyu başlatın ve konsolu okuyun#

   Açılışta şu iki satırı görmelisiniz. WorldGuard satırı yoksa bağımlılık sorunu vardır:

   [INFO]: [WorldEdit] Enabling WorldEdit v7.4.5
   [INFO]: [WorldGuard] Enabling WorldGuard v7.0.18
   [INFO]: [WorldGuard] (world) TNT ignition is PERMITTED.

4. Yapılandırma dosyalarının oluştuğunu doğrulayın#

   İlk açılıştan sonra plugins/WorldEdit/config.yml, plugins/WorldGuard/config.yml ve dünya başına plugins/WorldGuard/worlds/world/config.yml dosyaları oluşur. Ayarları bu dosyalardan yapacaksınız.

5. Kendinize wand verin#

   Oyun içinde //wand yazın. Elinize tahta balta gelir: sol tık birinci köşeyi, sağ tık ikinci köşeyi seçer.

WorldEdit ile bölge seçme ve temel düzenleme komutları#

WorldEdit’in tamamı “önce seç, sonra uygula” mantığına dayanır. Seçim kübiktir: iki köşe arasındaki dikdörtgenler prizmasını kapsar.

Seçim komutları#

//wand              Seçim baltasını verir (sol tık: pos1, sağ tık: pos2)
//pos1              Durduğunuz bloğu birinci köşe yapar
//pos2              Durduğunuz bloğu ikinci köşe yapar
//hpos1             Baktığınız bloğu birinci köşe yapar
//expand 10 up      Seçimi 10 blok yukarı büyütür
//expand vert       Seçimi tabandan gökyüzüne kadar dikey genişletir
//contract 5 north  Seçimi kuzeyden 5 blok daraltır
//outset 3          Seçimi her yönde 3 blok büyütür
//shift 12 east     Seçimi olduğu gibi 12 blok doğuya kaydırır
//size               Seçilen blok sayısını ve boyutu gösterir
//count stone        Seçim içindeki taş sayısını sayar

Blok değiştirme komutları#

//set stone                     Seçimi tamamen taşla doldurur
//set air                       Seçimi boşaltır
//replace dirt grass_block      Sadece toprağı çime çevirir
//replace #solid glass          Katı blokların tamamını cama çevirir
//walls cobblestone             Sadece dört duvarı örer
//faces stone_bricks            Duvar + taban + tavan kaplar
//hollow                        Dolu yapının içini boşaltır
//overlay snow                  Yüzeyin bir blok üstüne kar serper
//smooth 2                      Araziyi iki tur yumuşatır
//naturalize                    Taşı yüzeyden aşağı çim/toprak/taş katmanına çevirir
//drain 15                      15 blok yarıçapındaki suyu boşaltır
//regen                         Seçili chunk’ları dünya tohumuna göre sıfırlar
//undo                          Son işlemi geri alır
//redo                          Geri alınan işlemi tekrarlar

Ağırlıklı blok karışımı için yüzde sözdizimi kullanılır: //set 70%stone,20%andesite,10%cobblestone komutu doğal görünümlü bir taş dokusu üretir. Aynı sözdizimi //replace ile de çalışır.

Kopyalama, yapıştırma ve schematic yönetimi#

Yapıları taşımak ve arşivlemek WorldEdit’in en çok kullanılan tarafıdır. Kopyalama sırasında karakterinizin konumu referans noktası olur; yapıştırırken de aynı göreli konum kullanılır, bu yüzden kopyalarken yapının hangi köşesinde durduğunuzu unutmayın.

//copy                    Seçimi panoya alır (siz referans noktasısınız)
//cut                     Kopyalar ve orijinali siler
//paste                   Panoyu göreli konuma yapıştırır
//paste -a                Havayı yapıştırmaz, mevcut blokları korur
//paste -o                Tam kopyalandığı koordinatlara yapıştırır
//rotate 90               Panoyu 90 derece döndürür
//flip north              Panoyu kuzey ekseninde aynalar
//stack 5 up              Seçimi 5 kez yukarı çoğaltır
//move 20 east            Seçimi 20 blok doğuya taşır
//schem save market       Panoyu market.schem olarak kaydeder
//schem load market       Kayıtlı schematic’i panoya yükler
//schem list              Kayıtlı schematic’leri listeler

Kaydedilen dosyalar plugins/WorldEdit/schematics/ klasörüne .schem uzantısıyla yazılır. Bu klasörü başka sunucuya kopyalayarak hazır yapıları taşıyabilirsiniz; Skyblock sunucusu kurarken ada şablonlarının taşınma yöntemi de budur.

Fırçalar ve maskeler ile arazi şekillendirme#

Fırçalar, uzaktan bakarak blok yerleştirmenizi sağlar. Elinizdeki eşyaya bağlanırlar; genellikle bir kazma veya çubuk kullanılır.

//br sphere grass_block 5      Elinizdeki eşyaya 5 yarıçaplı küre fırçası bağlar
//br smooth 6                  Araziyi yumuşatan fırça
//br cyl sandstone 4 1         4 yarıçaplı, 1 yükseklikte silindir fırçası
/mask grass_block              Fırçayı sadece çim bloklarına uygular
/mask !air                     Havaya dokunmaz
/mask                          Maskeyi kaldırır
//none                         Fırçayı eşyadan söker
//tool none                    Aynı işi yapan alternatif komut

Maskeler //set ve //replace gibi komutlar için de geçerlidir; örneğin /mask >grass_block yalnızca çim bloğunun üstündeki konumları hedefler. Dağ, kıyı, yol gibi organik yapıları elle blok dizerek değil bu araçlarla üretirsiniz.

WorldEdit limitleri ve sunucu performansı#

WorldEdit işlemleri sunucunun ana tick döngüsünde çalışır. Milyon bloklu bir //set, işlem bitene kadar tüm oyuncuları dondurur ve konsolda Can’t keep up! Is the server overloaded? uyarısı belirir. Bu, eklentinin hatası değil, işin doğasıdır; limitle ve donanımla yönetilir.

limits:
  max-blocks-changed:
    default: 1000000
    maximum: 20000000
  max-radius: 250
  max-super-pickaxe-size: 5
  max-brush-radius: 12
  disallowed-blocks:
  - "minecraft:bedrock"
  - "minecraft:end_portal_frame"
history:
  size: 15
  expiration: 10
calculation:
  timeout: 100

default değeri normal yetkili oyuncular için geçerlidir; maximum ise worldedit.limit.unrestricted iznine sahip kişilerin çıkabileceği tavandır. Yapıcı ekibinizde deneyimsiz kişiler varsa default değerini bir milyonun altında tutmak sunucuyu kazara kilitlenmekten korur.

İşlem sonrası TPS toparlamıyorsa nedenini tahmin etmeyin, ölçün: spark ile performans analizi sayfası profil çıkarmayı adım adım anlatıyor. Donanım tarafında ana belirleyici çekirdek sayısı değil saat hızıdır; Minecraft’ın tick döngüsü tek çekirdekte koşar, bu yüzden yüksek frekanslı AMD Ryzen 9 7900X/7950X sınıfı işlemciler ve NVMe SSD şarttır. Hazır yapılandırılmış paketleri Minecraft sunucu paketleri sayfasında karşılaştırabilirsiniz.

WorldGuard ile bölge oluşturma ve üye yönetimi#

WorldGuard bölgeleri, WorldEdit seçiminden üretilir. Yani önce alanı seçer, sonra ona isim verirsiniz. Bölge oluşturulduğu anda, üye listesinde olmayan hiç kimse o alanda blok kıramaz veya koyamaz — ayrıca flag ayarlamanıza gerek kalmaz.

//wand                            Baltayı al, iki köşeyi seç
//expand vert                     Seçimi tabandan gökyüzüne uzat
/rg define spawn                  “spawn” adında bölge oluştur
/rg redefine spawn                Bölgenin sınırlarını yeni seçime göre güncelle
/rg addowner spawn Ozan           Sahip ekle (flag değiştirebilir)
/rg addmember spawn Emre Ayse     Üye ekle (sadece inşa edebilir)
/rg removemember spawn Emre       Üyeyi çıkar
/rg info spawn                    Bölge bilgisini gösterir
/rg list                          Dünyadaki tüm bölgeleri listeler
/rg select spawn                  Bölgeyi WorldEdit seçimine çevirir
/rg setpriority spawn 10          Öncelik verir (yüksek olan kazanır)
/rg setparent market_stand market Üst bölge tanımlar, flag’ler miras alınır
/rg remove spawn                  Bölgeyi siler

Öncelik ve iç içe bölgeler#

Bir konum birden çok bölgeye aitse WorldGuard en yüksek priority değerine sahip bölgenin flag’ini uygular. Klasik kurgu şudur: dünya genelinde __global__ üzerinde temel kurallar (öncelik 0), spawn alanı üzerinde koruma (öncelik 5), spawn içindeki dövüş arenasında istisna (öncelik 10). Böylece “her yerde PvP kapalı, sadece arenada açık” gibi kurallar tek satırla kurulur.

Bölge verisi nerede tutulur?#

Her dünya için ayrı dosya kullanılır: plugins/WorldGuard/worlds/world/regions.yml. Sunucu taşırken bu dosyayı hedef sunucudaki aynı dünya adının altına kopyalayın. Büyük ağlarda dosya yerine MySQL de kullanılabilir; ayar plugins/WorldGuard/config.yml içindeki regions.storage.driver anahtarındadır.

WorldGuard flag listesi ve pratik örnekler#

Flag’ler /rg flag <bolge> <flag> <deger> kalıbıyla verilir. Değer genelde allow veya deny olur; flag’i tamamen kaldırmak için değer yerine none yazılır. Grup hedeflemek için -g nonmembers veya -g members eklenir.

Hazır bir spawn koruma seti:

/rg flag spawn pvp deny
/rg flag spawn mob-spawning deny
/rg flag spawn mob-damage deny
/rg flag spawn creeper-explosion deny
/rg flag spawn tnt deny
/rg flag spawn fire-spread deny
/rg flag spawn chest-access deny -g nonmembers
/rg flag spawn invincible allow
/rg flag spawn greeting &aSpawn bolgesine hos geldiniz!
/rg flag spawn farewell &cSpawn bolgesinden ayrildiniz.
/rg flag spawn deny-message &cBurada yapi degistiremezsiniz.

__global__ bölgesi ve sunucu geneli kurallar#

__global__, o dünyanın tamamını kapsayan sanal bölgedir; ayrıca tanımlamanıza gerek yoktur, doğrudan flag verebilirsiniz. Öncelik değeri her zaman en düşüktür, bu yüzden normal bölgeler onu ezer. Sunucu genelinde geçerli olmasını istediğiniz kuralları buraya yazın.

/rg flag __global__ pvp deny
/rg flag __global__ creeper-explosion deny
/rg flag __global__ tnt deny
/rg flag __global__ fire-spread deny

Dünya bazlı kaba ayarlar ise plugins/WorldGuard/worlds/world/config.yml içinde tutulur. Sık kullanılan anahtarlar:

build-permission-nodes:
  enable: false
mobs:
  block-creeper-block-damage: true
  block-tnt-block-damage: true
  block-wither-block-damage: true
  block-enderdragon-block-damage: true
  block-enderman-block-damage: true
protection:
  item-durability: true
spawn:
  protect-spawn: true
  protect-spawn-radius: 32

Yetkiler: LuckPerms ile WorldEdit ve WorldGuard izinleri#

OP vermek en kolay yol gibi görünse de yapıcı ekibe OP dağıtmak sunucuyu riske atar; OP olan kişi /stop, /op ve tüm eklenti komutlarına erişir. Doğrusu izinleri gruplara vermektir. OP mantığını ve risklerini OP verme ve yetki yönetimi sayfasında ayrıntılı anlattık.

/lp creategroup builder
/lp group builder permission set worldedit.wand true
/lp group builder permission set worldedit.selection.* true
/lp group builder permission set worldedit.region.* true
/lp group builder permission set worldedit.clipboard.* true
/lp group builder permission set worldedit.brush.* true
/lp group builder permission set worldedit.history.* true
/lp group builder permission set worldedit.limit.unrestricted false
/lp group builder permission set worldguard.region.info.* true
/lp group builder permission set worldguard.region.list true
/lp user Emre parent add builder

Bölge tanımlama ve flag değiştirme yetkisini yalnızca yönetici grubuna verin: worldguard.region.define, worldguard.region.redefine.*, worldguard.region.flag.* ve worldguard.region.remove.*. Grup hiyerarşisi kurmayı bilmiyorsanız LuckPerms ile yetki sistemi kurma rehberini takip edin.

Sık karşılaşılan hatalar ve çözümleri#

“Unknown dependency: WorldEdit”#

WorldGuard, WorldEdit’i bulamıyor. Jar adının değiştirilmemiş olduğundan, dosyanın plugins kökünde (alt klasörde değil) durduğundan ve sürümlerin uyumlu olduğundan emin olun.

Komutlar hiç yanıt vermiyor#

Önce /plugins listesinde WorldEdit ve WorldGuard adlarının yeşil göründüğünü doğrulayın. Yeşilse çakışma vardır: başka bir eklenti aynı komutu kaydetmiştir. Bu durumda komutu eklenti öneki ile çağırın, örneğin /worldedit:/set stone. Kalıcı çözüm için commands.yml dosyasındaki aliases bölümünden çakışan takma adı kaldırın.

Bölge tanımladım ama insanlar hâlâ blok kırıyor#

Kırılan yer büyük ihtimalle bölgenin dışında kalıyor. //expand vert yapmayı unuttuysanız bölge yalnızca seçtiğiniz iki köşe arasındaki yükseklikte geçerlidir. /rg info ile sınırları kontrol edin. İkinci olasılık: kişi OP’tur; OP’lar varsayılan olarak WorldGuard korumasını aşar.

Konsolda NoClassDefFoundError veya sürüm uyarısı#

26.1 ile gelen unobfuscation kırılması yüzünden eski jar kullanıyorsunuz demektir. WorldEdit 7.4.5 ve WorldGuard 7.0.18 sürümlerine yükseltin. Aynı sorun eski PlaceholderAPI ve NMS kullanan diğer eklentilerde de görülür; 2026 eklenti listesi güncel sürümleri tek yerde topluyor.

//paste sonrası TPS 20’den düştü ve toparlamıyor#

Yeni yüklenen chunk’lar diske yazılırken I/O beklemesi olur. Disk NVMe değilse bu durum dakikalarca sürer. Kalıcı çözüm donanım tarafındadır; doğru donanım seçimi sayfasında disk ve işlemci kriterlerini ayrıntılı bulabilirsiniz.

Özetle#

WorldEdit ile haritayı saatler yerine saniyeler içinde şekillendirir, WorldGuard ile de emeğinizi kalıcı olarak korursunuz. Minecraft 26.2 çalıştırıyorsanız WorldEdit 7.4.5 ve WorldGuard 7.0.18 dışında bir sürüm denemeyin; 26.1 unobfuscation kırılması eski jar’ları tamamen kullanılmaz hâle getirdi. Kurulumdan sonra ilk yapmanız gerekenler sırasıyla şunlar: spawn bölgesini //expand vert ile dikey genişleterek tanımlayın, __global__ üzerinde TNT ve creeper hasarını kapatın, WorldEdit limitlerini ekibinizin deneyimine göre ayarlayın ve izinleri OP yerine LuckPerms gruplarıyla dağıtın.

Büyük seçim işlemleri tek çekirdeği doyurduğu için sunucunuzun saat hızı ve heap büyüklüğü doğrudan bu eklentilerin kullanılabilirliğini belirler. En az 8 GB RAM, yüksek frekanslı Ryzen 9 işlemci ve NVMe SSD olan bir yapılandırmayla çalışın; yapı ekibiniz büyükse 16 GB ve üzerini hedefleyin. Takıldığınız noktada destek talebi açarak sistem ekibimizden yardım isteyebilirsiniz.