WorldGuard Nedir?

WorldGuard, Minecraft sunucularında bölge koruması sağlayan en kapsamlı eklentidir. Belirli alanları grief'ten koruma, PvP bölgeleri oluşturma, mob spawn kontrolü, item yasaklama, patlama engelleme ve dünya genelinde kurallar belirleme gibi onlarca özellik sunar.

  • Sınırsız bölge tanımlama — iç içe, üst üste, farklı dünyalarda
  • 50+ bayrak (flag) ile detaylı kontrol
  • Öncelik (priority) ve alt bölge (child region) sistemi
  • Global kurallar — tüm dünyayı kapsayan ayarlar
  • Blacklist — belirli itemleri yasaklama
  • WorldEdit entegrasyonu — görsel bölge seçimi

Kurulum

WorldGuard ve WorldEdit'i birlikte kurmanız gerekir. Her ikisi de plugins/ klasörüne atılır.

cd ~/server/plugins

# WorldEdit (zorunlu bağımlılık)
wget https://dev.bukkit.org/projects/worldedit/files/latest -O WorldEdit.jar

# WorldGuard
wget https://dev.bukkit.org/projects/worldguard/files/latest -O WorldGuard.jar

# Sunucuyu yeniden başlat
stop

İlk başlatmadan sonra plugins/WorldGuard/ klasöründe config dosyaları oluşacaktır.

WorldEdit ile Bölge Seçimi

Bir bölge tanımlamadan önce WorldEdit ile alanı seçmeniz gerekir. Üç farklı yöntem vardır:

Yöntem 1: Wand Aracı

En yaygın yöntem. Ahşap balta ile sol/sağ tıklayarak iki köşeyi seçersiniz.

text
//wand                         # Ahşap balta verir
# Sol tık → 1. köşe noktası
# Sağ tık → 2. köşe noktası

Yöntem 2: Komutla Seçim

text
//pos1                         # Durduğunuz yeri 1. nokta olarak ayarla
//pos2                         # Durduğunuz yeri 2. nokta olarak ayarla

Yöntem 3: Koordinatla Seçim

text
//pos1 100,64,200              # X,Y,Z koordinatlarıyla 1. nokta
//pos2 200,128,300              # X,Y,Z koordinatlarıyla 2. nokta

Seçimi Genişletme

text
//expand vert                  # Gökyüzüne ve yeraltına genişlet (Y=-64 → Y=320)
//expand 10 north              # Kuzeye 10 blok genişlet
//expand 5 up                  # Yukarı 5 blok genişlet
//contract 3 south             # Güneyden 3 blok daralt

Bölge Komutları

Seçim yaptıktan sonra bölge tanımlama ve yönetme komutları:

KomutAçıklamaYetki
<code>/rg define spawn</code>Seçili alanı 'spawn' ismiyle bölge olarak tanımlaworldguard.region.define.*
<code>/rg redefine spawn</code>Mevcut bölgenin sınırlarını güncelle (yeni seçimle)worldguard.region.redefine.*
<code>/rg remove arena</code>Bölgeyi silworldguard.region.remove.*
<code>/rg info spawn</code>Bölge detaylarını gösterworldguard.region.info.*
<code>/rg list</code>Tüm bölgeleri listeleworldguard.region.list
<code>/rg list -w nether</code>Belirli dünyadaki bölgeleri listeleworldguard.region.list
<code>/rg addowner spawn Oyuncu</code>Bölgeye sahip (owner) ekleworldguard.region.addowner.*
<code>/rg addmember spawn Oyuncu</code>Bölgeye üye (member) ekleworldguard.region.addmember.*
<code>/rg removeowner spawn Oyuncu</code>Sahipliği kaldırworldguard.region.removeowner.*
<code>/rg removemember spawn Oyuncu</code>Üyeliği kaldırworldguard.region.removemember.*
<code>/rg select spawn</code>Mevcut bölgeyi WorldEdit seçimine yükleworldguard.region.select
<code>/rg tp spawn</code>Bölgeye ışınlanworldguard.region.tp

Bayraklar (Flags) Tablosu

Bayraklar, bir bölgedeki davranışları kontrol eder. Üç değer alabilir: allow, deny, none (üst bölgeden devral). Sözdizimi: /rg flag bölge_adı bayrak değer

PvP ve Savaş Bayrakları

BayrakVarsayılanAçıklama
<code>pvp</code>allowOyuncuların birbirine hasar vermesi
<code>invincibility</code>—Bölgedeki oyuncular hasar almaz
<code>mob-damage</code>allowMobların oyunculara hasar vermesi
<code>fall-damage</code>allowDüşme hasarı
<code>fire-damage</code>allowAteş hasarı
<code>potion-splash</code>allowSplash potion efektleri

İnşa ve Kırma Bayrakları

BayrakVarsayılanAçıklama
<code>build</code>allow (member/owner)Genel inşa/kırma izni
<code>block-break</code>—Sadece blok kırma kontrolü
<code>block-place</code>—Sadece blok koyma kontrolü
<code>interact</code>allowKapı, düğme, lever etkileşimi
<code>use</code>allowItem kullanımı (balta, kova vb.)
<code>chest-access</code>allowSandık/fırın/ocak erişimi
<code>vehicle-place</code>allowBot/minecart yerleştirme
<code>vehicle-destroy</code>allowBot/minecart kırma

Mob ve Spawn Bayrakları

BayrakVarsayılanAçıklama
<code>mob-spawning</code>allowTüm mob spawn'ını kontrol eder
<code>deny-spawn</code>—Belirli mob türlerini engelle (ör: creeper,skeleton)
<code>entity-painting-destroy</code>allowMobların tablo kırması
<code>entity-item-frame-destroy</code>allowMobların item frame kırması

Patlama ve Doğa Bayrakları

BayrakVarsayılanAçıklama
<code>creeper-explosion</code>allowCreeper patlaması
<code>tnt</code>allowTNT patlaması
<code>other-explosion</code>allowDiğer patlamalar (bed, crystal vb.)
<code>fire-spread</code>allowAteşin yayılması
<code>lava-fire</code>allowLavın ateş başlatması
<code>lightning</code>allowYıldırım düşmesi
<code>snow-fall</code>allowKar yağışı
<code>snow-melt</code>allowKar erimesi
<code>ice-form</code>allowBuz oluşumu
<code>ice-melt</code>allowBuz erimesi
<code>mushroom-growth</code>allowMantar büyümesi
<code>leaf-decay</code>allowYaprak çürümesi
<code>grass-growth</code>allowÇimen büyümesi
<code>vine-growth</code>allowSarmaşık büyümesi
<code>crop-growth</code>allowEkin büyümesi
<code>soil-dry</code>allowToprak kuruması

Işınlanma ve Hareket Bayrakları

BayrakVarsayılanAçıklama
<code>entry</code>allowBölgeye giriş izni
<code>exit</code>allowBölgeden çıkış izni
<code>enderpearl</code>allowEnderpearl ile ışınlanma
<code>chorus-fruit-teleport</code>allowChorus meyvesi ile ışınlanma
<code>teleport</code>allow/tp gibi komutlarla ışınlanma
<code>spawn-teleport</code>allow/spawn komutu ile ışınlanma

Mesaj ve Bilgi Bayrakları

BayrakVarsayılanAçıklama
<code>greeting</code>—Bölgeye girişte gösterilecek mesaj
<code>farewell</code>—Bölgeden çıkışta gösterilecek mesaj
<code>greeting-title</code>—Bölgeye girişte ekranda büyük başlık
<code>farewell-title</code>—Bölgeden çıkışta ekranda büyük başlık
text
/rg flag spawn greeting &aSpawn bölgesine hoş geldiniz!
/rg flag spawn farewell &7Spawn bölgesinden ayrıldınız.
/rg flag spawn greeting-title &b&lSPAWN

Diğer Önemli Bayraklar

BayrakVarsayılanAçıklama
<code>item-pickup</code>allowYerden item toplama
<code>item-drop</code>allowItem düşürme
<code>exp-drops</code>allowXP orb düşmesi
<code>send-chat</code>allowChat mesajı gönderme
<code>receive-chat</code>allowChat mesajı alma
<code>pistons</code>allowPiston hareketi
<code>ride</code>allowHayvana/araca binme
<code>sleep</code>allowYatakta uyuma
<code>respawn-anchors</code>allowRespawn anchor kullanımı
<code>frosted-ice-form</code>allowFrost Walker buz oluşumu

Öncelik (Priority) Sistemi

Bölgeler üst üste bindiğinde hangi bayrakların geçerli olacağını öncelik (priority) değeri belirler. Yüksek sayı = yüksek öncelik. Varsayılan priority: 0.

text
# Şehir bölgesi: PvP kapalı (priority 1)
/rg define sehir
/rg flag sehir pvp deny
/rg setpriority sehir 1

# Şehir içinde arena: PvP açık (priority 10)
/rg define sehir-arena
/rg flag sehir-arena pvp allow
/rg setpriority sehir-arena 10

# Arena şehrin içinde olsa bile priority daha yüksek olduğu için PvP açık olur
PriorityKullanım Örneği
0Varsayılan bölgeler
1Şehir, kasaba gibi büyük alanlar
5Özel kurallar gereken bölgeler
10Arena, PvP zone gibi üst üste binen alanlar
100Spawn gibi kesinlikle korunması gereken alanlar

Alt Bölgeler (Child Regions)

Bir bölgenin içinde alt bölgeler tanımlayarak hiyerarşik yapı kurabilirsiniz. Alt bölgeler üst bölgenin bayraklarını miras alır ve ihtiyaca göre override edebilir.

text
# 1. Ana bölge oluştur
/rg define kasaba
/rg flag kasaba pvp deny
/rg flag kasaba build deny

# 2. Alt bölge oluştur (-p ile parent belirt)
/rg define kasaba-dukkan
/rg setparent kasaba-dukkan kasaba
/rg flag kasaba-dukkan use allow
/rg flag kasaba-dukkan chest-access allow

# Sonuç: kasaba-dukkan'da pvp ve build hala deny (miras)
# ama use ve chest-access allow (override)

Global Bölge (__global__)

__global__ bölgesi tanımlı bir bölge olmayan her yere uygulanır. Dünya genelinde kurallar koymak için idealdir.

text
# Tüm dünyada creeper patlamasını engelle
/rg flag __global__ creeper-explosion deny

# Tüm dünyada TNT patlamasını engelle
/rg flag __global__ tnt deny

# Tüm dünyada ateş yayılmasını engelle
/rg flag __global__ fire-spread deny

# Tüm dünyada wither hasarını engelle
/rg flag __global__ wither-damage deny

# Tüm dünyada lava akışından ateş oluşmasını engelle
/rg flag __global__ lava-fire deny

# PvP varsayılan olarak kapalı (sadece arena'larda açık)
/rg flag __global__ pvp deny

Spawn Koruması Adım Adım

Sunucunuzun spawn alanını korumak için aşağıdaki adımları izleyin:

text
# Adım 1: WorldEdit ile spawn alanını seçin
//wand
# Sol/sağ tıkla ile iki köşeyi işaretle
//expand vert            # Tüm yüksekliği kapsa

# Adım 2: Bölgeyi tanımlayın
/rg define spawn

# Adım 3: Koruma bayraklarını ayarlayın
/rg flag spawn build deny
/rg flag spawn pvp deny
/rg flag spawn mob-spawning deny
/rg flag spawn creeper-explosion deny
/rg flag spawn tnt deny
/rg flag spawn fire-spread deny
/rg flag spawn enderpearl deny
/rg flag spawn chorus-fruit-teleport deny

# Adım 4: Mesajlar ekleyin
/rg flag spawn greeting &a&lSpawn &7bölgesine hoş geldiniz!
/rg flag spawn farewell &7Spawn bölgesinden ayrıldınız.

# Adım 5: Yüksek priority verin
/rg setpriority spawn 100
BayrakDeğerNeden
builddenyBlok koyma/kırma engeli
pvpdenySpawn'da savaş yasak
mob-spawningdenyMob'lar spawn'da oluşmasın
creeper-explosiondenyCreeper hasarı engeli
tntdenyTNT hasarı engeli
fire-spreaddenyAteş yayılma engeli
enderpearldenyPearl ile korumalı alana giriş engeli
chorus-fruit-teleportdenyChorus ile bypass engeli
item-dropdenyYere item atma engeli (isteğe bağlı)
interactallowNPC, tabelalarla etkileşim

PvP Arena Kurulumu

Oyuncuların savaşabileceği özel bir alan oluşturmak için:

text
# Adım 1: Arena alanını seçin
//wand
//expand vert

# Adım 2: Bölge tanımlayın
/rg define pvp-arena

# Adım 3: PvP bayraklarını ayarlayın
/rg flag pvp-arena pvp allow
/rg flag pvp-arena build deny
/rg flag pvp-arena item-drop deny
/rg flag pvp-arena exp-drops deny
/rg flag pvp-arena enderpearl allow
/rg flag pvp-arena mob-spawning deny

# Adım 4: Giriş/çıkış mesajları
/rg flag pvp-arena greeting &c&l⚔ PvP Arena &7- Dikkatli ol!
/rg flag pvp-arena farewell &aPvP arenasından çıktınız.

# Adım 5: Priority (şehir içindeyse şehirden yüksek olmalı)
/rg setpriority pvp-arena 10

Blacklist Yapılandırması

Blacklist ile belirli itemlerin kullanımını, koyulmasını veya kırılmasını dünya genelinde engelleyebilirsiniz. Dosya: plugins/WorldGuard/blacklist.txt

text
# blacklist.txt

# TNT kullanımını engelle
[tnt]
  on-place=deny,tell,log
  message=&cTNT kullanımı bu sunucuda yasaktır!

# Lava kovası kullanımını engelle
[lava_bucket]
  on-use=deny,tell,log
  message=&cLava dökme yasaktır!

# Bedrock koyma engeli
[bedrock]
  on-place=deny,tell
  message=&cBedrock koyamazsınız!

# Barrier block engeli
[barrier]
  on-place=deny,tell

# Ender crystal koyma engeli (grief önlemi)
[end_crystal]
  on-place=deny,tell,log
  message=&cEnd crystal kullanımı yasaktır!
Blacklist EylemiAçıklama
<code>on-place</code>Bloğu koyma girişiminde tetiklenir
<code>on-break</code>Bloğu kırma girişiminde tetiklenir
<code>on-use</code>Itemi kullanma girişiminde tetiklenir
<code>on-interact</code>Blokla etkileşimde tetiklenir
<code>on-drop</code>Itemi düşürme girişiminde tetiklenir
<code>on-acquire</code>Itemi edinme girişiminde tetiklenir
Blacklist AksiyonuAçıklama
<code>deny</code>İşlemi engelle
<code>tell</code>Oyuncuya mesaj göster
<code>log</code>Konsola/dosyaya logla
<code>kick</code>Oyuncuyu sunucudan at
<code>ban</code>Oyuncuyu yasakla

WorldGuard Config Dosyası

plugins/WorldGuard/config.yml dosyasında global ayarlar yapılır:

yaml
# config.yml — Önemli ayarlar
regions:
  use-player-move-event: true    # Bölge giriş/çıkış kontrolü
  cancel-chat-without-recipients: true
  max-claim-volume: 30000        # Maksimum bölge hacmi

protection:
  item-durability: true           # Item dayanıklılık koruması
  remove-infinite-stacks: false

blacklist:
  use-as-whitelist: false         # true = sadece listede olanlara izin ver

gameplay:
  block-potions: []               # Yasaklı potion ID'leri
  disable-xp-orb-drops: false
  block-creature-spawn: []        # Yasaklı mob spawn türleri

Sık Yapılan Hatalar ve Çözümleri

SorunNedenÇözüm
Bölge korumuyorSeçim yapılmamış veya <code>//expand vert</code> unutulmuş<code>/rg info</code> ile sınırları kontrol et, <code>//expand vert</code> ile yeniden tanımla
Owner/member build yapamıyor<code>build deny</code> herkesi etkiliyor<code>build</code> bayrağını <code>none</code> yap — member/owner otomatik izinli olur
Bayrak çalışmıyorBölge priority'si düşük, başka bölge override ediyor<code>/rg info</code> ile priority kontrol et, <code>/rg setpriority</code> ile artır
Global bayrak bölgeleri etkiliyor__global__ tüm yerlere uygulanıyorBölge içinde ilgili bayrağı <code>allow</code> olarak override et
PvP kapatılamıyorBaşka bir eklenti PvP kontrol ediyorEssentialsX'te <code>pvp: true</code> kontrol et, WorldGuard'ın önce yüklenmesini sağla
Enderpearl ile bölgeye giriliyor<code>enderpearl deny</code> ayarlanmamış<code>/rg flag bolge enderpearl deny</code> komutunu çalıştır
Mob'lar bölge içinde spawn oluyor<code>mob-spawning deny</code> unutulmuşBayrağı ayarla, mevcut mob'ları <code>/butcher</code> ile temizle
Bölge çok büyük, lag yapıyor<code>use-player-move-event</code> çok sayıda bölgede ağırGereksiz bölgeleri sil, bölge sayısını azalt

WorldGuard Yetkileri

YetkiAçıklama
<code>worldguard.region.define.*</code>Bölge tanımlama
<code>worldguard.region.flag.regions.*</code>Bayrak ayarlama
<code>worldguard.region.addowner.*</code>Owner ekleme
<code>worldguard.region.addmember.*</code>Member ekleme
<code>worldguard.region.remove.*</code>Bölge silme
<code>worldguard.region.info.*</code>Bölge bilgisi görme
<code>worldguard.region.list</code>Bölge listeleme
<code>worldguard.region.tp</code>Bölgeye ışınlanma
<code>worldguard.region.bypass.*</code>Bölge korumalarını bypass etme (admin)

Faydalı Kaynaklar