MinecraftPublicado el 21 de enero de 2026Lectura de 13 min

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

AspectoDescripción
RendimientoOptimizado en el código del servidor
CompatibilidadFunciona con todos los clientes vanilla
MantenimientoSe actualiza con Paper
FiabilidadSin dependencias externas
ConfiguraciónAjustable 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

CriterioModo 1Modo 2Modo 3
ProtecciónBásicaFuerteFuerte
CPUBajoModeradoModerado
RedBajoModeradoMenor que el modo 2
Recomendado paraServidores casualesServidores competitivosServidores 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

  1. En la Consola, haz clic en Detener.

  2. Abre el Gestor de archivos, luego la carpeta config, y haz clic en paper-world-defaults.yml. Se abre la ventana «Edición de paper-world-defaults.yml».

  3. Sustituye la sección anticheat por la configuración que quieras y haz clic en Guardar.

  4. Inicia el servidor desde la Consola. Los cambios solo se aplican al reiniciar: no uses /reload.

Ventana Edición de config.yml con un archivo YAML y el botón Guardar

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 en replacement-blocks: chest oculta allí los tesoros enterrados si se sube max-block-height.

Ajustes en detalle

ParámetroPor defectoFunción
enabledfalseActiva o desactiva el anti-xray
engine-mode1Modo 1, 2 o 3
max-block-height64Altura máxima donde actúa el anti-xray, en múltiplos de 16 (los demás valores se redondean hacia abajo)
update-radius2Radio de bloques revelados cuando un jugador actúa: 1 o 2 (0 es para pruebas)
lava-obscuresfalseOculta también los bloques que tocan lava
use-permissionfalseDeja que los jugadores con paper.antixray.bypass vean los bloques reales
hidden-blockslista de mineralesBloques que se ocultan
replacement-blocksstone, oak_planks, deepslateBloques 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ónAntes de la 26.1Desde la 26.1
Overworldworld/paper-world.ymlconfig/paper-world-defaults.yml (recomendado)
Netherworld_nether/paper-world.ymlworld/dimensions/minecraft/the_nether/paper-world.yml
Endworld_the_end/paper-world.ymlworld/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étricaModo 1Modo 2Sin anti-xray
CPU (generación de chunks)+5-10 %+15-25 %Referencia
RAM por chunk+0,1 KB+0,5 a 1 KBReferencia
Ancho de banda+2-5 %+10-20 %Referencia
Latencia de redDespreciable+1-5 msReferencia

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íaBloques
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
Especialestnt (servidores PvP), obsidian (bases ocultas), mossy_cobblestone (mazmorras)
Imposibles de ocultarCofres, 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.

¿Te ha sido útil este artículo?

1946 vistas
Compartir este artículo
Minecraft
¿Necesitas un servidor Minecraft?

Descubre nuestros planes de alojamiento Minecraft desde 1,99€/mes con instalación automática de mods.

Hosting Minecraft →

Artículos relacionados

¿No encontraste lo que buscabas?

El equipo de soporte responde 7 días a la semana.

Abrir un ticketDesde tu área de clienteDiscord de la comunidadAyuda y anunciosEstado de los serviciosstatus.ouiheberg.com