Plugin Minecraft EssentialsAntiBuild

🔌 O AntiBuild

AntiBuild (dystrybuowany jako moduł AntiBuild dla Essentials/EssentialsX) to moduł pluginu do Minecrafta, który wydziela i rozszerza funkcję "antibuild" z pakietu Essentials. Daje administratorom serwera szczegółową, opartą na uprawnieniach kontrolę nad tym, jakie bloki i przedmioty gracze mogą stawiać, niszczyć, używać, craftować, podnosić lub wyrzucać.

🎯 Cel

AntiBuild rozwiązuje problem niechcianych interakcji z blokami/przedmiotami i ukierunkowanego griefingu, pozwalając operatorom ograniczać działania per przedmiot i per blok. Jest przydatny tam, gdzie potrzebujesz scentralizowanych, opartych na uprawnieniach reguł budowania i interakcji zamiast wyłącznie ochrony opartej na regionach.

⚙️ Funkcje

• Globalne blacklisty dla serwera do stawiania, niszczenia, używania i przesuwania wybranych bloków pistomem.
• Blacklista użycia przedmiotów do blokowania określonych interakcji z przedmiotami.
• Oparte na uprawnieniach reguły allow/deny dla place/break/interact/craft/pickup/drop na podstawie ID/nazwy przedmiotu.
• Wsparcie dla starszej składni blacklist (ID) i przejście na nazwy przedmiotów w nowoczesnych wersjach Minecrafta.
• System alertów budowania, który powiadamia staff, gdy określone przedmioty są stawiane, używane lub niszczone.
• Globalne uprawnienie opt-out, które zwalnia zaufanych użytkowników z kontroli i zmniejsza narzut w czasie działania.

🧩 Dla kogo jest ten plugin

• Małe i duże serwery Survival/SMP oraz publiczne, które potrzebują ograniczeń per przedmiot/budowa.
• Serwery, które już używają Essentials/EssentialsX i chcą modularnych funkcji antibuild.
• Administratorów, którzy wolą kontrolę opartą na uprawnieniach niż ochronę regionów dla konkretnych przedmiotów.

🏗️ Przykładowe zastosowania

• Zablokowanie graczom stawiania TNT, pistonów lub innych bloków wpływających na serwer, przy jednoczesnym pozwoleniu na normalne budowanie.
• Zablokowanie użycia wybranych przedmiotów (na przykład krzesiwa i stali), przy jednoczesnym pozwoleniu innym budować.
• Powiadamianie staffu, gdy gracz postawi lub wejdzie w interakcję z monitorowanym przedmiotem.

🔐 Uprawnienia

Uwaga: plugin obsługuje warianty uprawnień z wildcardami i dla konkretnych datavalue (na przykład essentials.build.* lub essentials.build.place.54:*), zgodnie z dokumentacją modułu.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz moduł AntiBuild zgodny z wersją głównego modułu Essentials/EssentialsX (moduł jest wydawany jako dodatek do Essentials/EssentialsX).
• Umieść plik .jar modułu w katalogu plugins/ serwera, obok głównego pluginu Essentials/EssentialsX.
• Uruchom ponownie serwer i sprawdź konsolę, aby potwierdzić, że moduł został załadowany.

📦 Zależności

• EssentialsX (zgodna wersja głównego modułu) — wymagane, ponieważ moduł zależy od głównego pakietu.
• Vault — zalecany/używany przez EssentialsX do integracji ekonomii/uprawnień.
• Plugin uprawnień (przykład: LuckPerms) — wymagany do skutecznego zarządzania węzłami uprawnień dla przedmiotów/bloków.

🧾 Konfiguracja

• AntiBuild używa sekcji konfiguracji blacklist i alertów, gdzie wpisujesz zablokowane/monitorowane przedmioty według ID (legacy) lub według nazwy przedmiotu w nowoczesnych wersjach Minecrafta.
• Standardowe klucze konfiguracji obejmują blacklist.placement, blacklist.usage, blacklist.break, blacklist.piston oraz alert.on-placement, alert.on-use, alert.on-break.
• Moduł udostępnia wzorce uprawnień essentials.build.* dla granularnej kontroli.

🧠 Uwagi techniczne

• Moduł zachowuje wsparcie legacy dla numerycznych ID, ale w Minecraft 1.13+ używa nazw przedmiotów.
• Potwierdź zgodność platformy i wersji z pobraną wersją modułu; nowoczesne buildy EssentialsX podają konkretne wspierane wersje Minecrafta.
• AntiBuild jest dostarczany jako moduł w ekosystemie Essentials/EssentialsX, a nie jako samodzielny, monolityczny plugin.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz precyzyjnej, opartej na uprawnieniach kontroli nad tym, z jakimi przedmiotami i blokami gracze mogą wchodzić w interakcję (na przykład, by zapobiegać griefingowi lub ograniczać bloki wpływające na serwer), AntiBuild pozwala egzekwować te zasady centralnie za pomocą uprawnień i blacklist, jednocześnie integrując się z istniejącą konfiguracją Essentials/EssentialsX.