Co zmienia anti-xray, a czego nie rusza
Mod albo paczka zasobów X-ray może pokazać tylko to, co wysłał serwer, a Minecraft wysyła każdy blok chunka, łącznie z zakopanymi diamentami. Anti-xray w Paperze edytuje tę kopię w drodze do gracza: rudy, których nikt nie mógł zobaczyć, zostają zamienione na kamień albo wymieszane z fałszywkami. Chunk zapisany na dysku zostaje taki, jaki był, więc późniejsze wyłączenie funkcji niczego nie traci. To część Papera, nic nie trzeba instalować, a funkcja jest wyłączona, dopóki jej nie włączysz.
| Oprogramowanie serwera | Anti-xray | Co zrobić |
|---|---|---|
| Paper | Wbudowany, domyślnie wyłączony | Włącz go w konfiguracji świata Papera |
| Purpur | Odziedziczony po Paperze | Użyj tych samych plików i opcji |
| Vanilla | Brak | Przejdź na Paper albo Purpur; vanilla nie wczytuje ani pluginów, ani modów |
| Fabric i NeoForge | Brak wbudowanego | Dodaj mod AntiXray |
Gdzie są ustawienia w Paperze 26.x
Paper trzyma ustawienia świata w dwóch warstwach. config/paper-world-defaults.yml dotyczy każdego świata, a paper-world.yml w folderze wymiaru nadpisuje te wartości tylko dla tego wymiaru. Od 26.1 wymiary leżą w głównym folderze świata, a ich pliki przeniosły się razem z nimi.
| Plik | Dotyczy |
|---|---|
config/paper-world-defaults.yml | Każdego wymiaru, chyba że jego własny plik mówi inaczej |
world/dimensions/minecraft/overworld/paper-world.yml | Overworldu |
world/dimensions/minecraft/the_nether/paper-world.yml | Netheru |
world/dimensions/minecraft/the_end/paper-world.yml | Endu |
world_nether/paper-world.yml i world_the_end/paper-world.yml | Netheru i Endu w Paperze 1.21.11 i starszych |
world oznacza level-name z server.properties.

Otwórz plik
W zakładce „Pliki” kliknij folder
configi naciśnij „Edytuj” obokpaper-world-defaults.yml. Dla jednego wymiaru otwórzworld/dimensions/minecraft, potem folder tego wymiaru, i edytuj jegopaper-world.yml.Zachowaj kopię i uważaj na spacje
Najpierw naciśnij „Pobierz” przy pliku. YAML czyta wcięcia, więc wcinaj spacjami, nigdy tabulatorami. Jak ostrzega panel, zepsuta konfiguracja może zablokować start serwera.
Zapisz i zrestartuj
Naciśnij „Zapisz”, a potem „Restart” w zakładce „Konsola”. Zmiany anti-xray działają dopiero po starcie serwera.

Każda opcja i jej wartość domyślna
| Opcja pod anticheat.anti-xray | Domyślnie | Co robi |
|---|---|---|
enabled | false | Włącza anti-xray dla światów, których dotyczy ten plik. |
engine-mode | 1 | Jak ukrywane są bloki: 1, 2 albo 3. |
max-block-height | 64 | Zmieniane są tylko bloki poniżej tego poziomu Y. Paper zaokrąga go w dół do wielokrotności 16, więc 70 działa jak 64. |
update-radius | 2 | Jak daleko wokół wykopywanego bloku odsłaniane są prawdziwe bloki: 0, 1 albo 2. |
lava-obscures | false | Przy true stojąca lawa liczy się jako osłona. Słabo działa z rudami, które nie wyglądają jak kamień. |
use-permission | false | Przy true gracze z paper.antixray.bypass widzą prawdziwe bloki. |
hidden-blocks | 23 bloki | Tryb 1: bloki do ukrycia. Tryby 2 i 3: bloki używane jako fałszywki. |
replacement-blocks | stone, oak_planks, deepslate | Tylko tryby 2 i 3: bloki zastępowane fałszywkami, ale nieużywane jako fałszywki. |
Domyślna lista hidden-blocks wykracza poza rudy: obok każdej rudy, jej wersji z łupka oraz bloków surowej miedzi i surowego żelaza zawiera chest, ender_chest, obsidian, mossy_cobblestone i clay.
Blok jest ukrywany tylko wtedy, gdy jest osłonięty ze wszystkich stron. Pełne bloki, takie jak kamień, liczą się jako osłona. Powietrze, woda i szkło nie, podobnie jak spawnery, bariery, shulkery, bloki szlamu i korzenie namorzynu.
Promień aktualizacji utrzymuje normalne kopanie
Gdy gracz zaczyna niszczyć blok albo pełny blok staje się przezroczysty, Paper wysyła prawdziwą wersję ukrytych bloków wokół niego: sześć stykających się bloków przy promieniu 1, do 24 pozycji przy promieniu 2. Przy 0 nic nie jest wysyłane, co Paper traktuje jako ustawienie testowe.
Prawdziwy świat dla ekipy
Operatorzy mają paper.antixray.bypass, chyba że coś im je odbierze, więc przy use-permission: true każdy operator kopie bez fałszywek. Plugin uprawnień, taki jak LuckPerms z „Katalogu pluginów” w zakładce „Pluginy”, nadaje je moderatorowi albo odbiera operatorowi:
Konsola
lp user Kai permission set paper.antixray.bypass true
lp user Mara permission set paper.antixray.bypass falseCo każdy tryb silnika pokazuje oszustowi
| Tryb | Nazwa w Paperze | Co widzi użytkownik X-raya | Koszt |
|---|---|---|---|
1 | hide ores | Kamień tam, gdzie były zakopane rudy: łupek poniżej Y 0, netherrack w Netherze, kamień Endu w Endzie | Najlżejszy, zwłaszcza dla komputerów graczy |
2 | obfuscate | Każdy ukryty i zastępowany blok zamieniony w losową fałszywkę, więc prawdziwe rudy toną wśród fałszywek | Więcej rysowania dla komputerów graczy |
3 | obfuscate layer | Ta sama powódź fałszywek, z jednym losowym blokiem na warstwę chunka | Mniej więcej połowa danych trybu 2 przy dołączaniu gracza |
Tryb 1 ukrywa tylko rudy otoczone pełnymi blokami z każdej strony. Rudy w ścianie jaskini albo na dnie jeziora zostają, jakie są, więc oszust wciąż widzi wszystko, co graniczy z otwartą przestrzenią.
W trybach 2 i 3 fałszywki zasłaniają widok na prawdziwe rudy. Dodaj air do hidden-blocks, a wśród fałszywek pojawią się dziury, co działa też na wykrywacze jaskiń, ale Paper ostrzega, że może to obniżyć liczbę klatek u graczy. Bloki przechowujące przedmioty można ukryć, ale nigdy nie użyć jako fałszywek, więc chest idzie do replacement-blocks, gdzie ukrywa też zakopane skarby, gdy max-block-height sięga tak wysoko.

Ustawienia dla overworldu i Netheru
Ten zestaw używa trybu 3. Zastąp nim cały blok anti-xray w config/paper-world-defaults.yml:
config/paper-world-defaults.yml
anticheat:
anti-xray:
enabled: true
engine-mode: 3
hidden-blocks: [copper_ore, deepslate_copper_ore, raw_copper_block,
diamond_ore, deepslate_diamond_ore, gold_ore, deepslate_gold_ore,
iron_ore, deepslate_iron_ore, raw_iron_block, lapis_ore,
deepslate_lapis_ore, redstone_ore, deepslate_redstone_ore]
lava-obscures: false
max-block-height: 64
replacement-blocks: [chest, amethyst_block, andesite, budding_amethyst,
calcite, coal_ore, deepslate_coal_ore, deepslate, diorite, dirt,
emerald_ore, deepslate_emerald_ore, granite, gravel, oak_planks,
smooth_basalt, stone, tuff]
update-radius: 2
use-permission: falseRudy węgla i szmaragdów są w replacement-blocks: znikają z widoku X-raya, ale nigdy nie pojawiają się jako fałszywki. Na wykrywacze jaskiń dodaj air jako pierwszy wpis hidden-blocks. Paper zauważa, że od 1.18 niektóre rudy generują się dużo wyżej niż 64, więc jeśli chcesz je też ukryć, podnoś max-block-height krokami po 16; każdy krok dokłada pracy na chunk.
Nether potrzebuje własnej listy. To trafia do paper-world.yml Netheru:
world/dimensions/minecraft/the_nether/paper-world.yml
anticheat:
anti-xray:
enabled: true
engine-mode: 3
hidden-blocks: [ancient_debris, bone_block, glowstone, magma_block,
nether_bricks, nether_gold_ore, nether_quartz_ore,
polished_blackstone_bricks]
lava-obscures: false
max-block-height: 128
replacement-blocks: [basalt, blackstone, gravel, netherrack, soul_sand,
soul_soil]
update-radius: 2
use-permission: falsePrzy 128 Nether jest objęty aż do sklepienia ze skały macierzystej, a cegły i bloki kości sprawiają, że fortece, bastiony i skamieliny się nie wyróżniają. Dla Endu Paper radzi zostawić anti-xray wyłączony:
world/dimensions/minecraft/the_end/paper-world.yml
anticheat:
anti-xray:
enabled: falseWolisz tryb 1? Ustaw engine-mode: 1, przenieś rudy węgla i szmaragdów do hidden-blocks razem z chest i ustaw replacement-blocks: [], bo tryb 1 ignoruje tę listę. W Netherze tryb 1 potrzebuje tylko ancient_debris, nether_gold_ore i nether_quartz_ore.
Ile to kosztuje serwer i graczy
Anti-xray pracuje na chunkach wysyłanych do graczy, plus kilka aktualizacji bloków, gdy ktoś kopie, więc najwięcej pracy robią gracze, którzy wędrują i wczytują nowe chunki.
- Wysokość. Przerabiana jest tylko część chunka poniżej
max-block-height. - Tryb. Tryb 1 jest najlżejszy. Tryby 2 i 3 wypełniają chunki fałszywkami, które komputer każdego gracza musi narysować, a
airna liście Paper łączy ze spadkami klatek. - Dołączanie. Tryb 3 wysyła przy dołączaniu gracza mniej więcej połowę danych trybu 2.
- Wymiary. Wyłączony End całkowicie oszczędza tam pracę.
Mierz zamiast zgadywać: nagraj profil spark w zajęty wieczór przed zmianą i po niej, jak wyjaśnia poradnik o spark. Jeśli wysyłanie chunków okaże się ciężkie, mniejszy dystans widzenia zmniejsza liczbę chunków, które dostaje każdy gracz.
Sprawdź to na własne oczy
Sprawdź, czy wartości dotarły
Po restarcie nagraj krótki profil spark i otwórz jego link. Przeglądarka raportu pokazuje konfigurację, z którą działa serwer, więc możesz potwierdzić, że
enabled: truezostało wczytane.Spójrz przez kamień
Dopóki
use-permissionma wartośćfalse, operatorzy też dostają fałszywki, więc Twoje własne konto to uczciwy test. Wczytaj paczkę zasobów, która robi kamień przezroczystym, i zejdź pod ziemię poniżej Y 64.Porównaj ze swoim trybem
Tryb 1 powinien pokazać kamień, z rudami tylko wzdłuż jaskiń. Tryby 2 i 3 powinny pokazać gęsty rozprysk rud, których w większości tam nie ma.
Kop w stronę prawdziwej rudy
Zacznij niszczyć blok obok rudy, o której wiesz, że jest prawdziwa. Ruda pojawia się, gdy tylko zaczniesz, bo działa promień aktualizacji.
Restart wyrzuca wszystkich
Literówka może zablokować start serwera, a każda zmiana wymaga restartu. Zmieniaj jedno ustawienie naraz, trzymaj kopię starego pliku i restartuj w spokojnej porze.
Czego anti-xray nie zatrzyma
- Rud wystawionych na powietrze albo wodę. Ściany jaskiń i dna jezior zostają widoczne; tryby 2 i 3 tylko otaczają je fałszywkami.
- Skrzyń w lochach. Stoją w otwartym powietrzu i nie mają się za czym schować.
- Niczego powyżej `max-block-height`.
- Rozszerzania zasięgu. Zmodyfikowany klient wciąż może zobaczyć prawdziwe rudy nieco dalej, niż powinien. Paper wskazuje na to osobny plugin anti-cheat.
- Odtwarzania seeda. Klient, który wyliczy seed świata, wie, gdzie wygenerowała się każda ruda.
generate-random-seeds-for-all: truepodfeature-seedsto utrudnia, podobnie jak inny seed dla każdego świata, ale żadne z nich nie przesuwa rud w terenie, który już istnieje. - Ekipy z obejściem. Przy
use-permission: truekażdy operator widzi prawdziwe bloki.
Jeśli poniżej Y 0 zdaje się nic nie działać, plik jest prawdopodobnie nieaktualny: lista sprzed 1.18 nie ma deepslate ani rud w łupku. Dla nowego świata poradnik o seedzie opisuje wybór własnego seeda.
Purpur, vanilla, Fabric i NeoForge
Purpur uruchamia anti-xray Papera bez zmian. Serwer vanilla go nie ma i nie wczytuje pluginów ani modów; przełącz go na Paper albo Purpur w zakładce „Ustawienia”, jak opisuje Paper, Purpur czy Spigot, a świat przejdzie razem z nim.
Na Fabric i NeoForge mod AntiXray daje te same trzy tryby silnika, z buildami dla 26.2. Działa tylko na serwerze, więc gracze niczego nie instalują. Znajdziesz go przez „Szukaj modów” w zakładce „Mody”; naciśnij „Sprawdź i zainstaluj” i zrestartuj. Na Fabric jego ustawienia są w config/antixray.toml, po jednej sekcji na wymiar, na przykład [the_nether], z kluczami takimi jak engineMode i maxBlockHeight. Jego listy bloków przyjmują tagi, więc #c:ores obejmuje rudy z innych modów, które mają ten tag.
Napisane i sprawdzone przez zespół Lodehost, ostatnia weryfikacja 14 września 2026.




