Plugin Minecraft AntiSpam

🔌 O AntiSpam

AntiSpam to wtyczka do Minecrafta, która monitoruje aktywność czatu i pomaga utrzymać czat serwera w czystości, wykrywając powtarzające się lub podobne wiadomości, flood, zablokowane słowa i inne niepożądane zachowania na czacie. Ma budowę modułową (funkcje można włączać i wyłączać) oraz oferuje zarówno lokalne przechowywanie (SQLite), jak i obsługę MySQL dla większych instalacji i integracji z webem.

🎯 Cel

AntiSpam został zaprojektowany dla administratorów serwerów i zespołów moderacji, które potrzebują automatycznego wykrywania i obsługi nadużyć na czacie: spamu, powtarzających się znaków, szybkiego floodu wiadomości i słów z czarnej listy. Dostarcza też narzędzi do zbierania zgłoszeń i przeglądania historii kar.

⚙️ Funkcje

• Wykrywanie powtarzających się lub bardzo podobnych wiadomości.
• Ochrona przed floodem (limity częstotliwości wiadomości i sprawdzanie nadmiernego powtarzania znaków).
• W pełni konfigurowalna czarna lista zablokowanych słów.
• Automatyczny system kar z konfigurowalnymi wyzwalaczami i własnymi komendami kar.
• Unikalne ID kar do śledzenia i wyszukiwania akcji.
• Inteligentny system zgłoszeń czatu, który zapisuje ostatnie wiadomości do wglądu dla administracji.
• Opcjonalna integracja z panelem webowym (wymaga MySQL), aby przeglądać kary, logi i zgłoszenia.
• Obsługa wielu języków (angielski, czeski, niemiecki) oraz konfigurowalne wiadomości.
• Obsługa webhooków Discorda do powiadomień.

🧩 Dla kogo jest ten plugin

• Serwery Survival / SMP, które chcą automatycznej moderacji czatu.
• Serwery publiczne z aktywną społecznością, gdzie spam i reklamy są problemem.
• Serwery, które chcą mieć dostępny przez web rejestr kar i zgłoszeń czatu.

🏗️ Przykładowe zastosowania

• Automatyczne wyciszenie lub wykonanie komendy kary po tym, jak gracz wielokrotnie powtórzy zablokowane słowa.
• Członkowie administracji otwierają zgłoszenie utworzone przez plugin i widzą zapisany ostatni czat jako kontekst.
• Administratorzy wyszukują historię kar po unikalnym ID, aby potwierdzić lub cofnąć działania.

⌨️ Komendy

Uwaga: Powyżej wymieniono tylko komendy potwierdzone w oficjalnych źródłach projektu.

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu i umieść go w katalogu plugins/ swojego serwera.
• Uruchom serwer ponownie i sprawdź w logach konsoli, czy plugin się ładuje.
• W przypadku funkcji panelu webowego skonfiguruj bazę danych MySQL i włącz integrację web w konfiguracji pluginu.

📦 Zależności

• Nie udokumentowano wymaganych zewnętrznych zależności od innych pluginów. MySQL jest wymagany tylko dla panelu webowego; SQLite jest obsługiwane od razu po instalacji.

🧾 Konfiguracja

• Plugin używa pliku config.yml do ustawień (przełączniki funkcji, limity, opóźnienia, kary, ustawienia bazy danych).
• Dostarczono pliki językowe, które można edytować.

🧠 Uwagi techniczne

• Przechowywanie: wbudowane SQLite dla pojedynczych serwerów; MySQL obsługiwane i wymagane dla panelu webowego.
• Modułowa konstrukcja: poszczególne zabezpieczenia (spam, flood, zablokowane słowa, zgłoszenia, panel web, webhooki Discorda) można włączać i wyłączać.
• Dla każdej zapisanej akcji generowane są unikalne ID kar, aby ułatwić wyszukiwanie i audyt.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz automatycznej, konfigurowalnej moderacji czatu z możliwością zapisywania kar i opcjonalnym dostępem web do logów i zgłoszeń, AntiSpam oferuje modułowy system odpowiedni dla małych serwerów i większych sieci, które wymagają danych opartych na MySQL oraz zdalnego interfejsu web.