🔌 O WorldGuard

WorldGuard to plugin do Minecrafta służący do definiowania chronionych regionów i stosowania reguł specyficznych dla danego obszaru. Umożliwia administratorom serwera i twórcom map tworzenie stref, które kontrolują budowanie, PvP, eksplozje, zachowanie mobów, użycie przedmiotów/bloków oraz wiele innych mechanik rozgrywki za pomocą konfigurowalnych flag i ustawień.

🎯 Cel

WorldGuard rozwiązuje częsty problem serwerów: griefing, przypadkowe lub celowe destrukcyjne mechaniki oraz niespójne zasady gry w różnych obszarach. Zapewnia egzekwowanie zasad na poziomie regionów, dzięki czemu różne części świata mogą mieć niezależne reguły bez zmiany globalnych ustawień serwera.

⚙️ Funkcje

  • Tworzenie i zarządzanie regionami (regiony prostopadłościenne i wielokątne przez zaznaczenia WorldEdit).
  • Flagi per region do włączania/wyłączania zachowań (np. pvp, entry, build, fire spread, TNT, mob griefing, item pickup).
  • Czarna lista bloków/przedmiotów i kontrola interakcji sterowana flagami.
  • Ochrona skrzynek i inne mechaniki związane z ochroną.
  • Narzędzia administracyjne i komendy pomocnicze (raporty, profiling, natychmiastowe komendy kontroli, takie jak zatrzymanie rozprzestrzeniania ognia).
  • Rozszerzalne API i sterowniki magazynu (dokumentacja zawiera sekcje storage i API).

🧩 Dla kogo jest ten plugin

  • Serwery Survival i SMP, które potrzebują ochrony obszarów.
  • Serwery publiczne ze spawnem lub strefami eventowymi wymagającymi własnych reguł.
  • Twórców map i serwery przygodowe, które chcą precyzyjnej kontroli zasad gry dla każdego regionu.
  • Administratorów i moderatorów, którzy potrzebują narzędzi do zarządzania griefingiem i zachowaniem serwera.

🏗️ Przykłady zastosowań

  • Utworzenie regionu spawn, w którym PvP, stawianie bloków i podnoszenie przedmiotów są wyłączone dla osób spoza staffu.
  • Ochrona budowli graczy przed tłokami, działami TNT lub obrażeniami od eksplozji za pomocą flag regionu.
  • Dodanie typu przedmiotu lub bloku do czarnej listy dla użycia w określonych światach lub regionach.
  • Używanie raportów i profilowania WorldGuard do sprawdzania stanu serwera związanego z wydarzeniami ochrony.

⌨️ Komendy

CommandOpisUprawnienieDostęp
/region (alias /rg)Komendy zarządzania regionami (ustawianie flag, lista regionów, tworzenie/usuwanie regionów) — przykłady w dokumentacji: /rg flag i /rg list.opisane w komendach projektuAdmin
/wg reportZrzuca statystyki i raporty związane z ochroną (komenda profile/report istnieje w dokumentacji).opisane w komendach projektuAdmin
/wg profileKomenda związana z CPU/profilingiem udostępniana przez plugin (dokumentacja odnosi się do użycia profilingu).opisane w komendach projektuAdmin

🔐 Uprawnienia

PermissionOpisDomyślnie
worldguard.region.flag.regions.own.<region name>Węzeł uprawnienia wspomniany w dokumentacji dla operacji flag ograniczonych do posiadanych regionów.nie określono
worldguard.region.flag.flags.chest-accessWęzeł uprawnienia wspomniany w dokumentacji w związku z flagą chest-access.nie określono

⚙️ Instalacja

📥 Konfiguracja

  • Upewnij się, że używasz serwerowej implementacji zgodnej z Bukkit (dokumentacja i repozytorium WorldGuard podają, że wymagana jest implementacja Bukkit, taka jak Paper).
  • Zainstaluj WorldEdit (WorldGuard wymaga WorldEdit jako zależności).
  • Pobierz oficjalny plik .jar pluginu WorldGuard (strony pobierania projektu są utrzymywane przez projekt).
  • Umieść .jar w katalogu plugins/ serwera i uruchom serwer ponownie.
  • Sprawdź konsolę serwera pod kątem komunikatów startowych WorldGuard, aby potwierdzić, że został załadowany.

📦 Zależności

  • WorldEdit (wymagany).

🧠 Uwagi techniczne

  • WorldGuard jest open source, a repozytorium i dokumentacja projektu dostarczają informacji o API i sterownikach magazynu.
  • Projekt jest utrzymywany w organizacji EngineHub, a kod źródłowy jest publikowany w repozytorium projektu.
  • Plugin udostępnia wiele komend oraz granularny system uprawnień; pełną listę komend i węzłów uprawnień znajdziesz w oficjalnej dokumentacji.
  • Instalacja i konfiguracja funkcji (flag, storage) są opisane w oficjalnej dokumentacji.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz ukierunkowanej ochrony specyficznej dla regionu oraz kontroli rozgrywki (dla obszarów spawn, budowli graczy lub reguł specyficznych dla map), WorldGuard zapewnia dojrzały, konfigurowalny system do stosowania i zarządzania tymi zasadami bez zmieniania globalnego zachowania serwera.

Serwery z pluginem WorldGuard

Strona pluginu WorldGuard pokazuje serwery, na których monitoring znalazł ten plugin, używaną platformę i wersję.

Plugin może dodawać komendy, ekonomię, bezpieczeństwo, uprawnienia dostępu, minigry, integracje i inne mechaniki. Rzeczywista rola WorldGuard zależy od ustawień serwera.

Dane są generowane automatycznie z technicznych odpowiedzi serwerów. Jeśli serwer trzyma listę pluginów prywatnie, może używać WorldGuard, ale nie pojawiać się w tej sekcji.

Użyj listy serwerów z WorldGuard, aby porównać projekty, sprawdzić wspierane wersje lub znaleźć przykłady użycia pluginu na publicznych serwerach.