Plugin Minecraft WorldGuardExtraFlagsPlus

🔌 O WorldGuard ExtraFlags Plus

WorldGuard ExtraFlags Plus to rozszerzenie do pluginu WorldGuard, które dodaje dodatkowe flagi i zachowania dla regionów. Rozszerza system regionów WorldGuard o ponad 40 potwierdzonych flag do नियंत्रowania użycia przedmiotów, teleportacji, limitów wejścia, craftingu, kolizji między graczami, handlu z wieśniakami i innych reguł specyficznych dla regionu.

🎯 Cel

Plugin wypełnia luki w domyślnych flagach WorldGuard, oferując precyzyjną kontrolę nad działaniami graczy i zasadami regionów. Jest przeznaczony dla administratorów serwerów, którzy potrzebują personalizacji na poziomie regionu wykraczającej poza podstawowy WorldGuard, na przykład do tworzenia chronionych aren PvP, lobby, zachowania hubów lub ograniczonych stref rozgrywki.

⚙️ Funkcje

• Dodaje ponad 40 dodatkowych flag (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Nowe flagi specyficzne dla 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.
• Konfigurowalne wiadomości zapisane w messages-wgefp.yml (cooldown wiadomości, aby zapobiec spamowi).
• Opcjonalne integracje: obsługa PlaceholderAPI dla liczbowych placeholderów, opcjonalne hooki pakietów PacketEvents lub ProtocolLib, aby poprawić blokowanie niektórych przedmiotów/ataków.
• Integracja z EssentialsX: ulepszenia flag godmode i fly wyłączają godmode/fly EssentialsX, gdy te flagi są odrzucone.
• Obsługa Folia i bezpieczne dla async handlery tam, gdzie ma to zastosowanie.
• Sprawdzanie aktualizacji oraz eksperymentalna flaga hide-players i eksperymentalne zachowanie chambered-enderpearl.
• Flaga console-command-repeat, aby wykonywać komendę konsoli wielokrotnie, gdy gracz pozostaje w regionie (domyślnie wyłączona).

🧩 Dla kogo jest przeznaczony

• Właścicieli i administratorów serwerów używających WorldGuard, którzy potrzebują dokładniejszych kontroli regionów.
• Serwery Survival, SMP, hub/lobby i PvP, które wymagają zachowania zależnego od regionu.
• Serwery korzystające z Paper lub Folia, gdzie wymagane jest wsparcie async lub specyficzne dla forków.

🏗️ Przykładowe zastosowania

• Ograniczenie liczby graczy w regionie areny za pomocą player-count-limit.
• Zablokowanie użycia i rzucania konkretnych przedmiotów (mace, trident, ender pearls) w strefach eventowych za pomocą disable-completely i disable-throw.
• Zablokowanie craftingu (2x2) w ekwipunku w bezpiecznych strefach za pomocą inventory-craft lub blokada używania stołu rzemieślniczego za pomocą permit-workbenches.
• Ograniczenie wejścia do regionu według poziomu XP gracza lub liczbowej wartości PlaceholderAPI za pomocą entry-min-level / entry-max-level.
• Uruchamianie komendy konsoli wielokrotnie, gdy gracze pozostają w regionie, za pomocą console-command-repeat.

⌨️ Polecenia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR i umieść go w katalogu plugins/ swojego serwera razem z WorldGuard.
• Jeśli aktualizujesz z wcześniejszego WorldGuardExtraFlags: usuń stary WorldGuardExtraFlags.jar przed uruchomieniem — oba nie mogą współistnieć.
• Uruchom ponownie serwer i sprawdź konsolę, aby potwierdzić, że plugin i jego flagi zostały poprawnie załadowane.

📦 Zależności

• Wymagane: WorldGuard (ten projekt jest rozszerzeniem WorldGuard).
• Opcjonalne / Integracje: PlaceholderAPI (obsługa liczbowych placeholderów), PacketEvents lub ProtocolLib (ulepszone blokowanie oparte na pakietach), EssentialsX (integracja zachowania godmode/fly).

🧾 Konfiguracja

• Wiadomości pluginu są przechowywane w plugins/WorldGuard/messages-wgefp.yml i są w pełni konfigurowalne; istnieje system cooldownu wiadomości konfigurowalny w konfiguracji pluginu.

🧠 Uwagi techniczne

• Projekt deklaruje api-version: 1.21 i celuje w nowoczesne artefakty API Paper; kompatybilność z Folia jest zaimplementowana i potwierdzona.
• Kod bajtowy Java i cel API są zgodne z nowszymi środowiskami serwerowymi ery 1.21.
• Plugin zastępuje starsze zachowanie permit-completely flagą disable-completely, aby zapewnić szerszą semantykę blokowania przedmiotów.
• Niektóre funkcje (na przykład całkowite blokowanie niektórych mechanik pchnięcia włócznią) działają pewniej, gdy obecne są PacketEvents lub ProtocolLib.
• Plugin udostępnia wiele flag przez standardowe komendy flag WorldGuard (flagi są ustawiane za pomocą interfejsu flag regionu WorldGuard).

🤝 Kiedy ten plugin jest przydatny

Jeśli używasz WorldGuard i potrzebujesz dodatkowych, potwierdzonych flag regionu do kontroli użycia przedmiotów, zasad wejścia graczy, craftingu i innych zachowań per-region — szczególnie na serwerach Paper lub Folia — WorldGuard ExtraFlags Plus centralizuje te możliwości w systemie flag WorldGuard bez potrzeby używania osobnych pluginów do zarządzania regionami.