Minecraft-Plugin WorldGuardExtraFlagsPlus

🔌 Über WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus ist eine Erweiterung für das WorldGuard-Plugin, die zusätzliche Regions-Flags und Verhaltensweisen bereitstellt. Es erweitert das Regionssystem von WorldGuard um mehr als 40 bestätigte Flags, um die Nutzung von Gegenständen, Teleportation, Eintrittsgrenzen, Crafting, Spielerkollision, Händlerhandel und andere regionsspezifische Regeln zu steuern.

🎯 Zweck

Das Plugin schließt Lücken in den eingebauten WorldGuard-Flags, indem es eine fein granulare Kontrolle über Spieleraktionen und Regionsrichtlinien bietet. Es richtet sich an Server-Administratoren, die eine Anpassung auf Regionsebene über das Kern-WorldGuard hinaus benötigen, zum Beispiel für geschützte PvP-Arenen, Lobbys, Hub-Verhalten oder eingeschränkte Spielzonen.

⚙️ Funktionen

• Fügt 40+ zusätzliche Flags hinzu (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Neue Plus-spezifische 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.
• Anpassbare Nachrichten, gespeichert in messages-wgefp.yml (Nachrichten-Cooldown, um Spam zu verhindern).
• Optionale Integrations-Hooks: PlaceholderAPI-Unterstützung für numerische Platzhalter, optionale PacketEvents- oder ProtocolLib-Packet-Hooks zur Verbesserung der Blockierabdeckung für bestimmte Gegenstände/Angriffe.
• EssentialsX-Interaktion: Die Verbesserungen der Flags godmode und fly deaktivieren EssentialsX-Godmode/Fly, wenn diese Flags verweigert werden.
• Folia-Unterstützung und wo anwendbar async-sichere Handler.
• Update-Prüfer sowie ein experimentelles hide-players-Flag und das experimentelle Verhalten chambered-enderpearl.
• console-command-repeat-Flag, um einen Konsolenbefehl wiederholt auszuführen, solange sich ein Spieler in einer Region aufhält (standardmäßig deaktiviert).

🧩 Für wen es gedacht ist

• Serverbesitzer und Admins, die WorldGuard betreiben und genauere Regionskontrollen benötigen.
• Survival-, SMP-, Hub/Lobby- und PvP-Server, die regionsbasiertes Verhalten anpassen müssen.
• Server mit Paper oder Folia, bei denen async- oder fork-spezifische Unterstützung erforderlich ist.

🏗️ Beispiel-Anwendungsfälle

• Die Spielerzahl in einer Arena-Region mit player-count-limit begrenzen.
• Die Nutzung und das Werfen bestimmter Gegenstände (mace, trident, ender pearls) in Event-Zonen mit disable-completely und disable-throw blockieren.
• Crafting im Inventar (2x2) in Safe-Zones mit inventory-craft verhindern oder die Nutzung der Werkbank mit permit-workbenches blockieren.
• Den Eintritt in eine Region anhand des XP-Levels eines Spielers oder eines numerischen PlaceholderAPI-Werts mit entry-min-level / entry-max-level einschränken.
• Einen Konsolenbefehl wiederholt ausführen, während sich Spieler in einer Region aufhalten, mit console-command-repeat.

⌨️ Befehle

⚙️ Installation

📥 Einrichtung

• Lade die offizielle JAR-Datei herunter und lege sie zusammen mit WorldGuard in das plugins/-Verzeichnis deines Servers.
• Wenn du von der älteren WorldGuardExtraFlags-Version aktualisierst: Entferne vor dem Start die alte WorldGuardExtraFlags.jar — beide können nicht nebeneinander existieren.
• Starte den Server neu und prüfe die Serverkonsole, um zu bestätigen, dass das Plugin und seine Flags korrekt geladen wurden.

📦 Abhängigkeiten

• Erforderlich: WorldGuard (dieses Projekt ist eine Erweiterung für WorldGuard).
• Optional / Integrationen: PlaceholderAPI (Unterstützung für numerische Platzhalter), PacketEvents oder ProtocolLib (verbessertes blockierendes, paketbasiertes Verhalten), EssentialsX (Integration für das Verhalten von Godmode/Fly).

🧾 Konfiguration

• Die Plugin-Nachrichten werden in plugins/WorldGuard/messages-wgefp.yml gespeichert und sind vollständig anpassbar; es gibt ein Nachrichten-Cooldown-System, das über die Plugin-Konfiguration konfiguriert werden kann.

🧠 Technische Hinweise

• Das Projekt deklariert api-version: 1.21 und zielt auf moderne Paper-API-Artefakte ab; die Folia-Kompatibilität ist implementiert und bestätigt.
• Java-Bytecode und API-Zielsetzung sind auf Serverumgebungen der jüngeren 1.21-Ära ausgerichtet.
• Das Plugin ersetzt das ältere permit-completely-Verhalten durch disable-completely für eine breitere Semantik beim Blockieren von Gegenständen.
• Einige Funktionen (zum Beispiel das vollständige Blockieren bestimmter Speer-Sturmmechaniken) sind zuverlässiger, wenn PacketEvents oder ProtocolLib vorhanden sind.
• Das Plugin stellt viele Flags über die standardmäßigen WorldGuard-Flag-Befehle bereit (Flags werden über die WorldGuard-Schnittstelle für Regions-Flags gesetzt).

🤝 Wann dieses Plugin nützlich ist

Wenn du WorldGuard verwendest und zusätzliche, bestätigte Regions-Flags brauchst, um die Nutzung von Gegenständen, Eintrittsregeln für Spieler, Crafting und andere regionsbezogene Verhaltensweisen zu steuern — besonders auf Paper- oder Folia-Servern — zentralisiert WorldGuard ExtraFlags Plus diese Möglichkeiten innerhalb des Flag-Systems von WorldGuard, ohne separate Plugins zur Regionsverwaltung zu benötigen.