Plugin Minecraft WorldGuardExtraFlagsPlus

🔌 Despre WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus este o extensie pentru pluginul WorldGuard care oferă flaguri și comportamente suplimentare pentru regiuni. Extinde sistemul de regiuni al WorldGuard cu peste 40 de flaguri confirmate pentru a controla folosirea obiectelor, teleportarea, limitele de intrare, crafting-ul, coliziunea jucătorilor, comerțul cu sătenii și alte reguli specifice regiunii.

🎯 Scop

Pluginul completează golurile din flagurile integrate ale WorldGuard, oferind control detaliat asupra acțiunilor jucătorilor și politicilor de regiune. Este destinat administratorilor de servere care au nevoie de personalizare la nivel de regiune dincolo de funcțiile de bază ale WorldGuard, de exemplu pentru a crea arene PvP protejate, lobby-uri, comportament de hub sau zone de joc restricționate.

⚙️ Funcții

• Adaugă peste 40 de flaguri suplimentare (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Flaguri noi, specifice 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.
• Mesaje personalizabile stocate în messages-wgefp.yml (cooldown pentru mesaje, pentru a preveni spamul).
• Hook-uri de integrare opționale: suport PlaceholderAPI pentru placeholder-e numerice, hook-uri packet opționale PacketEvents sau ProtocolLib pentru a îmbunătăți blocarea anumitor obiecte/atacuri.
• Integrare EssentialsX: îmbunătățirile pentru flagurile godmode și fly dezactivează godmode/fly din EssentialsX atunci când acele flaguri sunt refuzate.
• Suport Folia și handler-e sigure pentru async, acolo unde este cazul.
• Verificator de actualizări și un flag experimental hide-players, precum și un comportament experimental chambered-enderpearl.
• Flagul console-command-repeat pentru a rula repetat o comandă în consolă cât timp un jucător rămâne într-o regiune (dezactivat implicit).

🧩 Pentru cine este

• Proprietari și administratori de servere care rulează WorldGuard și au nevoie de un control mai precis al regiunilor.
• Servere Survival, SMP, hub/lobby și PvP care necesită comportament bazat pe regiuni.
• Servere care folosesc Paper sau Folia și au nevoie de suport async sau suport specific fork-ului.

🏗️ Exemple de utilizare

• Limitează numărul de jucători dintr-o regiune de arenă cu player-count-limit.
• Blochează folosirea și aruncarea anumitor obiecte (mace, trident, ender pearls) în zonele de eveniment folosind disable-completely și disable-throw.
• Previne crafting-ul în inventar (2x2) în zonele sigure cu inventory-craft sau blochează folosirea mesei de lucru cu permit-workbenches.
• Restricționează intrarea în regiune după nivelul XP al jucătorului sau după o valoare numerică PlaceholderAPI folosind entry-min-level / entry-max-level.
• Rulează repetat o comandă în consolă cât timp jucătorii rămân în regiune folosind console-command-repeat.

⌨️ Comenzi

⚙️ Instalare

📥 Setare

• Descarcă JAR-ul oficial și plasează-l în directorul plugins/ al serverului, împreună cu WorldGuard.
• Dacă faci upgrade de la vechiul WorldGuardExtraFlags: elimină WorldGuardExtraFlags.jar vechi înainte de pornire — cele două nu pot coexista.
• Repornește serverul și verifică consola serverului pentru a confirma că pluginul și flagurile sale au fost încărcate corect.

📦 Dependențe

• Necesar: WorldGuard (acest proiect este o extensie pentru WorldGuard).
• Opțional / Integrări: PlaceholderAPI (suport pentru placeholder-e numerice), PacketEvents sau ProtocolLib (blocare îmbunătățită bazată pe pachete), EssentialsX (integrare pentru comportamentul godmode/fly).

🧾 Configurare

• Mesajele pluginului sunt stocate în plugins/WorldGuard/messages-wgefp.yml și sunt complet personalizabile; există un sistem de cooldown pentru mesaje care poate fi configurat din fișierul de configurare al pluginului.

🧠 Note tehnice

• Proiectul declară api-version: 1.21 și țintește artefacte moderne Paper API; compatibilitatea cu Folia este implementată și confirmată.
• Bytecode-ul Java și țintirea API se aliniază cu mediile de server recente din era 1.21.
• Pluginul înlocuiește comportamentul vechi permit-completely cu disable-completely pentru o semantică mai largă de blocare a obiectelor.
• Unele funcții (de exemplu blocarea completă a anumitor mecanici de lunge cu sulița) sunt mai fiabile când sunt prezente PacketEvents sau ProtocolLib.
• Pluginul expune multe flaguri prin comenzile standard WorldGuard pentru flaguri (flagurile sunt setate folosind interfața de flaguri a regiunii din WorldGuard).

🤝 Când este util acest plugin

Dacă rulezi WorldGuard și ai nevoie de flaguri suplimentare, confirmate, pentru regiuni, pentru a controla folosirea obiectelor, regulile de intrare ale jucătorilor, crafting-ul și alte comportamente per-regiune — mai ales pe servere Paper sau Folia — WorldGuard ExtraFlags Plus centralizează aceste capabilități în sistemul de flaguri al WorldGuard, fără a avea nevoie de pluginuri separate pentru gestionarea regiunilor.