Comment configurer l'anti-xray de Paper sur Minecraft

La configuration de l'anti-xray de Paper protège un serveur Minecraft contre les joueurs qui voient à travers les blocs pour trouver les minerais. Ce guide explique son fonctionnement, ses trois modes, chaque réglage, des configurations prêtes à copier par type de serveur et par dimension, son effet sur les performances et le dépannage. Il suit Paper 26.3.

---

Introduction à l'Anti-Xray

Qu'est-ce que le X-Ray ?

Le X-Ray est une triche qui permet de voir à travers les blocs pour repérer les minerais, les grottes et les bases cachées. Elle passe par un client modifié, un pack de ressources ou un mod.

La solution de Paper

Paper intègre un anti-xray qui fonctionne côté serveur. Il ne demande aucun plugin et résiste à la plupart des techniques de X-Ray. Il marche aussi sur Purpur, qui repose sur Paper. Sur Spigot ou Vanilla, il faut d'abord passer à Paper : le guide Comment optimiser un serveur Minecraft montre comment l'installer dans OuiPanel.

Avantages de la solution native

Aspect	Description
Performance	Optimisé dans le code du serveur
Compatibilité	Fonctionne avec tous les clients vanilla
Maintenance	Mis à jour avec Paper
Fiabilité	Aucune dépendance externe
Configuration	Réglable par monde et par dimension

---

Fonctionnement Technique

Principe de base

L'anti-xray modifie les chunks envoyés aux joueurs. Au lieu des vrais blocs, le serveur envoie des leurres, jusqu'à ce que le joueur s'approche assez pour les révéler normalement.

Révélation des blocs

Un bloc caché est révélé dès que :

• le joueur casse ou pose un bloc voisin ;

• un piston déplace un bloc voisin ;

• une explosion détruit un bloc voisin ;

• de l'eau ou de la lave coule sur un bloc voisin.

Blocs voisins

Le système regarde les 6 faces d'un bloc. Un bloc est « exposé » si au moins une de ses faces touche un bloc transparent : air, verre, eau. Les blocs exposés ne sont pas cachés en mode 1.

---

Modes de Fonctionnement

Paper propose trois modes, chacun avec ses avantages et ses limites.

Engine mode 1, remplacement simple

Ce mode remplace les blocs cachés, quand ils ne sont pas exposés, par un bloc de la dimension : pierre (ardoise des abîmes sous la couche 0), netherrack ou pierre de l'End.

Bloc caché non exposé → stone (ou deepslate, netherrack, end_stone)
Bloc exposé à l'air      → reste inchangé

• Coût faible pour le serveur et surtout pour les clients, avec peu de mémoire et de bande passante.

• En revanche, un X-Ray qui filtre la pierre voit encore les minerais exposés aux grottes ou à l'eau.

• Conseillé pour les serveurs aux ressources limitées, très peuplés, créatifs ou semi-RP.

Engine mode 2, brouillage aléatoire

Ce mode remplace les blocs cachés et ceux de la liste de remplacement par des blocs tirés au hasard dans hidden-blocks. Le X-Ray affiche alors partout de faux minerais, impossibles à distinguer des vrais.

Bloc caché ou de remplacement → bloc aléatoire (diamond_ore, gold_ore, iron_ore…)
Bloc exposé à l'air            → reste inchangé

• Protection forte : faux et vrais minerais se confondent, et le X-Ray devient inutile.

• En contrepartie, plus de calcul, de mémoire et de bande passante.

• Conseillé pour la survie compétitive, le PvP, les factions et les serveurs où l'économie des ressources compte.

Engine mode 3, brouillage par couche

Comme le mode 2, mais le bloc aléatoire est tiré une fois par couche de chunk au lieu d'une fois par bloc. D'après la documentation de Paper, la charge réseau à la connexion est environ divisée par deux, car les chunks se compressent mieux.

Comparaison

Critère	Mode 1	Mode 2	Mode 3
Protection	Basique	Forte	Forte
Processeur	Faible	Modéré	Modéré
Réseau	Faible	Modéré	Plus faible que le mode 2
Conseillé pour	Serveurs détente	Serveurs compétitifs	Serveurs compétitifs très peuplés

---

Configuration Complète

Emplacement du fichier

config/paper-world-defaults.yml      # Configuration par défaut de tous les mondes
<monde>/paper-world.yml              # Configuration propre à un monde

Modifier le fichier dans OuiPanel

1. Dans la Console, cliquez sur Arrêter.

2. Ouvrez le Gestionnaire de fichiers, puis le dossier config, et cliquez sur paper-world-defaults.yml. La fenêtre « Édition de paper-world-defaults.yml » s'ouvre.

3. Remplacez la section anticheat par la configuration voulue, puis cliquez sur Sauvegarder.

4. Démarrez le serveur depuis la Console. Les changements ne s'appliquent qu'au redémarrage : n'utilisez pas /reload.

Le YAML refuse les tabulations et compte les espaces. Copiez les blocs de ce guide tels quels, avec leur indentation.

Structure de la configuration

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

Les entités de bloc (coffres, coffres de l'Ender, tonneaux, boîtes de Shulker, générateurs, entonnoirs, distributeurs) ne peuvent pas être cachées : Paper les ignore dans hidden-blocks. Elles sont en revanche permises dans replacement-blocks : chest y cache les trésors enfouis si max-block-height est relevé.

Paramètres détaillés

Paramètre	Défaut	Rôle
enabled	false	Active ou coupe l'anti-xray
engine-mode	1	Mode 1, 2 ou 3
max-block-height	64	Hauteur maximale où l'anti-xray agit, en multiples de 16 (les autres valeurs sont arrondies vers le bas)
update-radius	2	Rayon des blocs révélés quand un joueur agit : 1 ou 2 (0 sert aux tests)
lava-obscures	false	Cache aussi les blocs qui touchent la lave
use-permission	false	Laisse les joueurs ayant paper.antixray.bypass voir les vrais blocs
hidden-blocks	liste de minerais	Blocs à cacher
replacement-blocks	stone, oak_planks, deepslate	Blocs brouillés en modes 2 et 3, ignorés en mode 1

max-block-height

max-block-height: 64

Au-dessus de cette valeur, rien n'est caché. La baisser allège le serveur. Valeurs conseillées : 64 pour l'Overworld, 128 pour le Nether, et l'End désactivé. Depuis la 1.18, certains minerais se forment plus haut : ajustez selon votre monde.

update-radius

update-radius: 2

Quand un bloc est révélé, les blocs dans ce rayon reçoivent leurs vraies données. 1 est le plus léger mais peut laisser des blocs non révélés, 2 est l'équilibre conseillé. Paper n'accepte que 0, 1 et 2 : une valeur plus haute est ramenée à 2.

lava-obscures

lava-obscures: false

Sur true, les blocs qui touchent la lave sont cachés eux aussi. Utile dans le Nether, mais le rendu est mauvais avec les minerais dont la texture ne ressemble pas à de la pierre.

use-permission

use-permission: false

Sur true, les joueurs qui ont la permission paper.antixray.bypass voient les vrais blocs, utile aux administrateurs pour déboguer. Ce contrôle est coupé par défaut, car d'anciens plugins de permissions supportent mal le nombre de vérifications.

hidden-blocks

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

La liste des blocs à cacher. En mode 1, ils sont remplacés par la pierre de la dimension ; en modes 2 et 3, par un bloc tiré au hasard dans cette même liste. Un bloc ajouté plusieurs fois sort plus souvent. Ajouter air crée de faux trous qui trompent les détecteurs de grottes, au prix de FPS plus bas chez certains joueurs.

replacement-blocks

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

Les blocs eux aussi brouillés en modes 2 et 3. Cette liste n'est pas utilisée en mode 1.

---

Optimisation par Type de Serveur

Serveur survie vanilla

Une configuration équilibrée pour une survie classique.

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

Serveur faction et PvP

La protection la plus forte, pour les serveurs compétitifs. Les minerais sont cachés sur toute la hauteur du monde, ainsi que la TNT. Les conteneurs, eux, ne peuvent pas être cachés.

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

Serveur économique

Une configuration qui vise les ressources de valeur, pour protéger l'économie du serveur.

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

Serveur performance (grande population)

La configuration la plus légère, pour un serveur avec beaucoup de joueurs. En mode 1, replacement-blocks n'est pas utilisé.

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

---

Configuration par Dimension

Chaque dimension peut avoir son propre paper-world.yml. Minecraft 26.1 a déplacé les dimensions dans world/dimensions/minecraft/ : le Nether et l'End ont donc changé de dossier.

Dimension	Avant 26.1	Depuis 26.1
Overworld	world/paper-world.yml	config/paper-world-defaults.yml (conseillé)
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)

L'End contient peu de ressources à protéger, et ses coffres et boîtes de Shulker ne peuvent pas être cachés. La documentation de Paper conseille de désactiver l'anti-xray dans cette dimension.

anticheat:
  anti-xray:
    enabled: false

---

Impact sur les Performances

Ordres de grandeur par mode

Ces chiffres sont des ordres de grandeur, sans mesure officielle de Paper. Mesurez sur votre serveur avec Spark.

Mesure	Mode 1	Mode 2	Sans anti-xray
Processeur (génération des chunks)	+5-10 %	+15-25 %	Référence
RAM par chunk	+0,1 Ko	+0,5 à 1 Ko	Référence
Bande passante	+2-5 %	+10-20 %	Référence
Latence réseau	Négligeable	+1-5 ms	Référence

Ce qui pèse sur les performances

Plus la liste hidden-blocks est longue, plus le traitement est lourd.

# Léger (5 à 10 blocs)
hidden-blocks:
  - diamond_ore
  - emerald_ore
  - gold_ore
  - ancient_debris
  - obsidian
# Lourd (20 blocs et plus)
hidden-blocks:
  - coal_ore
  - deepslate_coal_ore
  - copper_ore
  - deepslate_copper_ore
  # ... 20 entrées et plus

Baisser max-block-height réduit nettement la charge.

# Performances optimales
max-block-height: 48
# Équilibré
max-block-height: 64
# Protection maximale (coûteux)
max-block-height: 320

update-radius à 2 vérifie plus de blocs voisins que 1. C'est la valeur conseillée ; 1 sert sur un serveur très chargé.

update-radius: 1
update-radius: 2

Pour un serveur très chargé

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 1          # Mode le plus léger
    max-block-height: 48    # Limite basse
    update-radius: 1        # Rayon minimal
    hidden-blocks:          # Liste courte
      - diamond_ore
      - deepslate_diamond_ore
      - ancient_debris
    replacement-blocks:
      - stone

Mesurer avec Spark

Spark est inclus dans Paper depuis la 1.21. Dans la console de OuiPanel, tapez ces commandes sans la barre oblique.

/spark profiler start
# Attendez quelques minutes pendant que les joueurs jouent
/spark profiler stop

Dans le rapport, cherchez AntiXray, ChunkSerializer pour la génération et PlayerConnection pour le réseau. Le guide Ticks, TPS et main thread sur Minecraft aide à lire le rapport.

---

Dépannage et Problèmes Courants

Les vrais blocs apparaissent un instant

Les joueurs voient les vrais blocs un court instant pendant le chargement des chunks.

La cause est souvent la latence réseau ou un serveur trop chargé.

Gardez update-radius à 2 et vérifiez la compression réseau dans server.properties.

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

Des blocs restent cachés après le minage

Après avoir cassé un bloc, les blocs voisins restent brouillés.

update-radius est trop bas, ou un bug touche votre version de Paper.

Remontez le rayon et mettez Paper à jour depuis le Gestionnaire de Versions de OuiPanel (Mettre à jour).

# Remonter le rayon de mise à jour
update-radius: 2
# Vérifier que Paper est à jour
# Dernière build sur papermc.io

Les performances baissent

TPS bas et lag au chargement des chunks.

Allégez la configuration et raccourcissez la liste des blocs.

# Réduire la charge
engine-mode: 1
max-block-height: 48
update-radius: 1
# Réduire la liste des blocs
hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore
  - emerald_ore
  - deepslate_emerald_ore

Certains blocs ne sont pas cachés

Avec un X-Ray, des joueurs voient encore certains minerais.

Le bloc manque dans hidden-blocks, il est exposé à l'air, il dépasse max-block-height, ou c'est une entité de bloc (coffre, générateur), qui ne peut pas être cachée.

Vérifiez que toutes les variantes sont listées.

hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore  # Ne pas oublier la version deepslate

Incompatibilité avec certains plugins

Un plugin de protection ou d'économie fonctionne mal, parce qu'il interagit avec les blocs d'une façon inhabituelle. Mettez le plugin à jour ou contactez son développeur. Pour que les administrateurs voient les vrais blocs pendant le test, activez la permission de contournement, puis donnez paper.antixray.bypass aux administrateurs.

use-permission: true

Le guide Configurer LuckPerms explique comment donner une permission.

Commandes utiles

# Voir la version de Paper
/version
# Lister les plugins et leurs dépendances dans un fichier de diagnostic
/paper dumpplugins
# Profiler le serveur
/spark profiler start
/spark profiler stop

Il n'y a pas de rechargement à chaud de l'anti-xray : après chaque changement, redémarrez le serveur depuis la Console › Redémarrer.

---

Bonnes Pratiques

Configuration initiale

• Commencez en mode 2 ou 3 pour une protection forte.

• Ajustez ensuite selon les performances mesurées.

• Testez avec des joueurs de confiance équipés d'un X-Ray.

Liste des blocs conseillée

Catégorie	Blocs
Indispensables (tous serveurs)	diamond_ore, deepslate_diamond_ore, emerald_ore, deepslate_emerald_ore, ancient_debris
Conseillés (survie)	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
Spéciaux	tnt (serveurs PvP), obsidian (bases cachées), mossy_cobblestone (donjons)
Impossibles à cacher	Coffres, coffres piégés, coffres de l'Ender, tonneaux, boîtes de Shulker, entonnoirs, distributeurs, droppers, générateurs : ce sont des entités de bloc

Maintenance

• Mettez Paper à jour régulièrement pour profiter des correctifs.

• Surveillez les performances avec Spark.

• Testez après chaque grande mise à jour de Minecraft, comme le changement de dossiers de la 26.1.

• Notez vos modifications dans un journal des changements.

Sécurité complémentaire

L'anti-xray ne remplace pas les autres mesures :

• un plugin anti-triche (Matrix, Vulcan, Grim) ;

• un journal des blocs (CoreProtect, Prism) ;

• une modération active et les signalements des joueurs ;

• une vérification régulière des joueurs suspects.

---

Ressources et Références

• Documentation de Paper

• Page anti-xray de Paper

• Spark, le profileur

• Timings, abandonné par Paper

• Discord PaperMC

• Forums SpigotMC

---

Besoin d'aide ?

Ouvrez un ticket depuis Tickets › Ouvrir un ticket, ou depuis la tuile Contacter le support en bas de la fiche de votre serveur dans l'espace client. Vous pouvez aussi poser votre question sur le Discord de OuiHeberg.

Ouvrir un ticketDiscord