Xray w Minecraft potrafi zniszczyć sens uczciwego wydobycia szybciej, niż wielu właścicieli serwerów się spodziewa. Dlatego ochrona anty-xray nie jest ozdobą konfiguracji, tylko jednym z tych elementów, które realnie wpływają na balans, ekonomię i komfort gry. Poniżej pokazuję, jak działa takie zabezpieczenie, kiedy wystarczy wbudowana ochrona Paper, a kiedy lepiej sięgnąć po osobny plugin i dodatkową detekcję.
Najważniejsze wnioski przed wdrożeniem ochrony anty-xray
- Najlepsze rozwiązania działają po stronie serwera, a nie klienta.
- W serwerach Paper często wystarcza wbudowany system obfuskacji rud.
- Osobny plugin ma sens wtedy, gdy potrzebujesz większej kontroli, logów albo szerszej kompatybilności.
- Żaden system nie daje stuprocentowej ochrony, więc warto łączyć obfuskację z antycheatem i dobrą konfiguracją świata.
- Najczęstsze błędy to stary config, zły `max-block-height` i używanie `/reload` zamiast pełnego restartu.
Czym jest ochrona anty-xray i kiedy naprawdę ma sens
Xray w Minecraft polega na tym, że gracz widzi złoża przez ściany, zwykle dzięki modowi, zmodyfikowanemu klientowi albo resource packowi. Z punktu widzenia administracji serwera to nie jest drobne obejście zasad, tylko bezpośrednie uderzenie w progres i gospodarkę. Jeśli rudy mają znaczenie dla ekonomii, handlu albo rywalizacji o zasoby, brak ochrony bardzo szybko odbija się na uczciwych graczach.
W praktyce ochrona anty-xray ma dwa cele. Po pierwsze, utrudnić podgląd rud, zanim klient dostanie zbyt dużo informacji. Po drugie, wykryć podejrzane zachowania, jeśli ktoś i tak próbuje obejść zabezpieczenie. To dlatego sama detekcja nie zastępuje obfuskacji, a sama obfuskacja nie wyłapie każdego obejścia.
Najbardziej potrzebują jej serwery survivalowe, SMP, ekonomiczne i factions, czyli wszędzie tam, gdzie kopanie ma realną wartość. Na małym prywatnym świecie można czasem odpuścić cięższą konfigurację, ale publiczny serwer bez takiej warstwy ochrony zwykle kończy z tym samym problemem: uczciwi gracze przestają ufać systemowi wydobycia. I właśnie dlatego warto najpierw zrozumieć, jak serwer ukrywa dane przed klientem.

Jak działa obfuskacja rud w praktyce
Najprościej mówiąc, serwer nie pokazuje graczowi prawdziwych danych tam, gdzie nie powinien ich jeszcze znać. Zamiast tego wysyła zniekształcony obraz chunków, tak aby rudy nie były oczywiste dla klienta. Chunk to 16 na 16 kolumn bloków, więc właśnie na tym poziomie większość takich zabezpieczeń robi swoją robotę.
W dokumentacji PaperMC to podejście opisano jako system oparty na trzech trybach silnika. Różnią się one poziomem agresji, kosztem obliczeniowym i tym, jak mocno ukrywają złoża. Najlepiej widać to w praktycznym zestawieniu:
| Tryb | Jak działa | Kiedy ma sens |
|---|---|---|
| engine-mode 1 | Ukrywa wskazane bloki, zastępując je blokami maskującymi zależnymi od wymiaru. | Gdy zależy ci na lekkości rozwiązania i dobrym stosunku wydajności do skuteczności. |
| engine-mode 2 | Silniej miesza bloki ukrywane i zastępcze, dzięki czemu trudniej odczytać prawdziwe złoża. | Gdy priorytetem jest mocniejsza ochrona, nawet kosztem większej złożoności konfiguracji. |
| engine-mode 3 | Działa podobnie do trybu 2, ale obfuskacja jest wykonywana warstwami chunków. | Gdy chcesz ograniczyć koszt sieciowy przy dołączaniu graczy i poprawić kompresję pakietów. |
W konfiguracji pojawiają się też trzy pojęcia, które warto rozumieć bez technicznego żargonu. `hidden-blocks` to lista bloków, które mają być ukrywane. `replacement-blocks` to bloki maskujące, czyli to, czym serwer przykrywa zawartość świata. `update-radius` określa, jak szeroko serwer wysyła prawdziwe dane po interakcji z blokiem. Z kolei `max-block-height` mówi, do jakiej wysokości ochrona ma w ogóle działać.
Najważniejsze jest tu jedno: mocniejsza obfuskacja nie oznacza automatycznie lepszej decyzji. Jeśli ustawisz zbyt agresywne maskowanie, możesz pogorszyć komfort uczciwych graczy, zwłaszcza na słabszych klientach. Jeśli ustawisz je zbyt miękko, xray nadal będzie dawał przewagę. I właśnie dlatego wybór narzędzia ma znaczenie równie duże jak sama konfiguracja.
Czy wystarczy Paper, czy lepiej dołożyć osobny plugin
Ja zwykle zaczynam od pytania, na jakim stacku działa serwer. Jeśli to Paper, wbudowany system anty-xray jest pierwszym miejscem, do którego warto zajrzeć. To nie jest dodatkowy plugin, tylko część serwera, więc odpada ci jedna warstwa instalacji, jedna zależność i sporo niepotrzebnego szumu diagnostycznego.
| Rozwiązanie | Co daje | Plusy | Ograniczenia | Dla kogo |
|---|---|---|---|---|
| Wbudowany anty-xray Paper | Obfuskację po stronie serwera, rozdzieloną per świat. | Dobra wydajność, prosty start, brak dodatkowego pluginu. | Mniej elastyczny niż wyspecjalizowana wtyczka, nie rozwiązuje wszystkich obejść. | Większość serwerów survival i SMP na Paper. |
| Orebfuscator | Zaawansowaną obfuskację pakietów i większą kontrolę nad widocznością bloków. | Duża konfiguracja, wsparcie dla popularnych forków, możliwość dopasowania pod konkretny serwer. | Więcej ustawień i zależności, trzeba go dobrze przetestować. | Serwery, które chcą dokładniejszego sterowania ochroną. |
| Plugin detekcyjny lub antycheat | Wykrywanie podejrzanych wzorców kopania i sygnałów obejścia ochrony. | Logi, alerty dla administracji, dodatkowa warstwa bezpieczeństwa. | Nie ukrywa rud sam z siebie, więc nie zastępuje obfuskacji. | Publiczne serwery z aktywną moderacją. |
W praktyce sensowna kolejność jest prosta: najpierw włączam ochronę w Paper, a dopiero potem oceniam, czy potrzebuję mocniejszego pluginu. Orebfuscator ma sens wtedy, gdy chcesz większej kontroli albo działasz na stacku, który wymaga bardziej wyspecjalizowanego podejścia. Rozwiązania detekcyjne traktuję jako drugi poziom obrony, nie jako zastępstwo ukrywania rud, bo same nie rozwiążą problemu xraya.
To prowadzi do pytania, jak dobrać ustawienia tak, żeby nie przepalić wydajności i nie zrobić z gry wizualnego chaosu.
Jak dobrać ustawienia do typu serwera
Najważniejsza zasada brzmi: nie kopiuj konfiguracji w ciemno z cudzej paczki. To, co działa na małym serwerze prywatnym, często nie sprawdzi się na publicznym survivalu z kilkudziesięcioma graczami. Ja zwykle patrzę na trzy rzeczy: wysokość świata, styl kopania i tolerancję na koszt wydajności.
- Jeśli serwer ma być lekki i stabilny, zacznij od engine-mode 1. To dobry punkt wyjścia, bo jest mniej kosztowny i prostszy do utrzymania.
- Jeśli gracze kopią głównie w jaskiniach i zależy ci na mocniejszym ukrywaniu, rozważ engine-mode 2 albo 3. Wtedy nawet rudy przy otwartych przestrzeniach mają mniejsze szanse zdradzić pozycję.
- Jeśli ustawiasz tryb 2 lub 3 i chcesz ukrywać rudy widoczne od strony powietrza, dodanie `air` do `hidden-blocks` może pomóc, ale testuj to ostrożnie. Część klientów zaczyna wtedy tracić płynność.
- Sprawdź `max-block-height` pod kątem swojego świata. W 2026 nie zakładałbym, że domyślna wartość będzie dobra bez zastanowienia, zwłaszcza w świecie generowanym po dużych zmianach wysokości terenu.
- Zaktualizuj listy `hidden-blocks` i `replacement-blocks`, jeśli korzystasz ze starszego configu. W nowych światach łatwo pominąć deepslate albo biome-specific blocki, które powinny być uwzględnione.
- Po zmianach rób pełny restart serwera. `/reload` przy takiej konfiguracji to proszenie się o problemy.
Warto też pamiętać o `update-radius`. W praktyce warto zacząć od domyślnego bezpiecznego ustawienia i dopiero po testach schodzić niżej lub wyżej, jeśli naprawdę wiesz, po co to robisz. Zbyt agresywne cięcie tej wartości może poprawić wrażenia tylko na papierze, a w realnej grze dać nieprzyjemne artefakty przy interakcji z blokami. Kiedy ustawienia są już rozsądne, zostaje najtrudniejsza część: poznanie granic całego systemu.
Gdzie system zawodzi i jak to obejść bez złudzeń
Oficjalna dokumentacja PaperMC bardzo uczciwie pokazuje, że anty-xray nie jest kuloodporny. Jednym z problemów jest tzw. range extension, czyli sytuacja, w której gracz uzyskuje lepszy niż normalnie podgląd realnych rud. Sam anty-xray tego nie zamyka w pełni, więc jeśli serwer jest większy i bardziej konkurencyjny, warto dołożyć dobry antycheat, który wychwyci nienaturalne zachowania.
Drugim problemem jest seed reversing. Jeśli klient pozna seed świata, może zacząć wyliczać prawdziwe pozycje rud i ominąć obfuskację całkowicie. Tego nie naprawia się jednym suwakiem w konfiguracji. Pomaga ograniczanie wycieków seedu, ostrożne zarządzanie seedami między światami i unikanie niepotrzebnego ujawniania danych, ale to nadal nie daje pełnej gwarancji.
Trzeci obszar to rudy wystawione na powietrze albo przezroczyste bloki. W trybie 1 zwykle będą widoczne, bo system ukrywa przede wszystkim bloki całkowicie zasłonięte. W trybie 2 i 3 można to częściowo obejść, ale wtedy płacisz wydajnością albo komfortem klienta. Właśnie tu widać najuczciwszy kompromis całego rozwiązania: im lepsza ochrona, tym większe ryzyko kosztu ubocznego.
Do tego dochodzi jeszcze jeden praktyczny szczegół, o którym wiele osób zapomina: jeśli włączysz `use-permission`, gracze z odpowiednim uprawnieniem albo operatorzy mogą ominąć ochronę. To bywa przydatne, ale tylko wtedy, gdy naprawdę wiesz, kto ma mieć taki dostęp. W przeciwnym razie sam tworzysz sobie furtkę, przez którą system przestaje być spójny. Skoro znasz już ograniczenia, można przejść do zestawu ustawień, od którego najrozsądniej zacząć.
Mój praktyczny zestaw startowy na 2026
Gdybym dziś miał uruchamiać nowy serwer survivalowy, zacząłbym bardzo prosto. Na Paper najpierw włączyłbym wbudowany anty-xray, ustawił sensowny `engine-mode`, przetestował `hidden-blocks` dla rud z mojego świata i dopiero potem zdecydował, czy potrzebuję mocniejszej warstwy przez osobny plugin. To daje szybki efekt bez dokładania zbędnej komplikacji.
- Na start wybierz ochronę wbudowaną w Paper, jeśli serwer na nim działa.
- Jeśli zależy ci głównie na wydajności, zostań przy trybie 1.
- Jeśli chcesz mocniej utrudnić xray, testuj 2 lub 3, ale sprawdzaj odczucia graczy i FPS.
- Do większych serwerów dołóż antycheat albo plugin detekcyjny, żeby łapać obejścia i prowadzić sensowne logowanie.
- Zawsze testuj konfigurację na osobnym koncie i z klientem nastawionym na wykrywanie rud, bo teoria bez praktyki szybko wprowadza w błąd.
Najlepszy efekt daje nie najbardziej agresywna konfiguracja, tylko taka, która pasuje do stylu gry, wysokości świata i liczby graczy. Jeśli mam zostawić jedną praktyczną radę, to tę: najpierw zbuduj ochronę, która nie męczy uczciwych graczy, a dopiero potem dokręcaj śrubę. Właśnie tak serwer przestaje być łatwym celem, a zaczyna działać jak uczciwe miejsce do kopania, handlu i rywalizacji.
