Minecraft eklentisi WorldGuardExtraFlagsPlus

🔌 WorldGuard ExtraFlags Plus Hakkında

WorldGuard ExtraFlags Plus, WorldGuard eklentisi için ek bölge flagleri ve davranışları sağlayan bir eklentidir. WorldGuard'ın bölge sistemini, eşya kullanımını, ışınlanmayı, giriş sınırlarını, crafting'i, oyuncu çarpışmasını, köylü ticaretini ve diğer bölgeye özel kuralları kontrol etmek için 40'tan fazla doğrulanmış flag ile genişletir.

🎯 Amaç

Eklenti, WorldGuard'ın yerleşik flaglerinde eksik kalan noktaları doldurarak oyuncu eylemleri ve bölge politikaları üzerinde ayrıntılı kontrol sağlar. Temel WorldGuard'ın ötesinde bölge düzeyinde özelleştirme ihtiyacı duyan sunucu yöneticileri için tasarlanmıştır; örneğin korumalı PvP arenaları, lobby'ler, hub davranışı veya kısıtlı oyun alanları oluşturmak için.

⚙️ Özellikler

• 40+ ek flag ekler (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Plus'a özel yeni flagler: disable-completely, disable-throw, entry-min-level, entry-max-level, player-count-limit, villager-trade, lightning-damage, disable-collision, inventory-craft, permit-workbenches, deny-item-drops, deny-item-pickup, allow-block-place, deny-block-place, allow-block-break, deny-block-break.
• messages-wgefp.yml içinde saklanan özelleştirilebilir mesajlar (spam'i önlemek için mesaj bekleme süresi ile).
• İsteğe bağlı entegrasyon kancaları: sayısal placeholder'lar için PlaceholderAPI desteği, belirli öğe/saldırıları engelleme kapsamını iyileştirmek için PacketEvents veya ProtocolLib paket kancaları.
• EssentialsX etkileşimi: godmode ve fly flag iyileştirmeleri, bu flagler reddedildiğinde EssentialsX godmode/fly'ını devre dışı bırakır.
• Folia desteği ve uygun yerlerde async uyumlu işleyiciler.
• Güncelleme kontrolü ve deneysel hide-players flagi ile chambered-enderpearl deneysel davranışı.
• Bir oyuncu bölgede kaldığı sürece bir konsol komutunu tekrar tekrar çalıştırmak için console-command-repeat flagi (varsayılan olarak devre dışı).

🧩 Kimler İçin

• WorldGuard kullanan ve daha hassas bölge kontrollerine ihtiyaç duyan sunucu sahipleri ve yöneticiler.
• Bölgeye dayalı davranış özelleştirmesi gerektiren Survival, SMP, hub/lobby ve PvP sunucuları.
• Async veya fork'e özel desteğin gerektiği Paper ya da Folia kullanan sunucular.

🏗️ Kullanım Senaryoları

• player-count-limit ile bir arena bölgesindeki oyuncu sayısını sınırlamak.
• disable-completely ve disable-throw kullanarak etkinlik alanlarında belirli eşyaların (mace, trident, ender pearls) kullanımını ve atılmasını engellemek.
• inventory-craft ile güvenli bölgelerde envanter içi (2x2) crafting'i engellemek veya permit-workbenches ile çalışma masasının kullanımını kapatmak.
• entry-min-level / entry-max-level kullanarak bölge girişini oyuncu XP seviyesi ya da sayısal bir PlaceholderAPI değeri ile kısıtlamak.
• console-command-repeat kullanarak oyuncular bölgede kaldığı sürece bir konsol komutunu tekrar tekrar çalıştırmak.

⌨️ Komutlar

⚙️ Kurulum

📥 Kurulum

• Resmi JAR dosyasını indirin ve WorldGuard ile birlikte sunucunuzun plugins/ dizinine yerleştirin.
• Eski WorldGuardExtraFlags'ten yükseltiyorsanız: başlamadan önce eski WorldGuardExtraFlags.jar dosyasını kaldırın — ikisi birlikte bulunamaz.
• Sunucuyu yeniden başlatın ve eklenti ile flaglerinin doğru şekilde yüklendiğini doğrulamak için sunucu konsolunu kontrol edin.

📦 Bağımlılıklar

• Gerekli: WorldGuard (bu proje WorldGuard için bir eklentidir).
• İsteğe bağlı / Entegrasyonlar: PlaceholderAPI (sayısal placeholder desteği), PacketEvents veya ProtocolLib (iyileştirilmiş paket tabanlı engelleme), EssentialsX (godmode/fly davranışı entegrasyonu).

🧾 Yapılandırma

• Eklenti mesajları plugins/WorldGuard/messages-wgefp.yml içinde saklanır ve tamamen özelleştirilebilir; eklenti yapılandırması üzerinden ayarlanabilen bir mesaj bekleme süresi sistemi vardır.

🧠 Teknik Notlar

• Proje api-version: 1.21 bildirir ve modern Paper API artefaktlarını hedefler; Folia uyumluluğu uygulanmış ve doğrulanmıştır.
• Java bytecode ve API hedefi, 1.21 döneminin yeni sunucu ortamlarıyla uyumludur.
• Eklenti, daha geniş eşya engelleme semantiği için eski permit-completely davranışını disable-completely ile değiştirir.
• Bazı özellikler (örneğin belirli mızrak hamle mekaniklerinin tamamen engellenmesi) PacketEvents veya ProtocolLib mevcut olduğunda daha güvenilirdir.
• Eklenti, birçok flagi standart WorldGuard flag komutları aracılığıyla sunar (flagler WorldGuard'ın bölge flag arayüzü kullanılarak ayarlanır).

🤝 Bu Eklenti Ne Zaman Faydalı

WorldGuard kullanıyor ve eşya kullanımını, oyuncu giriş kurallarını, crafting'i ve diğer bölge bazlı davranışları kontrol etmek için ek, doğrulanmış bölge flaglerine ihtiyaç duyuyorsanız — özellikle Paper veya Folia sunucularında — WorldGuard ExtraFlags Plus bu yetenekleri ayrı bölge yönetimi eklentilerine gerek kalmadan WorldGuard'ın flag sistemi içinde merkezileştirir.