Minecraft-plugin WorldGuardExtraFlagsPlus

🔌 Om WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus er en udvidelse til WorldGuard-pluginen, som tilføjer ekstra regionsflags og adfærd. Den udvider WorldGuards regionssystem med mere end 40 bekræftede flags til at styre brug af items, teleportering, adgangsgrænser, crafting, spillerkollision, handel med villagers og andre regionsspecifikke regler.

🎯 Formål

Pluginen udfylder hullerne i WorldGuards indbyggede flags ved at give finmasket kontrol over spillerhandlinger og regionspolitikker. Den er beregnet til serveradministratorer, der har brug for tilpasning på regionsniveau ud over kernefunktionerne i WorldGuard, for eksempel til at bygge beskyttede PvP-arenas, lobbies, hub-adfærd eller begrænsede spilzoner.

⚙️ Funktioner

• Tilføjer 40+ ekstra flags (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Nye plus-specifikke 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.
• Tilpassede beskeder gemt i messages-wgefp.yml (cooldown på beskeder for at forhindre spam).
• Valgfri integrationshooks: PlaceholderAPI-understøttelse til numeriske placeholders, valgfrie PacketEvents- eller ProtocolLib-packet hooks for at forbedre blokering af visse items/angreb.
• EssentialsX-integration: forbedringer til godmode- og fly-flag deaktiverer EssentialsX godmode/fly, når disse flags nægtes.
• Understøttelse af Folia og async-sikre handlers, hvor det er relevant.
• Opdateringstjek og et eksperimentelt hide-players-flag samt eksperimentel chambered-enderpearl-adfærd.
• console-command-repeat-flag til at køre en konsolkommando gentagne gange, mens en spiller bliver i en region (deaktiveret som standard).

🧩 Hvem det er til

• Serverejere og admins, der kører WorldGuard og har brug for mere præcis regionskontrol.
• Survival-, SMP-, hub/lobby- og PvP-servere, der kræver regionsbaseret adfærd.
• Servere, der bruger Paper eller Folia, hvor der er behov for async- eller fork-specifik understøttelse.

🏗️ Eksempler på brug

• Begræns antallet af spillere i en arena-region med player-count-limit.
• Bloker brug og kast af bestemte items (mace, trident, ender pearls) i eventzoner med disable-completely og disable-throw.
• Forhindr crafting i inventory (2x2) i sikre zoner med inventory-craft eller bloker brug af workbench med permit-workbenches.
• Begræns regionsadgang efter spillerens XP-niveau eller en numerisk PlaceholderAPI-værdi med entry-min-level / entry-max-level.
• Kør en konsolkommando gentagne gange, mens spillere bliver i regionen, med console-command-repeat.

⌨️ Kommandoer

⚙️ Installation

📥 Opsætning

• Download den officielle JAR og læg den i serverens plugins/-mappe sammen med WorldGuard.
• Hvis du opgraderer fra den ældre WorldGuardExtraFlags: fjern den gamle WorldGuardExtraFlags.jar, før du starter — de to kan ikke eksistere side om side.
• Genstart serveren og tjek serverkonsollen for at bekræfte, at pluginen og dens flags er indlæst korrekt.

📦 Afhængigheder

• Påkrævet: WorldGuard (dette projekt er en udvidelse til WorldGuard).
• Valgfrit / integrationer: PlaceholderAPI (understøttelse af numeriske placeholders), PacketEvents eller ProtocolLib (forbedret packet-baseret blokering), EssentialsX (integration til godmode/fly-adfærd).

🧾 Konfiguration

• Plugin-beskeder gemmes i plugins/WorldGuard/messages-wgefp.yml og kan tilpasses fuldt ud; der findes et cooldown-system for beskeder, som kan konfigureres via pluginens config.

🧠 Tekniske noter

• Projektet deklarerer api-version: 1.21 og sigter mod moderne Paper API-artifacts; Folia-kompatibilitet er implementeret og bekræftet.
• Java-bytecode og API-targeting matcher nyere servermiljøer fra 1.21-æraen.
• Pluginen erstatter den ældre permit-completely-adfærd med disable-completely for bredere semantik for item-blokering.
• Nogle funktioner (for eksempel fuld blokering af visse spear-lunge-mekanikker) er mere pålidelige, når PacketEvents eller ProtocolLib er til stede.
• Pluginen eksponerer mange flags via WorldGuards standard flag-kommandoer (flags sættes via WorldGuards regionsflag-interface).

🤝 Hvornår denne plugin er nyttig

Hvis du kører WorldGuard og har brug for yderligere, bekræftede regionsflags til at styre brug af items, spillernes adgangsregler, crafting og anden regionsspecifik adfærd — især på Paper- eller Folia-servere — samler WorldGuard ExtraFlags Plus disse muligheder i WorldGuards flagsystem uden behov for separate region-management plugins.