Plugin Minecraft WorldGuardExtraFlagsPlus

🔌 Tentang WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus adalah ekstensi untuk plugin WorldGuard yang menyediakan flag wilayah dan perilaku tambahan. Ekstensi ini memperluas sistem wilayah WorldGuard dengan lebih dari 40 flag terkonfirmasi untuk mengatur penggunaan item, teleportasi, batas masuk, crafting, tabrakan pemain, perdagangan villager, dan aturan khusus wilayah lainnya.

🎯 Tujuan

Plugin ini mengisi celah pada flag bawaan WorldGuard dengan menawarkan kontrol yang lebih detail atas tindakan pemain dan kebijakan wilayah. Plugin ini ditujukan untuk administrator server yang membutuhkan kustomisasi level wilayah di luar inti WorldGuard, misalnya untuk membuat arena PvP terlindungi, lobby, perilaku hub, atau zona permainan terbatas.

⚙️ Fitur

• Menambahkan 40+ flag tambahan (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Flag baru khusus plus: 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.
• Pesan kustom disimpan di messages-wgefp.yml (cooldown pesan untuk mencegah spam).
• Hook integrasi opsional: dukungan PlaceholderAPI untuk placeholder numerik, hook packet opsional PacketEvents atau ProtocolLib untuk meningkatkan cakupan pemblokiran pada item/serangan tertentu.
• Interaksi EssentialsX: peningkatan flag godmode dan fly menonaktifkan EssentialsX godmode/fly saat flag tersebut ditolak.
• Dukungan Folia dan handler yang aman untuk async jika berlaku.
• Pemeriksa pembaruan dan flag eksperimental hide-players serta perilaku eksperimental chambered-enderpearl.
• Flag console-command-repeat untuk menjalankan perintah console berulang kali selama pemain berada di dalam region (dinonaktifkan secara default).

🧩 Untuk Siapa Ini

• Pemilik server dan admin yang menjalankan WorldGuard dan membutuhkan kontrol region yang lebih presisi.
• Server Survival, SMP, hub/lobby, dan PvP yang memerlukan kustomisasi perilaku berbasis region.
• Server yang menggunakan Paper atau Folia dan membutuhkan dukungan async atau khusus fork.

🏗️ Contoh Penggunaan

• Membatasi jumlah pemain di region arena dengan player-count-limit.
• Memblokir penggunaan dan pelemparan item tertentu (mace, trident, ender pearl) di zona event menggunakan disable-completely dan disable-throw.
• Mencegah crafting inventory (2x2) di dalam safe zone dengan inventory-craft atau memblokir penggunaan workbench dengan permit-workbenches.
• Membatasi masuknya pemain berdasarkan level XP atau nilai numerik PlaceholderAPI menggunakan entry-min-level / entry-max-level.
• Menjalankan perintah console berulang kali selama pemain tetap berada di dalam region menggunakan console-command-repeat.

⌨️ Perintah

⚙️ Instalasi

📥 Penyiapan

• Unduh JAR resmi dan letakkan di direktori plugins/ server Anda bersama WorldGuard.
• Jika melakukan upgrade dari WorldGuardExtraFlags lama: hapus WorldGuardExtraFlags.jar yang lama sebelum memulai — keduanya tidak bisa digunakan bersamaan.
• Restart server dan periksa console server untuk memastikan plugin dan flag-nya dimuat dengan benar.

📦 Dependensi

• Diperlukan: WorldGuard (proyek ini adalah ekstensi untuk WorldGuard).
• Opsional / Integrasi: PlaceholderAPI (dukungan placeholder numerik), PacketEvents atau ProtocolLib (pemblokiran berbasis packet yang lebih baik), EssentialsX (integrasi untuk perilaku godmode/fly).

🧾 Konfigurasi

• Pesan plugin disimpan di plugins/WorldGuard/messages-wgefp.yml dan sepenuhnya dapat dikustomisasi; ada sistem cooldown pesan yang dapat dikonfigurasi melalui config plugin.

🧠 Catatan Teknis

• Proyek ini menyatakan api-version: 1.21 dan menargetkan artefak API Paper modern; kompatibilitas Folia telah diimplementasikan dan dikonfirmasi.
• Bytecode Java dan penargetan API selaras dengan lingkungan server era 1.21 terbaru.
• Plugin ini menggantikan perilaku permit-completely yang lama dengan disable-completely untuk semantik pemblokiran item yang lebih luas.
• Beberapa fitur (misalnya pemblokiran penuh untuk mekanik lunge tombak tertentu) lebih andal ketika PacketEvents atau ProtocolLib tersedia.
• Plugin ini mengekspos banyak flag melalui perintah flag WorldGuard standar (flag diatur menggunakan antarmuka flag region WorldGuard).

🤝 Kapan Plugin Ini Berguna

Jika Anda menjalankan WorldGuard dan membutuhkan flag region tambahan yang terkonfirmasi untuk mengontrol penggunaan item, aturan masuk pemain, crafting, dan perilaku per-region lainnya — terutama di server Paper atau Folia — WorldGuard ExtraFlags Plus memusatkan kemampuan tersebut di dalam sistem flag WorldGuard tanpa perlu plugin manajemen region terpisah.