Minecraft-plugin WorldGuardExtraFlagsPlus

🔌 Om WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus är ett tillägg för pluginen WorldGuard som lägger till extra regionsflaggor och beteenden. Det utökar WorldGuards regionssystem med över 40 bekräftade flaggor för att styra användning av föremål, teleportering, inträdesgränser, crafting, spelarkollision, handel med bybor och andra regionsspecifika regler.

🎯 Syfte

Pluginen fyller luckorna i WorldGuards inbyggda flaggor genom att erbjuda finmaskig kontroll över spelaråtgärder och regionspolicyer. Den är avsedd för serveradministratörer som behöver anpassning på regionnivå utöver kärnan i WorldGuard, till exempel för att bygga skyddade PvP-arenor, lobbyer, hubb-beteende eller begränsade spelzoner.

⚙️ Funktioner

• Lägger till 40+ extra flaggor (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Nya plus-specifika flaggor: 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.
• Anpassningsbara meddelanden lagrade i messages-wgefp.yml (meddelandecooldown för att förhindra spam).
• Valfria integrationshooks: stöd för PlaceholderAPI för numeriska placeholders, valfria PacketEvents- eller ProtocolLib-packet hooks för att förbättra blockering av vissa föremål/anfall.
• EssentialsX-integration: förbättringar för flaggorna godmode och fly stänger av EssentialsX godmode/fly när dessa flaggor nekas.
• Stöd för Folia och async-säkra handlers där det är tillämpligt.
• Uppdateringskontroll och en experimentell hide-players-flagga samt experimentellt beteende chambered-enderpearl.
• Flaggan console-command-repeat för att köra ett konsolkommando upprepade gånger medan en spelare stannar i en region (inaktiverad som standard).

🧩 Vem det är för

• Serverägare och administratörer som kör WorldGuard och behöver mer exakt regionskontroll.
• Survival-, SMP-, hubb/lobby- och PvP-servrar som kräver regionsbaserat beteende.
• Servrar som använder Paper eller Folia där async- eller fork-specifikt stöd behövs.

🏗️ Exempel på användning

• Begränsa antalet spelare i en arena-region med player-count-limit.
• Blockera användning och kast av vissa föremål (mace, trident, ender pearls) i eventzoner med disable-completely och disable-throw.
• Förhindra crafting i inventory (2x2) i säkra zoner med inventory-craft eller blockera användning av arbetsbänk med permit-workbenches.
• Begränsa regionsinträde efter spelares XP-nivå eller ett numeriskt PlaceholderAPI-värde med entry-min-level / entry-max-level.
• Kör ett konsolkommando upprepade gånger medan spelare befinner sig i en region med console-command-repeat.

⌨️ Kommandon

⚙️ Installation

📥 Konfiguration

• Ladda ner den officiella JAR-filen och lägg den i serverns plugins/-katalog tillsammans med WorldGuard.
• Om du uppgraderar från äldre WorldGuardExtraFlags: ta bort den gamla WorldGuardExtraFlags.jar innan du startar — de två kan inte samexistera.
• Starta om servern och kontrollera serverkonsolen för att bekräfta att pluginen och dess flaggor laddades korrekt.

📦 Beroenden

• Krävs: WorldGuard (detta projekt är ett tillägg för WorldGuard).
• Valfritt / Integrationer: PlaceholderAPI (stöd för numeriska placeholders), PacketEvents eller ProtocolLib (förbättrad paketbaserad blockering), EssentialsX (integration för godmode/fly-beteende).

🧾 Konfiguration

• Pluginmeddelanden lagras i plugins/WorldGuard/messages-wgefp.yml och är helt anpassningsbara; det finns ett system för meddelandecooldown som kan konfigureras via pluginens config.

🧠 Tekniska noteringar

• Projektet deklarerar api-version: 1.21 och riktar sig mot moderna Paper API-artifakter; Folia-kompatibilitet är implementerad och bekräftad.
• Java-bytecode och API-målning är i linje med moderna servermiljöer från 1.21-eran.
• Pluginen ersätter det äldre beteendet permit-completely med disable-completely för bredare semantik för föremålsblockering.
• Vissa funktioner (till exempel fullständig blockering av vissa spear-lunge-mekanismer) är mer tillförlitliga när PacketEvents eller ProtocolLib finns tillgängligt.
• Pluginen exponerar många flaggor via standardkommandon för WorldGuard-flaggor (flaggor sätts med WorldGuards regionsflagggränssnitt).

🤝 När denna plugin är användbar

Om du kör WorldGuard och behöver ytterligare, bekräftade regionsflaggor för att styra användning av föremål, regler för spelares inträde, crafting och annat regionsvis beteende — särskilt på Paper- eller Folia-servrar — centraliserar WorldGuard ExtraFlags Plus dessa möjligheter i WorldGuards flagsystem utan att du behöver separata plugins för regionshantering.