Présentation
Bonjour ! Dans ce guide nous allons voir comment bloquer les clients qui utilisent du X-ray sur vos serveurs. Nous allons pour cela utiliser la version Paper de Minecraft.
Paper inclut un système d’anti-Xray basé sur l’obfuscation, configurable par monde et proposant trois modes :
engine-mode: 1
- Remplace les blocs listés dans
hidden-blocks
par des blocs “factice” (stone
– ou deepslate
pour Y < 0, netherrack
en Nether, end_stone
en End). engine-mode: 2
- Remplace à la fois les
hidden-blocks
et les replacement-blocks
par des blocs tirés au hasard dans la liste hidden-blocks
. engine-mode: 3
- Semblable au mode 2, mais la randomisation s’applique par couche de chunk plutôt que bloc par bloc.

Pour modifier votre configuration de Paper, vous pouvez ouvrir le fichier paper-world-defaults.yml
depuis votre WebFTP depuis votre panel, ou par SFTP en suivant ce tutoriel : https://minestrator.com/blog/article/gestion-serveur-winscp-filezilla
Bypasses courants
- Extension de portée : un simple client “range extender” peut augmenter la distance de vision des minerais réels. Pour une protection plus robuste, combinez avec un plugin anti-cheat dédié.
- Récupération de seed : si le client découvre la seed du monde, il peut localiser tous les minerais. Pour limiter ce risque, activez la fonction
feature-seeds
et envisagez d’utiliser une seed différente par monde. - Minerais exposés à l’air : en mode 1, les minerais à l’air libre restent visibles. En modes 2 et 3, l’ajout de
air
aux hidden-blocks
peut masquer même les minerais exposés, au prix d’une possible baisse de FPS.
Configuration recommandée
Voici la configuration que vous pouvez juste copier/coller pour que le x-ray soit optimal. Vous pouvez aussi garder les valeurs par défaut.
Important : YAML est sensible aux espaces ! Copiez-collez attentivement les blocs ci-dessous sans modifier l’indentation.
Faites une sauvegarde de vos fichiers avant modification.
engine-mode: 1
Monde par défaut (paper-world-defaults.yml
)
anticheat:
anti-xray:
enabled: true
engine-mode: 1
hidden-blocks:
# Les coffres de donjon sont entourés d’air, ils ne seront donc pas cachés.
- chest
- coal_ore
- deepslate_coal_ore
- copper_ore
- deepslate_copper_ore
- raw_copper_block
- diamond_ore
- deepslate_diamond_ore
- emerald_ore
- deepslate_emerald_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
# Ajustez selon la hauteur maximale de génération des minerais
max-block-height: 64
replacement-blocks: []
update-radius: 2
use-permission: false
Nether (world_nether/paper-world.yml
)
anticheat:
anti-xray:
enabled: true
engine-mode: 1
hidden-blocks:
- ancient_debris
- nether_gold_ore
- nether_quartz_ore
lava-obscures: false
max-block-height: 128
replacement-blocks: []
update-radius: 2
use-permission: false
End (world_the_end/paper-world.yml
)
anticheat:
anti-xray:
enabled: false
engine-mode: 2
Monde par défaut (paper-world-defaults.yml
)
anticheat:
anti-xray:
enabled: true
engine-mode: 2
hidden-blocks:
# Ajouter air pour générer plus de “trous”, mais peut impacter les FPS.
- air
- 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: false
Nether (world_nether/paper-world.yml
)
anticheat:
anti-xray:
enabled: true
engine-mode: 2
hidden-blocks:
- air
- 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: false
End (world_the_end/paper-world.yml
)
anticheat:
anti-xray:
enabled: false
engine-mode: 3
Monde par défaut (paper-world-defaults.yml
)
anticheat:
anti-xray:
enabled: true
engine-mode: 3
hidden-blocks:
- air
- 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: false
Nether (world_nether/paper-world.yml
)
anticheat:
anti-xray:
enabled: true
engine-mode: 3
hidden-blocks:
- air
- 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: false
End (world_the_end/paper-world.yml
)
anticheat:
anti-xray:
enabled: false
Et voilà !
Vous avez maintenant de quoi protéger votre serveur de vilains tricheurs !
Si vous avez besoin de plus de détails, n'hésitez pas à passer sur notre Discord.