Konfiguration Anti-Xray Paper: vollständiger Leitfaden für Minecraft-Server

Die Konfiguration des Anti-Xray von Paper schützt einen Minecraft-Server vor Spielern, die durch Blöcke sehen, um Erze zu finden. Diese Anleitung erklärt die Funktionsweise, die drei Modi, jede Einstellung, fertige Konfigurationen nach Servertyp und Dimension, die Auswirkungen auf die Leistung und die Fehlerbehebung. Sie folgt Paper 26.3.

---

Einführung in Anti-Xray

Was ist X-Ray?

X-Ray ist ein Cheat, mit dem man durch Blöcke sieht, um Erze, Höhlen und versteckte Basen zu finden. Er läuft über einen veränderten Client, ein Ressourcenpaket oder einen Mod.

Die Lösung von Paper

Paper bringt ein serverseitiges Anti-Xray mit. Es braucht kein Plugin und hält den meisten X-Ray-Techniken stand. Es funktioniert auch auf Purpur, das auf Paper aufbaut. Auf Spigot oder Vanilla wechseln Sie zuerst zu Paper: Die Anleitung Minecraft Server optimieren zeigt die Installation in OuiPanel.

Vorteile der integrierten Lösung

Aspekt	Beschreibung
Leistung	Im Servercode optimiert
Kompatibilität	Funktioniert mit jedem Vanilla-Client
Wartung	Wird mit Paper aktualisiert
Zuverlässigkeit	Keine externe Abhängigkeit
Konfiguration	Pro Welt und Dimension einstellbar

---

Technische Funktionsweise

Grundprinzip

Das Anti-Xray verändert die an Spieler gesendeten Chunks. Statt der echten Blöcke schickt der Server Attrappen, bis der Spieler nah genug ist, um sie normal aufzudecken.

Aufdecken der Blöcke

Ein verborgener Block wird aufgedeckt, sobald:

• der Spieler einen Nachbarblock abbaut oder setzt;

• ein Kolben einen Nachbarblock verschiebt;

• eine Explosion einen Nachbarblock zerstört;

• Wasser oder Lava auf einen Nachbarblock fließt.

Nachbarblöcke

Das System prüft die 6 Seiten eines Blocks. Ein Block gilt als „freiliegend“, wenn mindestens eine Seite einen durchsichtigen Block berührt: Luft, Glas, Wasser. Freiliegende Blöcke werden in Modus 1 nicht verborgen.

---

Funktionsmodi

Paper bietet drei Modi mit jeweils eigenen Stärken und Grenzen.

Engine Mode 1, einfaches Ersetzen

Dieser Modus ersetzt verborgene Blöcke, wenn sie nicht freiliegen, durch den Grundblock der Dimension: Stein (Tiefenschiefer unter Y 0), Netherrack oder Endstein.

Verborgener Block      → stone (oder deepslate, netherrack, end_stone)
Freiliegender Block    → unverändert

• Geringe Last für Server und vor allem Clients, mit wenig Speicher und Bandbreite.

• Allerdings sieht ein X-Ray, das Stein ausblendet, weiterhin Erze an Höhlen oder Wasser.

• Empfohlen für Server mit wenig Ressourcen, sehr volle Server, Kreativ- oder Semi-RP-Server.

Engine Mode 2, zufällige Verschleierung

Dieser Modus ersetzt sowohl verborgene als auch Ersatzblöcke durch zufällig aus hidden-blocks gezogene Blöcke. X-Ray zeigt dann überall falsche Erze, die sich nicht von echten unterscheiden lassen.

Verborgener oder Ersatzblock → zufälliger Block (diamond_ore, gold_ore, iron_ore…)
Freiliegender Block          → unverändert

• Starker Schutz: Echte und falsche Erze sehen gleich aus, X-Ray wird nutzlos.

• Im Gegenzug mehr Rechenaufwand, Speicher und Bandbreite.

• Empfohlen für kompetitives Survival, PvP, Factions und Server mit wichtiger Ressourcenwirtschaft.

Engine Mode 3, Verschleierung pro Schicht

Wie Modus 2, aber der Zufallsblock wird einmal pro Chunk-Schicht statt pro Block gezogen. Laut der Paper-Dokumentation halbiert sich die Netzwerklast beim Beitritt ungefähr, weil sich die Chunks besser komprimieren lassen.

Vergleich

Kriterium	Modus 1	Modus 2	Modus 3
Schutz	Einfach	Stark	Stark
CPU	Gering	Mittel	Mittel
Netzwerk	Gering	Mittel	Geringer als Modus 2
Empfohlen für	Entspannte Server	Kompetitive Server	Volle kompetitive Server

---

Vollständige Konfiguration

Speicherort der Datei

config/paper-world-defaults.yml      # Standardkonfiguration aller Welten
<welt>/paper-world.yml               # Konfiguration einer einzelnen Welt

Die Datei in OuiPanel bearbeiten

1. Klicken Sie in der Konsole auf Stoppen.

2. Öffnen Sie den Dateimanager, dann den Ordner config, und klicken Sie auf paper-world-defaults.yml. Das Fenster „Bearbeite paper-world-defaults.yml“ öffnet sich.

3. Ersetzen Sie den Abschnitt anticheat durch die gewünschte Konfiguration und klicken Sie auf Speichern.

4. Starten Sie den Server über die Konsole. Änderungen greifen erst nach einem Neustart: Nutzen Sie nicht /reload.

YAML lehnt Tabulatoren ab und zählt Leerzeichen. Kopieren Sie die Blöcke dieser Anleitung genau so, mit ihrer Einrückung.

Aufbau der Konfiguration

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 64
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - copper_ore
      - deepslate_copper_ore
      - raw_copper_block
      - gold_ore
      - deepslate_gold_ore
      - raw_gold_block
      - iron_ore
      - deepslate_iron_ore
      - raw_iron_block
      - coal_ore
      - deepslate_coal_ore
      - lapis_ore
      - deepslate_lapis_ore
      - mossy_cobblestone
      - obsidian
      - diamond_ore
      - deepslate_diamond_ore
      - redstone_ore
      - deepslate_redstone_ore
      - clay
      - emerald_ore
      - deepslate_emerald_ore
    replacement-blocks:
      - chest
      - amethyst_block
      - andesite
      - budding_amethyst
      - calcite
      - coal_ore
      - deepslate_coal_ore
      - deepslate
      - deepslate_copper_ore
      - deepslate_diamond_ore
      - deepslate_emerald_ore
      - deepslate_gold_ore
      - deepslate_iron_ore
      - deepslate_lapis_ore
      - deepslate_redstone_ore
      - diorite
      - dirt
      - emerald_ore
      - granite
      - gravel
      - iron_ore
      - oak_planks
      - smooth_basalt
      - stone
      - tuff

Blockentitäten (Truhen, Endertruhen, Fässer, Shulkerkisten, Spawner, Trichter, Werfer) lassen sich nicht verbergen: Paper ignoriert sie in hidden-blocks. In replacement-blocks sind sie erlaubt: chest verbirgt dort vergrabene Schätze, wenn max-block-height angehoben wird.

Einstellungen im Detail

Parameter	Standard	Zweck
enabled	false	Schaltet das Anti-Xray ein oder aus
engine-mode	1	Modus 1, 2 oder 3
max-block-height	64	Höchste Ebene, in der das Anti-Xray wirkt, in Vielfachen von 16 (andere Werte werden abgerundet)
update-radius	2	Radius der aufgedeckten Blöcke bei einer Spieleraktion: 1 oder 2 (0 nur für Tests)
lava-obscures	false	Verbirgt auch Blöcke, die Lava berühren
use-permission	false	Spieler mit paper.antixray.bypass sehen die echten Blöcke
hidden-blocks	Liste von Erzen	Zu verbergende Blöcke
replacement-blocks	stone, oak_planks, deepslate	In Modus 2 und 3 verschleierte Blöcke, in Modus 1 ignoriert

max-block-height

max-block-height: 64

Oberhalb dieses Werts wird nichts verborgen. Ein kleinerer Wert entlastet den Server. Empfohlen: 64 für die Oberwelt, 128 für den Nether, End deaktiviert. Seit 1.18 entstehen manche Erze weiter oben: Passen Sie den Wert an Ihre Welt an.

update-radius

update-radius: 2

Wird ein Block aufgedeckt, erhalten die Blöcke in diesem Radius ihre echten Daten. 1 ist am leichtesten, kann aber Blöcke verdeckt lassen, 2 ist der empfohlene Kompromiss. Paper akzeptiert nur 0, 1 und 2: Höhere Werte werden auf 2 gesenkt.

lava-obscures

lava-obscures: false

Bei true werden auch Blöcke an Lava verborgen. Nützlich im Nether, sieht aber bei Erzen mit nicht steinähnlicher Textur schlecht aus.

use-permission

use-permission: false

Bei true sehen Spieler mit der Berechtigung paper.antixray.bypass die echten Blöcke, nützlich für Admins beim Debuggen. Die Prüfung ist standardmäßig aus, da ältere Berechtigungs-Plugins mit der Zahl der Prüfungen Mühe haben.

hidden-blocks

hidden-blocks:
  - diamond_ore
  - emerald_ore
  # ...

Die Liste der zu verbergenden Blöcke. In Modus 1 werden sie durch den Stein der Dimension ersetzt, in Modus 2 und 3 durch einen zufällig aus dieser Liste gezogenen Block. Ein mehrfach eingetragener Block kommt häufiger vor. Mit air entstehen falsche Löcher, die Höhlenfinder täuschen, bei manchen Spielern aber die FPS senken.

replacement-blocks

replacement-blocks:
  - stone
  - deepslate
  - granite
  # ...

Blöcke, die in Modus 2 und 3 ebenfalls verschleiert werden. In Modus 1 wird diese Liste nicht genutzt.

---

Optimierung nach Servertyp

Vanilla-Survival-Server

Eine ausgewogene Konfiguration für klassisches Survival.

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 64
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - coal_ore
      - deepslate_coal_ore
      - copper_ore
      - deepslate_copper_ore
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - iron_ore
      - deepslate_iron_ore
      - lapis_ore
      - deepslate_lapis_ore
      - redstone_ore
      - deepslate_redstone_ore
    replacement-blocks:
      - chest
      - coal_ore
      - deepslate_coal_ore
      - copper_ore
      - deepslate_copper_ore
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - iron_ore
      - deepslate_iron_ore
      - lapis_ore
      - deepslate_lapis_ore
      - redstone_ore
      - deepslate_redstone_ore
      - amethyst_block
      - andesite
      - budding_amethyst
      - calcite
      - deepslate
      - diorite
      - dirt
      - granite
      - gravel
      - smooth_basalt
      - stone
      - tuff

Faction- und PvP-Server

Der stärkste Schutz für kompetitive Server. Erze werden über die ganze Höhe der Welt verborgen, ebenso TNT. Behälter lassen sich nicht verbergen.

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 320
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - ancient_debris
      - coal_ore
      - deepslate_coal_ore
      - copper_ore
      - deepslate_copper_ore
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - iron_ore
      - deepslate_iron_ore
      - lapis_ore
      - deepslate_lapis_ore
      - redstone_ore
      - deepslate_redstone_ore
      - nether_gold_ore
      - nether_quartz_ore
      - tnt
    replacement-blocks:
      - chest
      - coal_ore
      - deepslate_coal_ore
      - copper_ore
      - deepslate_copper_ore
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - iron_ore
      - deepslate_iron_ore
      - lapis_ore
      - deepslate_lapis_ore
      - redstone_ore
      - deepslate_redstone_ore
      - amethyst_block
      - andesite
      - budding_amethyst
      - calcite
      - deepslate
      - diorite
      - dirt
      - granite
      - gravel
      - oak_planks
      - smooth_basalt
      - stone
      - tuff

Wirtschaftsserver

Eine Konfiguration, die wertvolle Ressourcen schützt, um die Serverwirtschaft zu bewahren.

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 64
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - ancient_debris
    replacement-blocks:
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - coal_ore
      - deepslate_coal_ore
      - iron_ore
      - deepslate_iron_ore
      - copper_ore
      - deepslate_copper_ore
      - deepslate
      - stone
      - granite
      - diorite
      - andesite

Leistungsserver (viele Spieler)

Die leichteste Konfiguration für einen Server mit vielen Spielern. In Modus 1 wird replacement-blocks nicht genutzt.

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 1
    max-block-height: 48
    update-radius: 1
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - ancient_debris
    replacement-blocks:
      - stone

---

Konfiguration nach Dimension

Jede Dimension kann eine eigene paper-world.yml haben. Minecraft 26.1 hat die Dimensionen nach world/dimensions/minecraft/ verschoben: Nether und End liegen daher in neuen Ordnern.

Dimension	Vor 26.1	Seit 26.1
Overworld	world/paper-world.yml	config/paper-world-defaults.yml (empfohlen)
Nether	world_nether/paper-world.yml	world/dimensions/minecraft/the_nether/paper-world.yml
End	world_the_end/paper-world.yml	world/dimensions/minecraft/the_end/paper-world.yml

Overworld (world)

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 64
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - coal_ore
      - deepslate_coal_ore
      - copper_ore
      - deepslate_copper_ore
      - diamond_ore
      - deepslate_diamond_ore
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - iron_ore
      - deepslate_iron_ore
      - lapis_ore
      - deepslate_lapis_ore
      - redstone_ore
      - deepslate_redstone_ore
      - raw_copper_block
      - raw_gold_block
      - raw_iron_block
    replacement-blocks:
      - amethyst_block
      - andesite
      - budding_amethyst
      - calcite
      - chest
      - coal_ore
      - deepslate_coal_ore
      - copper_ore
      - deepslate_copper_ore
      - deepslate
      - diamond_ore
      - deepslate_diamond_ore
      - diorite
      - dirt
      - emerald_ore
      - deepslate_emerald_ore
      - gold_ore
      - deepslate_gold_ore
      - granite
      - gravel
      - iron_ore
      - deepslate_iron_ore
      - lapis_ore
      - deepslate_lapis_ore
      - oak_planks
      - redstone_ore
      - deepslate_redstone_ore
      - smooth_basalt
      - stone
      - tuff

Nether (world_nether)

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 128
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - ancient_debris
      - nether_gold_ore
      - nether_quartz_ore
      - gilded_blackstone
    replacement-blocks:
      - ancient_debris
      - basalt
      - blackstone
      - chest
      - gilded_blackstone
      - gravel
      - magma_block
      - nether_bricks
      - nether_gold_ore
      - nether_quartz_ore
      - netherrack
      - soul_sand
      - soul_soil

End (world_the_end)

Das End enthält wenige schützenswerte Ressourcen, und seine Truhen und Shulkerkisten lassen sich nicht verbergen. Die Paper-Dokumentation empfiehlt, das Anti-Xray in dieser Dimension abzuschalten.

anticheat:
  anti-xray:
    enabled: false

---

Auswirkungen auf die Leistung

Größenordnungen je Modus

Diese Werte sind Größenordnungen ohne offizielle Messung von Paper. Messen Sie auf Ihrem Server mit Spark.

Messgröße	Modus 1	Modus 2	Ohne Anti-Xray
CPU (Chunk-Generierung)	+5-10 %	+15-25 %	Referenz
RAM pro Chunk	+0,1 KB	+0,5 bis 1 KB	Referenz
Bandbreite	+2-5 %	+10-20 %	Referenz
Netzwerklatenz	Vernachlässigbar	+1-5 ms	Referenz

Was die Leistung beeinflusst

Je länger die Liste hidden-blocks, desto schwerer die Verarbeitung.

# Leicht (5 bis 10 Blöcke)
hidden-blocks:
  - diamond_ore
  - emerald_ore
  - gold_ore
  - ancient_debris
  - obsidian
# Schwer (20 Blöcke und mehr)
hidden-blocks:
  - coal_ore
  - deepslate_coal_ore
  - copper_ore
  - deepslate_copper_ore
  # ... 20 Einträge und mehr

Ein niedrigeres max-block-height senkt die Last deutlich.

# Beste Leistung
max-block-height: 48
# Ausgewogen
max-block-height: 64
# Maximaler Schutz (aufwendig)
max-block-height: 320

update-radius auf 2 prüft mehr Nachbarblöcke als 1. Das ist der empfohlene Wert; 1 dient sehr ausgelasteten Servern.

update-radius: 1
update-radius: 2

Für einen stark ausgelasteten Server

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 1          # Leichtester Modus
    max-block-height: 48    # Niedrige Grenze
    update-radius: 1        # Kleinster Radius
    hidden-blocks:          # Kurze Liste
      - diamond_ore
      - deepslate_diamond_ore
      - ancient_debris
    replacement-blocks:
      - stone

Mit Spark messen

Spark ist seit 1.21 in Paper enthalten. In der Konsole von OuiPanel geben Sie diese Befehle ohne Schrägstrich ein.

/spark profiler start
# Einige Minuten warten, während die Spieler spielen
/spark profiler stop

Suchen Sie im Bericht nach AntiXray, nach ChunkSerializer für die Generierung und nach PlayerConnection für das Netzwerk. Die Anleitung Ticks, TPS und Haupt-Thread in Minecraft hilft beim Lesen.

---

Fehlerbehebung und häufige Probleme

Echte Blöcke erscheinen kurz

Spieler sehen die echten Blöcke kurz beim Laden der Chunks.

Ursache ist oft Netzwerklatenz oder ein überlasteter Server.

Lassen Sie update-radius auf 2 und prüfen Sie die Netzwerkkompression in server.properties.

update-radius: 2
# In server.properties
network-compression-threshold=256

Blöcke bleiben nach dem Abbau verborgen

Nach dem Abbau eines Blocks bleiben die Nachbarblöcke verschleiert.

update-radius ist zu niedrig, oder ein Fehler betrifft Ihre Paper-Version.

Erhöhen Sie den Radius und aktualisieren Sie Paper über den Versionsmanager von OuiPanel (Aktualisieren).

# Aktualisierungsradius erhöhen
update-radius: 2
# Prüfen, ob Paper aktuell ist
# Neuester Build auf papermc.io

Die Leistung sinkt

Niedrige TPS und Lag beim Laden von Chunks.

Erleichtern Sie die Konfiguration und kürzen Sie die Blockliste.

# Last senken
engine-mode: 1
max-block-height: 48
update-radius: 1
# Blockliste kürzen
hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore
  - emerald_ore
  - deepslate_emerald_ore

Manche Blöcke werden nicht verborgen

Spieler mit X-Ray sehen noch manche Erze.

Der Block fehlt in hidden-blocks, liegt frei an Luft, liegt über max-block-height oder ist eine Blockentität (Truhe, Spawner), die sich nicht verbergen lässt.

Prüfen Sie, ob alle Varianten aufgeführt sind.

hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore  # Die Deepslate-Variante nicht vergessen

Konflikte mit manchen Plugins

Ein Schutz- oder Wirtschafts-Plugin funktioniert schlecht, weil es ungewöhnlich mit Blöcken umgeht. Aktualisieren Sie das Plugin oder kontaktieren Sie den Entwickler. Damit Admins beim Testen die echten Blöcke sehen, aktivieren Sie die Umgehungsberechtigung und geben Sie den Admins paper.antixray.bypass.

use-permission: true

Die Anleitung LuckPerms konfigurieren erklärt, wie Sie eine Berechtigung vergeben.

Nützliche Befehle

# Paper-Version anzeigen
/version
# Plugins und Abhängigkeiten in eine Debug-Datei schreiben
/paper dumpplugins
# Server profilen
/spark profiler start
/spark profiler stop

Das Anti-Xray lässt sich nicht im laufenden Betrieb neu laden: Starten Sie den Server nach jeder Änderung über die Konsole › Neu starten neu.

---

Best Practices

Erste Einrichtung

• Beginnen Sie mit Modus 2 oder 3 für starken Schutz.

• Passen Sie dann anhand der gemessenen Leistung an.

• Testen Sie mit vertrauenswürdigen Spielern, die X-Ray nutzen.

Empfohlene Blockliste

Kategorie	Blöcke
Unverzichtbar (alle Server)	diamond_ore, deepslate_diamond_ore, emerald_ore, deepslate_emerald_ore, ancient_debris
Empfohlen (Survival)	gold_ore, deepslate_gold_ore, iron_ore, deepslate_iron_ore, copper_ore, deepslate_copper_ore, lapis_ore, deepslate_lapis_ore, redstone_ore, deepslate_redstone_ore, coal_ore, deepslate_coal_ore
Speziell	tnt (PvP-Server), obsidian (versteckte Basen), mossy_cobblestone (Verliese)
Nicht zu verbergen	Truhen, Redstone-Truhen, Endertruhen, Fässer, Shulkerkisten, Trichter, Werfer, Spender, Spawner: Das sind Blockentitäten

Wartung

• Aktualisieren Sie Paper regelmäßig, um Korrekturen zu erhalten.

• Überwachen Sie die Leistung mit Spark.

• Testen Sie nach jedem großen Minecraft-Update, etwa dem Ordnerwechsel in 26.1.

• Halten Sie Ihre Änderungen in einem Änderungsprotokoll fest.

Zusätzliche Sicherheit

Das Anti-Xray ersetzt keine anderen Maßnahmen:

• ein Anti-Cheat-Plugin (Matrix, Vulcan, Grim);

• ein Block-Protokoll (CoreProtect, Prism);

• aktive Moderation und Meldungen der Spieler;

• regelmäßige Prüfung verdächtiger Spieler.

---

Ressourcen und Referenzen

• Paper-Dokumentation

• Anti-Xray-Seite von Paper

• Spark, der Profiler

• Timings, von Paper aufgegeben

• Discord von PaperMC

• SpigotMC-Foren

---

Brauchen Sie Hilfe?

Eröffnen Sie ein Ticket über Tickets › Ticket öffnen oder über die Kachel Support kontaktieren unten auf der Seite Ihres Servers im Kundenbereich. Sie können Ihre Frage auch auf dem Discord von OuiHeberg stellen.

Ticket eröffnenDiscord