Plugin Minecraft WorldGuardExtraFlagsPlus

🔌 Informazioni su WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus è un'estensione per il plugin WorldGuard che offre flag e comportamenti aggiuntivi per le regioni. Espande il sistema delle regioni di WorldGuard con più di 40 flag confermati per controllare l'uso degli oggetti, il teletrasporto, i limiti di ingresso, il crafting, la collisione tra giocatori, il commercio con i villici e altre regole specifiche per regione.

🎯 Scopo

Il plugin colma le lacune dei flag integrati di WorldGuard offrendo un controllo dettagliato sulle azioni dei giocatori e sulle policy delle regioni. È pensato per gli amministratori di server che hanno bisogno di una personalizzazione a livello di regione oltre al WorldGuard base, ad esempio per creare arene PvP protette, lobby, comportamento dell'hub o aree di gioco limitate.

⚙️ Funzionalità

• Aggiunge oltre 40 flag extra (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Nuovi flag specifici di 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.
• Messaggi personalizzabili salvati in messages-wgefp.yml (cooldown dei messaggi per evitare spam).
• Hook di integrazione opzionali: supporto a PlaceholderAPI per i placeholder numerici, hook opzionali dei pacchetti con PacketEvents o ProtocolLib per migliorare il blocco di alcuni oggetti/attacchi.
• Interazione con EssentialsX: i miglioramenti dei flag godmode e fly disattivano il godmode/fly di EssentialsX quando quei flag sono negati.
• Supporto a Folia e handler sicuri per l'async dove applicabile.
• Controllo aggiornamenti e un flag sperimentale hide-players e il comportamento sperimentale chambered-enderpearl.
• Flag console-command-repeat per eseguire ripetutamente un comando console mentre un giocatore rimane in una regione (disattivato per impostazione predefinita).

🧩 A chi è rivolto

• Proprietari e amministratori di server che usano WorldGuard e hanno bisogno di controlli di regione più precisi.
• Server Survival, SMP, hub/lobby e PvP che richiedono un comportamento personalizzato per regione.
• Server che usano Paper o Folia e che necessitano di supporto async o specifico del fork.

🏗️ Esempi di utilizzo

• Limitare il numero di giocatori in una regione arena con player-count-limit.
• Bloccare l'uso e il lancio di oggetti specifici (mace, trident, ender pearls) all'interno delle zone evento usando disable-completely e disable-throw.
• Impedire il crafting (2x2) nell'inventario nelle zone sicure con inventory-craft o bloccare l'uso del banco da lavoro con permit-workbenches.
• Limitare l'ingresso in una regione in base al livello XP del giocatore o a un valore numerico di PlaceholderAPI usando entry-min-level / entry-max-level.
• Eseguire ripetutamente un comando console mentre i giocatori rimangono all'interno di una regione usando console-command-repeat.

⌨️ Comandi

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale e inseriscilo nella directory plugins/ del tuo server insieme a WorldGuard.
• Se stai aggiornando dalla vecchia WorldGuardExtraFlags: rimuovi il vecchio WorldGuardExtraFlags.jar prima di avviare — i due non possono coesistere.
• Riavvia il server e controlla la console per confermare che il plugin e i suoi flag siano stati caricati correttamente.

📦 Dipendenze

• Richiesto: WorldGuard (questo progetto è un'estensione di WorldGuard).
• Opzionale / Integrazioni: PlaceholderAPI (supporto ai placeholder numerici), PacketEvents o ProtocolLib (blocco basato sui pacchetti migliorato), EssentialsX (integrazione per il comportamento di godmode/fly).

🧾 Configurazione

• I messaggi del plugin sono salvati in plugins/WorldGuard/messages-wgefp.yml e sono completamente personalizzabili; esiste un sistema di cooldown dei messaggi configurabile tramite la config del plugin.

🧠 Note tecniche

• Il progetto dichiara api-version: 1.21 e punta ad artefatti moderni della API di Paper; la compatibilità con Folia è implementata e confermata.
• Il bytecode Java e il target API sono allineati con ambienti server recenti dell'era 1.21.
• Il plugin sostituisce il vecchio comportamento permit-completely con disable-completely per una semantica di blocco degli oggetti più ampia.
• Alcune funzionalità (ad esempio il blocco completo di certe meccaniche di slancio della lancia) sono più affidabili quando sono presenti PacketEvents o ProtocolLib.
• Il plugin espone molti flag tramite i comandi standard dei flag di WorldGuard (i flag vengono impostati usando l'interfaccia dei flag di regione di WorldGuard).

🤝 Quando questo plugin è utile

Se usi WorldGuard e hai bisogno di ulteriori flag di regione confermati per controllare l'uso degli oggetti, le regole di ingresso dei giocatori, il crafting e altri comportamenti per regione — soprattutto su server Paper o Folia — WorldGuard ExtraFlags Plus centralizza queste capacità nel sistema dei flag di WorldGuard senza bisogno di plugin separati per la gestione delle regioni.