Kundenbereich
Minecraft•21. Januar 2026• 1098 Aufrufe

Konfiguration Anti-Xray Papier : Vollständiger Leitfaden für Minecraft-Server

Konfiguration Anti-Xray Papier : Vollständiger Leitfaden für Minecraft-Server

Einführung in Anti-Xray

Was ist X-Ray?

X-Ray ist eine Betrugstechnik, die es Spielern ermöglicht, durch feste Blöcke zu sehen, um Mineralien, Höhlen, versteckte Basen und andere Strukturen leicht zu lokalisieren. Dieser Betrug kann über modifizierte Clients, Resource Packs oder Mods durchgeführt werden.

Paper-Lösung

Paper integriert nativ ein leistungsfähiges Anti-Xray-System, das serverseitig funktioniert. Im Gegensatz zu traditionellen Plugins erfordert diese Lösung keine zusätzliche Installation und bietet einen robusten Schutz gegen die meisten X-Ray-Techniken.

Vorteile der nativen Lösung

Aspekt Beschreibung
Leistung Optimiert auf Servercode-Ebene
Kompatibilität Funktioniert mit allen Vanilla-Clients
Wartung Automatisch mit Paper aktualisiert
Zuverlässigkeit Keine externen Abhängigkeiten
Konfiguration Pro Welt/Dimension anpassbar

Technische Funktionsweise

Grundprinzip

Das Anti-Xray von Paper funktioniert, indem es die Chunk-Daten, die an die Clients gesendet werden, modifiziert. Anstatt die tatsächlichen Blöcke zu senden, ersetzt der Server bestimmte Blöcke durch Lockblöcke, bis der Spieler sich ihnen ausreichend nähert, um sie legitim zu enthüllen.

Enthüllungsprozess

Ein versteckter Block wird enthüllt, wenn eine der folgenden Bedingungen erfüllt ist:

  • Der Spieler bricht einen benachbarten Block
  • Der Spieler platziert einen benachbarten Block
  • Ein Kolben bewegt einen benachbarten Block
  • Eine Explosion zerstört einen benachbarten Block
  • Wasser oder Lava fließt über einen benachbarten Block
  • Der Block tritt in das direkte Sichtfeld ein (Raytracing aktiviert)

Benachbarte Blöcke

Das System berücksichtigt die 6 Seiten eines Blocks (oben, unten, nord, süd, ost, west). Ein Block wird als "Luft-exponiert" betrachtet, wenn mindestens eine seiner Seiten einen transparenten Block berührt (Luft, Glas, Wasser usw.).

Funktionsmodi

Paper bietet zwei verschiedene Modi, jeder mit seinen Vor- und Nachteilen.

Engine-Modus 1: Einfache Ersetzung

Dieser Modus ersetzt alle versteckten Blöcke (nicht luft-exponiert) durch einen einzigartigen Ersatzblock, normalerweise Stein.

Funktionsweise:

Versteckter Originalblock → Stein (oder definierter Block)
Luft-exponierter Block → Unverändert

Vorteile:

  • Geringe Auswirkungen auf die Leistung
  • Minimale Speichernutzung
  • Reduzierte Netzwerkbandbreite

Nachteile:

  • Vulnerabel gegenüber fortgeschrittenem X-Ray, das Stein filtert
  • Erfahrene Spieler können die Standorte erraten

Empfohlene Anwendungsfälle:

  • Server mit begrenzten Ressourcen
  • Große Spielerpopulation
  • Kreative oder semi-RP-Server

Engine-Modus 2: Zufällige Obfuskation

Dieser Modus ersetzt versteckte Blöcke durch zufällige Blöcke, die aus einer konfigurierbaren Liste ausgewählt werden, und erzeugt ein "visuelles Rauschen", das X-Ray nutzlos macht.

Funktionsweise:

Versteckter Originalblock → Zufälliger Block (diamond_ore, gold_ore, iron_ore usw.)
Luft-exponierter Block → Unverändert

Vorteile:

  • Maximaler Schutz gegen alle Arten von X-Ray
  • Unmöglich, echte Mineralien von falschen zu unterscheiden
  • Völlig abschreckend für die Nutzung von X-Ray

Nachteile:

  • Höhere Auswirkungen auf die Leistung
  • Erhöhte Speichernutzung
  • Erhöhte Netzwerkbandbreite

Empfohlene Anwendungsfälle:

  • Wettbewerbsfähige Überlebensserver
  • PvP/Faction-Server
  • Server, auf denen die Ressourcennutzung wichtig ist

Visueller Vergleich

Kriterium Modus 1 Modus 2
Schutz Basis Maximal
CPU Niedrig Moderat
RAM Niedrig Moderat
Netzwerk Niedrig Moderat
Empfohlen Casual Wettbewerbsfähig

Vollständige Konfiguration

Standort der Datei

Die Konfigurationsdatei befindet sich unter:

config/paper-world-defaults.yml      # Standardkonfiguration
<world>/paper-world.yml              # Weltspezifische Konfiguration

Konfigurationsstruktur

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
      - chest
      - diamond_ore
      - deepslate_diamond_ore
      - redstone_ore
      - deepslate_redstone_ore
      - clay
      - emerald_ore
      - deepslate_emerald_ore
      - ender_chest
    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

Detaillierte Parameter

enabled

enabled: true

Aktiviert oder deaktiviert das Anti-Xray. Auf false setzen, um es vollständig zu deaktivieren.

engine-mode

engine-mode: 2

Legt den Betriebsmodus fest (1 oder 2). Siehe vorherigen Abschnitt für Details.

max-block-height

max-block-height: 64

Maximale Höhe (Y-Koordinate), auf die das Anti-Xray angewendet wird. Über diesem Wert erfolgt keine Obfuskation. Diese Zahl zu reduzieren verbessert die Leistung.

Empfohlene Werte:

  • Overworld: 64 (Meeresspiegel)
  • Nether: 128 (maximale Höhe)
  • End: 0 (deaktiviert, wenige Mineralien)

update-radius

update-radius: 2

Aktualisierungsradius der Blöcke, wenn ein Block enthüllt wird. Ein Wert von 2 bedeutet, dass Blöcke in einem Radius von 2 Blöcken aktualisiert werden.

Werte:

  • 1: Maximale Leistung, Risiko von nicht enthüllten Blöcken
  • 2: Empfohlene Balance
  • 3+: Maximale Sicherheit, Leistungsimpact

lava-obscures

lava-obscures: false

Wenn aktiviert, wird Lava als undurchsichtiger Block für die Obfuskation betrachtet. Nützlich für den Nether, kann jedoch visuelle Probleme verursachen.

use-permission

use-permission: false

Wenn aktiviert, werden Spieler mit der Berechtigung paper.antixray.bypass nicht vom Anti-Xray betroffen. Nützlich für Administratoren beim Debuggen.

hidden-blocks

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

Liste der Blöcke, die versteckt/obfuskiert werden sollen. Diese Blöcke werden ersetzt, wenn sie nicht luft-exponiert sind.

Modus 1: Diese Blöcke werden durch Stein (oder den ersten Block aus replacement-blocks) ersetzt.

Modus 2: Diese Blöcke werden durch einen zufälligen Block aus der Liste replacement-blocks ersetzt.

replacement-blocks

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

Liste der Blöcke, die als Ersatz verwendet werden.

Modus 1: Nur der erste Block der Liste wird verwendet.

Modus 2: Die Blöcke werden zufällig aus dieser Liste ausgewählt.

Optimierung nach Servertyp

Vanilla Survival Server

Ausgewogene Konfiguration für ein klassisches Überlebenserlebnis.

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 64
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-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
    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/PvP Server

Maximale Konfiguration für wettbewerbsfähige Umgebungen, in denen Betrug strikt verhindert werden muss.

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
      - 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
      - nether_gold_ore
      - nether_quartz_ore
      - redstone_ore
      - deepslate_redstone_ore
      - trapped_chest
      - ender_chest
      - shulker_box
      - white_shulker_box
      - orange_shulker_box
      - magenta_shulker_box
      - light_blue_shulker_box
      - yellow_shulker_box
      - lime_shulker_box
      - pink_shulker_box
      - gray_shulker_box
      - light_gray_shulker_box
      - cyan_shulker_box
      - purple_shulker_box
      - blue_shulker_box
      - brown_shulker_box
      - green_shulker_box
      - red_shulker_box
      - black_shulker_box
      - barrel
      - dispenser
      - dropper
      - hopper
      - spawner
      - 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

Konfiguration, die auf wertvolle Ressourcen abzielt, um die Wirtschaft des Servers zu schützen.

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
      - chest
      - ender_chest
      - spawner
    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

Performance-Server (Große Bevölkerung)

Minimale Konfiguration für Server mit vielen Spielern, bei denen die Leistung kritisch ist.

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

Overworld (world)

Datei: world/paper-world.yml

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 2
    max-block-height: 64
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-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
      - 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)

Datei: world_nether/paper-world.yml

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
      - chest
      - 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)

Datei: world_the_end/paper-world.yml

Das Ende enthält nur wenige Ressourcen, die geschützt werden müssen. Eine minimale oder deaktivierte Konfiguration ist in der Regel ausreichend.

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 1
    max-block-height: 0
    update-radius: 2
    lava-obscures: false
    use-permission: false
    hidden-blocks:
      - chest
      - ender_chest
      - shulker_box
    replacement-blocks:
      - end_stone

Oder einfach deaktiviert:

anticheat:
  anti-xray:
    enabled: false

Auswirkungen auf die Leistung

Metriken nach Modus

Metrik Modus 1 Modus 2 Ohne Anti-Xray
CPU (Chunk-Generierung) +5-10% +15-25% Basislinie
RAM pro Chunk +0.1 KB +0.5-1 KB Basislinie
Bandbreite +2-5% +10-20% Basislinie
Netzwerklatenz Vernachlässigbar +1-5 ms Basislinie

Faktoren, die die Leistung beeinflussen

Anzahl der hidden-blocks

Je länger die Liste, desto schwerer die Verarbeitung.

# Leicht (5-10 Blöcke)
hidden-blocks:
  - diamond_ore
  - emerald_ore
  - gold_ore
  - ancient_debris
  - chest

# Schwer (20+ Blöcke)
hidden-blocks:
  - coal_ore
  - deepslate_coal_ore
  - copper_ore
  - deepslate_copper_ore
  # ... 20+ Einträge

max-block-height

Diese Zahl zu reduzieren, verringert die Last erheblich.

# Optimale Leistung
max-block-height: 48

# Ausgewogen
max-block-height: 64

# Maximaler Schutz (kostspielig)
max-block-height: 320

update-radius

Jede Erhöhung vervielfacht die Anzahl der zu überprüfenden Blöcke.

# Radius 1: 6 Blöcke überprüft
update-radius: 1

# Radius 2: 26 Blöcke überprüft
update-radius: 2

# Radius 3: 98 Blöcke überprüft
update-radius: 3

Leistungsoptimierung

Für Server mit hoher Last

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

Leistungsüberwachung

Verwenden Sie Spark, um die Auswirkungen zu analysieren:

/spark profiler start
# Warten Sie einige Minuten, während die Spieler spielen
/spark profiler stop

Überprüfen Sie den Bericht:

  • AntiXray in den Threads
  • ChunkSerializer für die Auswirkungen auf die Generierung
  • PlayerConnection für die Netzwerkbelastung

Fehlerbehebung und häufige Probleme

Problem: Blöcke kurz vor der Obfuskation sichtbar

Symptom: Spieler sehen die echten Blöcke für einen Bruchteil einer Sekunde beim Laden der Chunks.

Ursache: Netzwerkverzögerung oder hohe Serverlast.

Lösungen:

# Erhöhen Sie die Priorität des Anti-Xray
update-radius: 2

# Überprüfen Sie die Netzwerkkonfiguration
# In server.properties
network-compression-threshold=256

Problem: Blöcke bleiben nach dem Abbau versteckt

Symptom: Nach dem Abbau eines Blocks bleiben die benachbarten Blöcke obfuskiert.

Ursache: update-radius zu niedrig oder Versionsfehler.

Lösungen:

# Aktualisieren des Aktualisierungsradius
update-radius: 2

# Überprüfen, ob Paper aktuell ist
# Die neueste Version von papermc.io herunterladen

Problem: Verschlechterte Leistung

Symptom: Niedriger TPS, Lag beim Laden von Chunks.

Lösungen:

# Last reduzieren
engine-mode: 1
max-block-height: 48
update-radius: 1

# Blockliste reduzieren
hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore
  - emerald_ore
  - deepslate_emerald_ore

Problem: Einige Blöcke sind nicht versteckt

Symptom: X-Ray-Spieler sehen bestimmte Erze.

Ursache: Block nicht in hidden-blocks enthalten oder der Luft ausgesetzt.

Lösungen:

# Überprüfen, ob alle Varianten enthalten sind
hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore  # Vergessen Sie nicht die deepslate-Version

Problem: Inkompatibilität mit bestimmten Plugins

Symptom: Schutz- oder Wirtschaftsplug-ins funktionieren nicht richtig.

Ursache: Einige Plugins interagieren nicht standardmäßig mit den Blöcken.

Lösungen:

  • Aktualisieren Sie das betroffene Plugin
  • Kontaktieren Sie den Entwickler des Plugins
  • Fügen Sie die Admins zur Ausnahme hinzu:
use-permission: true

Geben Sie dann den Admins die Berechtigung paper.antixray.bypass.

Debug-Befehle

# Konfiguration neu laden (nach Änderungen)
/paper reload

# Aktive Konfiguration überprüfen
/paper dumpplugins  # Indirekt überprüfen, ob Paper funktioniert

# Server profilieren
/spark profiler start
/spark profiler stop

Best Practices

Erstkonfiguration

  1. Beginnen Sie im Modus 2 für maximalen Schutz
  2. Anpassen basierend auf den beobachteten Leistungen
  3. Testen Sie mit vertrauenswürdigen X-Ray-Spielern

Empfohlene Blockliste

Unverzichtbar (alle Server)

  • diamond_ore / deepslate_diamond_ore
  • emerald_ore / deepslate_emerald_ore
  • ancient_debris

Empfohlen (Überleben)

  • 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

Container (PvP/Faktion)

  • chest / trapped_chest
  • ender_chest
  • barrel
  • shulker_box (alle Farben)
  • hopper
  • dispenser / dropper

Spezielle

  • spawner (wenn wichtig auf Ihrem Server)
  • tnt (PvP-Server)
  • obsidian (versteckte Basen)

Wartung

  • Aktualisieren Sie Paper regelmäßig für Patches
  • Überwachen Sie die Leistung mit Spark oder Timings
  • Testen Sie nach jedem größeren Update von Minecraft
  • Dokumentieren Sie Ihre Änderungen in einer Changelog-Datei

Zusätzliche Sicherheit

Anti-Xray ersetzt keine anderen Maßnahmen:

  • Anti-Cheat-Plugin (Matrix, Vulcan, Grim)
  • Blockprotokolle (CoreProtect, Prism)
  • Aktive Moderation und Spielerberichte
  • Regelmäßige Überprüfung verdächtiger Spieler

Ressourcen und Referenzen

Offizielle Dokumentation

Nützliche Werkzeuge

Gemeinschaft

Brauchen Sie einen Minecraft-Server?

Entdecken Sie unsere Minecraft-Hosting-Angebote ab 9,98€/Monat mit automatischer Mod-Installation.

Angebote ansehen
Zurück zur Dokumentation