Minecraft plugin WorldGuardExtraFlagsPlus

🔌 Over WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus is een uitbreiding voor de WorldGuard-plugin die extra regioflags en gedragingen toevoegt. Het breidt het regio­systeem van WorldGuard uit met meer dan 40 bevestigde flags om het gebruik van items, teleportatie, toegangslimieten, crafting, spelerbotsing, handel met villagers en andere regiogebonden regels te beheren.

🎯 Doel

De plugin vult de gaten in de ingebouwde flags van WorldGuard op door fijnmazige controle te bieden over spelersacties en regiobeleid. Hij is bedoeld voor serverbeheerders die op regniveau meer maatwerk nodig hebben dan de basis van WorldGuard biedt, bijvoorbeeld om beschermde PvP-arenas, lobby’s, hub-gedrag of afgebakende spelzones te maken.

⚙️ Functies

• Voegt 40+ extra flags toe (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Nieuwe plus-specifieke flags: 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.
• Aangepaste berichten opgeslagen in messages-wgefp.yml (bericht-cooldown om spam te voorkomen).
• Optionele integratiekoppelingen: PlaceholderAPI-ondersteuning voor numerieke placeholders, optionele PacketEvents- of ProtocolLib-packetkoppelingen om blokkering van bepaalde items/aanvallen te verbeteren.
• EssentialsX-integratie: verbeteringen voor de flags godmode en fly schakelen EssentialsX godmode/fly uit wanneer die flags worden geweigerd.
• Ondersteuning voor Folia en waar van toepassing async-veilige handlers.
• Updatecontrole en een experimentele hide-players-flag en experimenteel gedrag chambered-enderpearl.
• console-command-repeat-flag om herhaaldelijk een consolecommando uit te voeren zolang een speler in een regio blijft (standaard uitgeschakeld).

🧩 Voor wie is dit

• Servereigenaars en admins die WorldGuard draaien en nauwkeurigere regie over regio’s nodig hebben.
• Survival-, SMP-, hub/lobby- en PvP-servers die regio-gebaseerd gedrag nodig hebben.
• Servers die Paper of Folia gebruiken en async-ondersteuning of fork-specifieke ondersteuning nodig hebben.

🏗️ Voorbeeldgebruik

• Beperk het aantal spelers in een arena-regio met player-count-limit.
• Blokkeer het gebruik en gooien van specifieke items (mace, trident, ender pearls) in eventzones met disable-completely en disable-throw.
• Voorkom crafting in het inventory (2x2) in veilige zones met inventory-craft of blokkeer het gebruik van workbenches met permit-workbenches.
• Beperk regio-toegang op basis van spelers-XP-niveau of een numerieke PlaceholderAPI-waarde met entry-min-level / entry-max-level.
• Voer een consolecommando herhaaldelijk uit terwijl spelers in een regio blijven met console-command-repeat.

⌨️ Commando’s

⚙️ Installatie

📥 Setup

• Download de officiële JAR en plaats die in de plugins/-map van je server, naast WorldGuard.
• Als je upgradet vanaf de oudere WorldGuardExtraFlags: verwijder de oude WorldGuardExtraFlags.jar voordat je start — de twee kunnen niet naast elkaar bestaan.
• Herstart de server en controleer de serverconsole om te bevestigen dat de plugin en de flags correct zijn geladen.

📦 Afhankelijkheden

• Vereist: WorldGuard (dit project is een uitbreiding voor WorldGuard).
• Optioneel / integraties: PlaceholderAPI (ondersteuning voor numerieke placeholders), PacketEvents of ProtocolLib (verbeterde packet-gebaseerde blokkering), EssentialsX (integratie voor godmode/fly-gedrag).

🧾 Configuratie

• Pluginberichten worden opgeslagen in plugins/WorldGuard/messages-wgefp.yml en zijn volledig aanpasbaar; er is een bericht-cooldown­systeem dat via de pluginconfig is in te stellen.

🧠 Technische notities

• Het project declareert api-version: 1.21 en richt zich op moderne Paper API-artifacts; Folia-compatibiliteit is geïmplementeerd en bevestigd.
• Java-bytecode en API-targeting sluiten aan op recente serveromgevingen uit de 1.21-periode.
• De plugin vervangt het oudere gedrag permit-completely door disable-completely voor bredere semantiek voor het blokkeren van items.
• Sommige functies (bijvoorbeeld volledige blokkering van bepaalde spear-lunge-mechanieken) werken betrouwbaarder wanneer PacketEvents of ProtocolLib aanwezig zijn.
• De plugin stelt veel flags beschikbaar via de standaard WorldGuard-flagcommando’s (flags worden ingesteld via de WorldGuard-regioflaginterface).

🤝 Wanneer is deze plugin nuttig

Als je WorldGuard gebruikt en extra, bevestigde regioflags nodig hebt om itemgebruik, regels voor spelerinvoer, crafting en ander regiogebonden gedrag te beheren — vooral op Paper- of Folia-servers — centraliseert WorldGuard ExtraFlags Plus die mogelijkheden binnen het flagsysteem van WorldGuard, zonder aparte plugins voor regiobeheer nodig te hebben.