Bloquer le X-ray sur votre serveur Paper

Les joueurs qui voient tous les minerais à travers la pierre, ça vous parle ? Le X-ray est l’un des cheats les plus courants sur un serveur Minecraft. Heureusement, si vous utilisez Paper, vous avez déjà un puissant anti-Xray intégré, il suffit de bien le configurer.

Dans ce guide, vous allez voir comment bloquer le X-ray sur votre serveur Paper, comprendre les différents modes disponibles, et copier-coller une configuration prête à l’emploi pour vos mondes Overworld, Nether et End.

Nous verrons aussi quelques limites et contournements possibles, afin que vous sachiez exactement ce que protège (ou non) l’anti-Xray de Paper.

Comprendre l’anti-Xray intégré à Paper

Paper intègre un système d’anti-Xray basé sur l’obfuscation des blocs. Concrètement, le serveur envoie de faux blocs au client pour empêcher les mods X-ray de repérer facilement les minerais ou blocs rares. Ce système est configurable par monde et propose trois modes principaux.

Ces modes sont définis via la valeur engine-mode dans la configuration Paper. Chaque mode change la façon dont les blocs sont remplacés côté client, tout en gardant la vraie génération côté serveur.

Voici un résumé des trois modes disponibles :

• engine-mode: 1 : remplace les blocs listés dans hidden-blocks par des blocs “factice” (par exemple stone, deepslate, netherrack, end_stone)

• 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 : similaire au mode 2, mais la randomisation se fait par couche de chunk plutôt que bloc par bloc

💬 Bon à savoir : Plus le mode est agressif (2 ou 3), plus il est efficace contre le X-ray, mais il peut aussi impacter les performances ou le rendu visuel.

Accéder au fichier de configuration Paper

Pour activer et configurer l’anti-Xray Paper, vous devez modifier le fichier paper-world-defaults.yml (et éventuellement les fichiers paper-world.yml de chaque monde). Ces fichiers se trouvent dans le dossier de votre serveur Paper.

Vous pouvez les ouvrir directement depuis l'onglet Fichiers de votre Mineboard.

Limites et contournements de l’anti-Xray

L’anti-Xray de Paper est très efficace, mais comme tout système, il existe des contournements possibles. L’objectif est de connaître ces limites pour adapter votre configuration et, si besoin, compléter avec d’autres protections.

Voici quelques bypass courants à garder en tête :

• Extension de portée : certains clients “range extender” augmentent la distance de vision des blocs réels. Pour une protection plus robuste, combinez l’anti-Xray Paper avec un plugin anti-cheat dédié.

• Récupération de seed : si un joueur découvre la seed du monde, il peut localiser tous les minerais via des outils externes. Pour limiter ce risque, activez la fonction feature-seeds et utilisez idéalement une seed différente par monde.

  📝 Note : Si les joueurs n'ont pas accès au /seed et ne peuvent pas le télécharger le monde, cela ne devrait pas être un problème.

• Minerais exposés à l’air : en mode 1, les minerais à l’air libre restent visibles. En modes 2 et 3, ajouter air à hidden-blocks permet de masquer aussi ces minerais, au prix d’un impact potentiel sur les FPS.

📝 Note : Vous trouverez plus de détails techniques sur la configuration des mondes Paper dans la documentation officielle de Paper.

Précautions avant de copier la configuration

Dans la suite du guide, vous trouverez des configurations complètes prêtes à copier-coller pour chaque engine-mode et chaque monde (Overworld, Nether, End). Vous pouvez les utiliser telles quelles ou les adapter à votre serveur.

Gardez cependant en tête que les fichiers Paper sont au format YAML, très sensible aux espaces et à l’indentation. Une simple erreur de tabulation peut empêcher votre serveur de démarrer correctement.

⚠️ Attention : YAML ne supporte pas les tabulations. Utilisez uniquement des espaces et conservez exactement l’indentation des exemples ci-dessous.

💡 Astuce : Si vous avez un doute, collez votre configuration dans un validateur YAML en ligne avant de redémarrer votre serveur.

Configuration recommandée – engine-mode 1

Le mode engine-mode: 1 est le plus léger et le plus simple. Il remplace uniquement les blocs listés dans hidden-blocks par des blocs factices (pierre, deepslate, netherrack, etc.). C’est un bon compromis entre protection et performances.

Voici une configuration recommandée pour l’Overworld, le Nether et l’End avec engine-mode 1.

Overworld – paper-world-defaults.yml

Ajoutez ou adaptez ce bloc dans votre fichier 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

Pour le Nether, ouvrez world_nether/paper-world.yml et utilisez cette configuration :

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

Dans l’End, il n’y a pas vraiment de minerais à protéger. Vous pouvez donc désactiver l’anti-Xray :

anticheat:
  anti-xray:
    enabled: false

Configuration recommandée – engine-mode 2

Le mode engine-mode: 2 est plus agressif. Il remplace à la fois les blocs de hidden-blocks et ceux de replacement-blocks par des blocs tirés au hasard dans la liste hidden-blocks. Cela rend les veines de minerais beaucoup plus difficiles à repérer pour les clients X-ray.

Ce mode offre une excellente protection contre le X-ray, au prix d’un peu plus de charge serveur et de complexité visuelle pour les joueurs.

Overworld – paper-world-defaults.yml

Pour l’Overworld avec engine-mode: 2, utilisez cette configuration :

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

Pour le Nether avec engine-mode: 2, voici la configuration recommandée :

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

Comme pour le mode 1, vous pouvez laisser l’anti-Xray désactivé dans l’End :

anticheat:
  anti-xray:
    enabled: false

Configuration recommandée – engine-mode 3

Le mode engine-mode: 3 fonctionne comme le mode 2, mais applique la randomisation par couche de chunk plutôt que bloc par bloc. Cela peut offrir un meilleur équilibre entre protection et performances sur certains serveurs.

Si vous cherchez une protection très solide contre le X-ray tout en limitant l’impact sur le serveur, ce mode est une excellente option à tester.

Overworld – paper-world-defaults.yml

Pour l’Overworld avec engine-mode: 3, utilisez ce bloc :

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

Pour le Nether avec engine-mode: 3, voici la configuration :

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

Et pour l’End, vous pouvez continuer à laisser l’anti-Xray désactivé :

anticheat:
  anti-xray:
    enabled: false

Questions fréquentes

Quel engine-mode choisir pour mon serveur Paper ?

Pour un serveur survie classique, engine-mode 2 ou 3 offre la meilleure protection contre le X-ray. Le mode 1 est plus léger mais laisse visibles certains minerais exposés. Si vous débutez, testez le mode 2, puis ajustez selon les performances et les retours de vos joueurs.

La configuration anti-Xray Paper impacte-t-elle les performances ?

Oui, c'est possible. Plus le mode est agressif (2 ou 3, avec beaucoup de blocs dans hidden-blocks), plus le serveur doit travailler pour obfusquer les chunks. Sur une bonne machine ou une offre d’hébergement optimisée, cet impact reste généralement limité.

Dois-je activer l’anti-Xray sur tous mes mondes ?

Ce n’est pas obligatoire. L’Overworld et le Nether sont les mondes prioritaires, car c’est là que se trouvent les minerais importants. L’End contient peu de blocs “rentables” pour le X-ray, donc la plupart des administrateurs laissent l’anti-Xray désactivé sur ce monde.

Faut-il quand même utiliser un plugin anti-cheat ?

Oui, l’anti-Xray Paper ne remplace pas un anti-cheat global. Il bloque une grande partie des clients X-ray, mais ne détecte pas d’autres cheats (fly, speed, reach, etc.). Combiner les deux reste la meilleure approche pour sécuriser votre serveur.

Conclusion

Avec ces configurations, vous avez tout ce qu’il faut pour bloquer efficacement le X-ray sur votre serveur Paper et protéger vos minerais des tricheurs. Choisissez l’engine-mode adapté à vos besoins, collez la configuration dans vos fichiers Paper, puis redémarrez votre serveur pour appliquer les changements.

Vous n’avez pas encore de serveur ou vous voulez une machine plus solide pour supporter l’anti-Xray et vos plugins ? Découvrez nos offres d’hébergement Minecraft ou testez gratuitement pendant 12h, sans carte bancaire pour voir ce que ça donne en conditions réelles.