Plugin Minecraft GrimAC

🔌 O GrimAC

GrimAC to open-source'owy plugin anti-cheat do Minecrafta, który implementuje predykcyjny silnik symulacji ruchu oraz asynchroniczne, wielowątkowe sprawdzenia do wykrywania cheatów po stronie klienta. Projekt wykonuje wiele testów na wątkach sieciowych, precyzyjnie odtwarza ruch gracza i zawiera kompensację laga, aby zmniejszyć liczbę fałszywych trafień. Oficjalne wydania udostępniają buildy dla środowisk serwerowych Java Edition.

🎯 Cel

Głównym celem GrimAC jest wykrywanie i ograniczanie oszustw związanych z ruchem, timingiem, reach i innymi exploitami po stronie klienta poprzez odtwarzanie możliwych stanów gracza na serwerze i porównywanie ich z zachowaniem zgłaszanym przez klienta. Narzędzie jest przeznaczone dla administratorów serwerów, którzy potrzebują automatycznego wykrywania i konfigurowalnych kar, aby utrzymać uczciwą rozgrywkę.

⚙️ Funkcje

• Predykcyjna symulacja ruchu 1:1 obejmująca chodzenie, pływanie, knockback, pajęczyny, słupy bąbelków i jazdę na encjach.
• Asynchroniczne przetwarzanie ruchu i wielowątkowe sprawdzenia, aby zmniejszyć obciążenie głównego wątku.
• Kompensacja laga w interakcjach graczy, aby ograniczyć fałszywe pozytywy.
• Obsługa wyjątków dla niektórych scenariuszy proxy lub bridge (na przykład wyraźna obsługa graczy Geyser, aby uniknąć fałszywych pozytywów).
• API pluginu dla deweloperów do integracji i rozszerzeń.
• Projekt open source z artefaktami buildów i instrukcjami kompilacji ze źródeł.

🧩 Dla kogo

• Dla właścicieli i administratorów serwerów Java Edition, którzy chcą open-source'owego anti-cheata.
• Dla publicznych lub prywatnych serwerów survival/SMP i anarchy, które wymagają egzekwowania zasad ruchu i walki.
• Dla deweloperów i autorów pluginów, którzy chcą integrować sprawdzenia anti-cheat przez udostępnione API.

🏗️ Przykładowe zastosowania

• Egzekwowanie uczciwego PvP na serwerze survival poprzez wykrywanie zwiększonego reach i nietypowej prędkości.
• Zapobieganie exploitom fly, step lub glide na publicznych serwerach z uwzględnieniem laga graczy.
• Integracja wykryć GrimAC z narzędziami moderacyjnymi przy użyciu API pluginu.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu dla swojej wersji serwera.
• Umieść JAR w katalogu plugins/ serwera.
• Upewnij się, że serwer działa na Java 17 lub nowszym, i uruchom go ponownie.
• Sprawdź konsolę/logi serwera, aby potwierdzić, że GrimAC został poprawnie załadowany.

📦 Zależności

• Jeśli używasz Geyser, zainstaluj Floodgate na backendzie, na którym działa GrimAC, aby GrimAC mógł korzystać z Floodgate API.
• Jeśli używasz ViaVersion, zainstaluj ViaVersion tylko na serwerze backendowym; GrimAC nie obsługuje sytuacji, w której ViaVersion jest zainstalowany wyłącznie na proxy.

🛠 Kompilowanie ze źródeł

• Repozytorium zawiera instrukcje budowania; oficjalne kroki to: git clone https://github.com/GrimAnticheat/Grim.git, cd Grim, ./gradlew build. Zbudowane pliki jar pojawiają się w folderach <platform>/build/libs.

🧠 Uwagi techniczne

• Projekt udostępnia swój kod źródłowy i korzysta z licencji z rodziny GPL.
• Oficjalne wymagania obejmują Java 17 lub nowszą oraz obsługiwane środowisko serwera (przykłady: Spigot, Paper, Folia, Fabric).
• Projekt udostępnia nocne artefakty oraz API dla deweloperów do integracji pluginów.
• Opiekunowie dokumentują, że niektóre buildy i platformy są rekomendowane w ich kanałach wydawniczych; sprawdź dokumentację projektu, aby wybrać właściwy artefakt dla swojego środowiska.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz konfigurowalnego, open-source'owego anti-cheata skupionego na dokładnej symulacji ruchu i asynchronicznych sprawdzeniach, GrimAC oferuje API dla deweloperów, buildy dla wielu środowisk i wyraźną obsługę typowych scenariuszy proxy/bridge, dzięki czemu nadaje się do serwerów, które wymagają precyzyjnego wykrywania przy jednoczesnym ograniczaniu fałszywych pozytywów.