Configuración Anti-Xray Paper: Guía completa para servidor de Minecraft
La configuración del anti-xray de Paper protege un servidor de Minecraft contra los jugadores que ven a través de los bloques para encontrar minerales. Esta guía explica cómo funciona, sus tres modos, cada ajuste, configuraciones listas para copiar por tipo de servidor y por dimensión, su efecto en el rendimiento y la resolución de problemas. Sigue Paper 26.3.
Introducción a Anti-Xray
¿Qué es el X-Ray?
El X-Ray es una trampa que permite ver a través de los bloques para localizar minerales, cuevas y bases ocultas. Se usa con un cliente modificado, un paquete de recursos o un mod.
La solución de Paper
Paper incluye un anti-xray que funciona en el servidor. No necesita ningún plugin y resiste a la mayoría de las técnicas de X-Ray. También funciona en Purpur, que se basa en Paper. En Spigot o Vanilla, pasa primero a Paper: la guía Cómo optimizar un servidor de Minecraft muestra cómo instalarlo en OuiPanel.
Ventajas de la solución integrada
| Aspecto | Descripción |
|---|---|
| Rendimiento | Optimizado en el código del servidor |
| Compatibilidad | Funciona con todos los clientes vanilla |
| Mantenimiento | Se actualiza con Paper |
| Fiabilidad | Sin dependencias externas |
| Configuración | Ajustable por mundo y por dimensión |
Funcionamiento Técnico
Principio básico
El anti-xray modifica los chunks enviados a los jugadores. En lugar de los bloques reales, el servidor envía señuelos hasta que el jugador se acerca lo bastante para descubrirlos de forma normal.
Revelación de los bloques
Un bloque oculto se revela en cuanto:
el jugador rompe o coloca un bloque vecino;
un pistón mueve un bloque vecino;
una explosión destruye un bloque vecino;
el agua o la lava fluye sobre un bloque vecino.
Bloques vecinos
El sistema mira las 6 caras de un bloque. Un bloque está «expuesto» si al menos una de sus caras toca un bloque transparente: aire, cristal, agua. Los bloques expuestos no se ocultan en el modo 1.
Modos de Funcionamiento
Paper ofrece tres modos, cada uno con sus ventajas y sus límites.
Engine mode 1, sustitución simple
Este modo sustituye los bloques ocultos, cuando no están expuestos, por el bloque base de la dimensión: piedra (pizarra profunda por debajo de Y 0), netherrack o piedra del End.
Bloque oculto no expuesto → stone (o deepslate, netherrack, end_stone)
Bloque expuesto al aire → sin cambios
Poco coste para el servidor y sobre todo para los clientes, con poca memoria y ancho de banda.
En cambio, un X-Ray que filtra la piedra sigue viendo los minerales expuestos a cuevas o agua.
Recomendado para servidores con pocos recursos, muy concurridos, creativos o semi-RP.
Engine mode 2, ofuscación aleatoria
Este modo sustituye tanto los bloques ocultos como los de reemplazo por bloques sacados al azar de hidden-blocks. El X-Ray muestra entonces minerales falsos por todas partes, imposibles de distinguir de los reales.
Bloque oculto o de reemplazo → bloque aleatorio (diamond_ore, gold_ore, iron_ore…)
Bloque expuesto al aire → sin cambios
Protección fuerte: los minerales falsos y reales no se distinguen y el X-Ray deja de servir.
A cambio, más cálculo, memoria y ancho de banda.
Recomendado para la supervivencia competitiva, el PvP, las facciones y los servidores donde importa la economía de recursos.
Engine mode 3, ofuscación por capas
Como el modo 2, pero el bloque aleatorio se elige una vez por capa de chunk en lugar de una vez por bloque. Según la documentación de Paper, la carga de red al conectarse se reduce más o menos a la mitad, porque los chunks se comprimen mejor.
Comparación
| Criterio | Modo 1 | Modo 2 | Modo 3 |
|---|---|---|---|
| Protección | Básica | Fuerte | Fuerte |
| CPU | Bajo | Moderado | Moderado |
| Red | Bajo | Moderado | Menor que el modo 2 |
| Recomendado para | Servidores casuales | Servidores competitivos | Servidores competitivos concurridos |
Configuración Completa
Ubicación del archivo
config/paper-world-defaults.yml # Configuración por defecto de todos los mundos
<mundo>/paper-world.yml # Configuración propia de un mundo
Modificar el archivo en OuiPanel
En la Consola, haz clic en Detener.
Abre el Gestor de archivos, luego la carpeta
config, y haz clic enpaper-world-defaults.yml. Se abre la ventana «Edición de paper-world-defaults.yml».Sustituye la sección
anticheatpor la configuración que quieras y haz clic en Guardar.Inicia el servidor desde la Consola. Los cambios solo se aplican al reiniciar: no uses
/reload.

El YAML no admite tabulaciones y cuenta los espacios. Copia los bloques de esta guía tal cual, con su sangría.
Estructura de la configuración
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
Las entidades de bloque (cofres, cofres de Ender, barriles, cajas de Shulker, generadores, tolvas, dispensadores) no se pueden ocultar: Paper las ignora en
hidden-blocks. En cambio sí se permiten enreplacement-blocks:chestoculta allí los tesoros enterrados si se subemax-block-height.
Ajustes en detalle
| Parámetro | Por defecto | Función |
|---|---|---|
enabled | false | Activa o desactiva el anti-xray |
engine-mode | 1 | Modo 1, 2 o 3 |
max-block-height | 64 | Altura máxima donde actúa el anti-xray, en múltiplos de 16 (los demás valores se redondean hacia abajo) |
update-radius | 2 | Radio de bloques revelados cuando un jugador actúa: 1 o 2 (0 es para pruebas) |
lava-obscures | false | Oculta también los bloques que tocan lava |
use-permission | false | Deja que los jugadores con paper.antixray.bypass vean los bloques reales |
hidden-blocks | lista de minerales | Bloques que se ocultan |
replacement-blocks | stone, oak_planks, deepslate | Bloques mezclados en los modos 2 y 3, ignorados en el modo 1 |
max-block-height
max-block-height: 64
Por encima de este valor no se oculta nada. Bajarlo aligera el servidor. Valores recomendados: 64 para el Overworld, 128 para el Nether y el End desactivado. Desde la 1.18, algunos minerales se generan más arriba: ajústalo a tu mundo.
update-radius
update-radius: 2
Cuando se revela un bloque, los bloques dentro de este radio reciben sus datos reales. 1 es lo más ligero pero puede dejar bloques sin revelar, 2 es el equilibrio recomendado. Paper solo acepta 0, 1 y 2: un valor mayor se reduce a 2.
lava-obscures
lava-obscures: false
Con true, también se ocultan los bloques que tocan lava. Útil en el Nether, pero se ve mal con minerales cuya textura no parece piedra.
use-permission
use-permission: false
Con true, los jugadores con el permiso paper.antixray.bypass ven los bloques reales, algo útil para depurar. Este control viene desactivado, porque los plugins de permisos antiguos llevan mal el número de comprobaciones.
hidden-blocks
hidden-blocks:
- diamond_ore
- emerald_ore
# ...
La lista de bloques que se ocultan. En el modo 1 se sustituyen por la piedra de la dimensión; en los modos 2 y 3, por un bloque sacado al azar de esa misma lista. Un bloque añadido varias veces sale más a menudo. Añadir air crea huecos falsos que engañan a los detectores de cuevas, a costa de bajar los FPS de algunos jugadores.
replacement-blocks
replacement-blocks:
- stone
- deepslate
- granite
# ...
Bloques que también se mezclan en los modos 2 y 3. Esta lista no se usa en el modo 1.
Optimización por Tipo de Servidor
Servidor de supervivencia vanilla
Una configuración equilibrada para una supervivencia clásica.
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
Servidor de facciones y PvP
La protección más fuerte, para servidores competitivos. Los minerales se ocultan en toda la altura del mundo, igual que la TNT. Los contenedores no se pueden ocultar.
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
Servidor de economía
Una configuración centrada en los recursos valiosos, para proteger la economía del servidor.
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
Servidor de rendimiento (gran población)
La configuración más ligera, para un servidor con muchos jugadores. En el modo 1, replacement-blocks no se usa.
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
Configuración por Dimensión
Cada dimensión puede tener su propio paper-world.yml. Minecraft 26.1 trasladó las dimensiones a world/dimensions/minecraft/, así que el Nether y el End cambiaron de carpeta.
| Dimensión | Antes de la 26.1 | Desde la 26.1 |
|---|---|---|
| Overworld | world/paper-world.yml | config/paper-world-defaults.yml (recomendado) |
| 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)
El End tiene pocos recursos que proteger, y sus cofres y cajas de Shulker no se pueden ocultar. La documentación de Paper aconseja desactivar el anti-xray en esta dimensión.
anticheat:
anti-xray:
enabled: false
Impacto en el Rendimiento
Órdenes de magnitud por modo
Estas cifras son órdenes de magnitud, sin medición oficial de Paper. Mide en tu servidor con Spark.
| Métrica | Modo 1 | Modo 2 | Sin anti-xray |
|---|---|---|---|
| CPU (generación de chunks) | +5-10 % | +15-25 % | Referencia |
| RAM por chunk | +0,1 KB | +0,5 a 1 KB | Referencia |
| Ancho de banda | +2-5 % | +10-20 % | Referencia |
| Latencia de red | Despreciable | +1-5 ms | Referencia |
Qué influye en el rendimiento
Cuanto más larga es la lista hidden-blocks, más pesado es el proceso.
# Ligero (5 a 10 bloques)
hidden-blocks:
- diamond_ore
- emerald_ore
- gold_ore
- ancient_debris
- obsidian
# Pesado (20 bloques o más)
hidden-blocks:
- coal_ore
- deepslate_coal_ore
- copper_ore
- deepslate_copper_ore
# ... 20 entradas o más
Bajar max-block-height reduce bastante la carga.
# Rendimiento óptimo
max-block-height: 48
# Equilibrado
max-block-height: 64
# Protección máxima (costoso)
max-block-height: 320
update-radius en 2 comprueba más bloques vecinos que 1. Es el valor recomendado; 1 sirve en un servidor muy cargado.
update-radius: 1
update-radius: 2
Para un servidor muy cargado
anticheat:
anti-xray:
enabled: true
engine-mode: 1 # Modo más ligero
max-block-height: 48 # Límite bajo
update-radius: 1 # Radio mínimo
hidden-blocks: # Lista corta
- diamond_ore
- deepslate_diamond_ore
- ancient_debris
replacement-blocks:
- stone
Medir con Spark
Spark viene incluido en Paper desde la 1.21. En la consola de OuiPanel, escribe estos comandos sin la barra.
/spark profiler start
# Espera unos minutos mientras los jugadores juegan
/spark profiler stop
En el informe, busca AntiXray, ChunkSerializer para la generación y PlayerConnection para la red. La guía Ticks, TPS e hilo principal en Minecraft ayuda a leer el informe.
Resolución de Problemas y Problemas Comunes
Los bloques reales aparecen un instante
Los jugadores ven los bloques reales un momento mientras cargan los chunks.
La causa suele ser la latencia de red o un servidor sobrecargado.
Mantén update-radius en 2 y revisa la compresión de red en server.properties.
update-radius: 2
# En server.properties
network-compression-threshold=256
Hay bloques que siguen ocultos tras minar
Después de romper un bloque, los vecinos siguen mezclados.
update-radius es demasiado bajo, o un error afecta a tu versión de Paper.
Sube el radio y actualiza Paper desde el Gestor de Versiones de OuiPanel (Actualizar).
# Subir el radio de actualización
update-radius: 2
# Comprobar que Paper está al día
# Última build en papermc.io
El rendimiento baja
TPS bajo y lag al cargar chunks.
Aligera la configuración y acorta la lista de bloques.
# Reducir la carga
engine-mode: 1
max-block-height: 48
update-radius: 1
# Acortar la lista de bloques
hidden-blocks:
- diamond_ore
- deepslate_diamond_ore
- emerald_ore
- deepslate_emerald_ore
Algunos bloques no se ocultan
Con X-Ray, algunos jugadores siguen viendo ciertos minerales.
El bloque falta en hidden-blocks, está expuesto al aire, está por encima de max-block-height o es una entidad de bloque (cofre, generador), que no se puede ocultar.
Comprueba que estén todas las variantes.
hidden-blocks:
- diamond_ore
- deepslate_diamond_ore # No olvides la variante deepslate
Incompatibilidad con algunos plugins
Un plugin de protección o de economía funciona mal porque interactúa con los bloques de forma poco habitual. Actualiza el plugin o contacta con su desarrollador. Para que los administradores vean los bloques reales durante las pruebas, activa el permiso de omisión y da paper.antixray.bypass a los administradores.
use-permission: true
La guía Configurar LuckPerms explica cómo dar un permiso.
Comandos útiles
# Ver la versión de Paper
/version
# Volcar los plugins y sus dependencias en un archivo de diagnóstico
/paper dumpplugins
# Perfilar el servidor
/spark profiler start
/spark profiler stop
El anti-xray no se recarga en caliente: después de cada cambio, reinicia el servidor desde la Consola › Reiniciar.
Mejores Prácticas
Configuración inicial
Empieza en el modo 2 o 3 para una protección fuerte.
Ajusta después según el rendimiento medido.
Prueba con jugadores de confianza que usen X-Ray.
Lista de bloques recomendada
| Categoría | Bloques |
|---|---|
| Imprescindibles (todos los servidores) | diamond_ore, deepslate_diamond_ore, emerald_ore, deepslate_emerald_ore, ancient_debris |
| Recomendados (supervivencia) | 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 |
| Especiales | tnt (servidores PvP), obsidian (bases ocultas), mossy_cobblestone (mazmorras) |
| Imposibles de ocultar | Cofres, cofres trampa, cofres de Ender, barriles, cajas de Shulker, tolvas, dispensadores, soltadores, generadores: son entidades de bloque |
Mantenimiento
Actualiza Paper con regularidad para tener las correcciones.
Vigila el rendimiento con Spark.
Prueba después de cada gran actualización de Minecraft, como el cambio de carpetas de la 26.1.
Anota tus cambios en un registro de cambios.
Seguridad complementaria
El anti-xray no sustituye a otras medidas:
un plugin antitrampas (Matrix, Vulcan, Grim);
un registro de bloques (CoreProtect, Prism);
una moderación activa y los avisos de los jugadores;
la revisión periódica de los jugadores sospechosos.
Recursos y Referencias
¿Necesitas ayuda?
Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.
Descubre nuestros planes de alojamiento Minecraft desde 1,99€/mes con instalación automática de mods.
Hosting Minecraft →