MinecraftPubblicato il 21 gennaio 2026Lettura di 12 min

Come configurare l'anti-xray di Paper su Minecraft

La configurazione dell'anti-xray di Paper protegge un server Minecraft dai giocatori che vedono attraverso i blocchi per trovare i minerali. Questa guida spiega come funziona, le sue tre modalità, ogni impostazione, configurazioni pronte da copiare per tipo di server e per dimensione, l'effetto sulle prestazioni e la risoluzione dei problemi. Segue Paper 26.3.


Introduzione all'Anti-Xray

Cos'è l'X-Ray?

L'X-Ray è un trucco che permette di vedere attraverso i blocchi per individuare minerali, grotte e basi nascoste. Passa da un client modificato, un pacchetto di risorse o una mod.

La soluzione di Paper

Paper include un anti-xray che lavora lato server. Non richiede plugin e resiste alla maggior parte delle tecniche di X-Ray. Funziona anche su Purpur, basato su Paper. Su Spigot o Vanilla passa prima a Paper: la guida Come ottimizzare un server Minecraft mostra come installarlo in OuiPanel.

Vantaggi della soluzione integrata

AspettoDescrizione
PrestazioniOttimizzato nel codice del server
CompatibilitàFunziona con tutti i client vanilla
ManutenzioneAggiornato con Paper
AffidabilitàNessuna dipendenza esterna
ConfigurazioneRegolabile per mondo e per dimensione

Funzionamento Tecnico

Principio di base

L'anti-xray modifica i chunk inviati ai giocatori. Invece dei blocchi veri, il server invia delle esche finché il giocatore non si avvicina abbastanza da scoprirli normalmente.

Rivelazione dei blocchi

Un blocco nascosto viene rivelato appena:

  • il giocatore rompe o piazza un blocco vicino;

  • un pistone sposta un blocco vicino;

  • un'esplosione distrugge un blocco vicino;

  • acqua o lava scorre su un blocco vicino.

Blocchi vicini

Il sistema guarda le 6 facce di un blocco. Un blocco è «esposto» se almeno una faccia tocca un blocco trasparente: aria, vetro, acqua. I blocchi esposti non vengono nascosti nella modalità 1.


Modalità di Funzionamento

Paper offre tre modalità, ognuna con vantaggi e limiti.

Engine mode 1, sostituzione semplice

Questa modalità sostituisce i blocchi nascosti, quando non sono esposti, con il blocco base della dimensione: pietra (ardesia abissale sotto Y 0), netherrack o pietra dell'End.

Blocco nascosto non esposto → stone (o deepslate, netherrack, end_stone)
Blocco esposto all'aria     → invariato
  • Costo basso per il server e soprattutto per i client, con poca memoria e banda.

  • Però un X-Ray che filtra la pietra vede ancora i minerali esposti a grotte o acqua.

  • Consigliata per server con poche risorse, molto affollati, creativi o semi-RP.

Engine mode 2, offuscamento casuale

Questa modalità sostituisce sia i blocchi nascosti sia quelli di sostituzione con blocchi estratti a caso da hidden-blocks. L'X-Ray mostra allora minerali finti ovunque, impossibili da distinguere da quelli veri.

Blocco nascosto o sostitutivo → blocco casuale (diamond_ore, gold_ore, iron_ore…)
Blocco esposto all'aria       → invariato
  • Protezione forte: minerali veri e finti non si distinguono e l'X-Ray diventa inutile.

  • In cambio, più calcolo, memoria e banda.

  • Consigliata per sopravvivenza competitiva, PvP, fazioni e server dove conta l'economia delle risorse.

Engine mode 3, offuscamento per strato

Come la modalità 2, ma il blocco casuale viene estratto una volta per strato di chunk invece che per blocco. Secondo la documentazione di Paper, il carico di rete all'accesso si dimezza circa, perché i chunk si comprimono meglio.

Confronto

CriterioModalità 1Modalità 2Modalità 3
ProtezioneDi baseForteForte
CPUBassoModeratoModerato
ReteBassoModeratoInferiore alla modalità 2
Consigliata perServer rilassatiServer competitiviServer competitivi affollati

Configurazione Completa

Posizione del file

config/paper-world-defaults.yml      # Configurazione predefinita di tutti i mondi
<mondo>/paper-world.yml              # Configurazione di un singolo mondo

Modificare il file in OuiPanel

  1. Nella Console, clicca su Ferma.

  2. Apri Gestione file, poi la cartella config, e clicca su paper-world-defaults.yml. Si apre la finestra «Modifica di paper-world-defaults.yml».

  3. Sostituisci la sezione anticheat con la configurazione voluta, poi clicca su Salva.

  4. Avvia il server dalla Console. Le modifiche valgono solo dopo il riavvio: non usare /reload.

Finestra Modifica di config.yml con un file YAML e il pulsante Salva

Lo YAML rifiuta le tabulazioni e conta gli spazi. Copia i blocchi di questa guida così come sono, con il loro rientro.

Struttura della configurazione

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

Le entità blocco (bauli, bauli di Ender, barili, scatole di Shulker, spawner, tramogge, dispenser) non si possono nascondere: Paper le ignora in hidden-blocks. Sono invece ammesse in replacement-blocks: lì chest nasconde i tesori sepolti se max-block-height viene alzato.

Impostazioni in dettaglio

ParametroPredefinitoFunzione
enabledfalseAttiva o disattiva l'anti-xray
engine-mode1Modalità 1, 2 o 3
max-block-height64Altezza massima in cui agisce l'anti-xray, in multipli di 16 (gli altri valori sono arrotondati per difetto)
update-radius2Raggio dei blocchi rivelati quando un giocatore agisce: 1 o 2 (0 serve per i test)
lava-obscuresfalseNasconde anche i blocchi che toccano la lava
use-permissionfalseFa vedere i blocchi veri ai giocatori con paper.antixray.bypass
hidden-blockselenco di mineraliBlocchi da nascondere
replacement-blocksstone, oak_planks, deepslateBlocchi mescolati nelle modalità 2 e 3, ignorati nella 1

max-block-height

max-block-height: 64

Sopra questo valore non si nasconde nulla. Abbassarlo alleggerisce il server. Valori consigliati: 64 per l'Overworld, 128 per il Nether e l'End disattivato. Dalla 1.18 alcuni minerali si generano più in alto: regola il valore sul tuo mondo.

update-radius

update-radius: 2

Quando un blocco viene rivelato, i blocchi in questo raggio ricevono i dati veri. 1 è il più leggero ma può lasciare blocchi non rivelati, 2 è l'equilibrio consigliato. Paper accetta solo 0, 1 e 2: un valore più alto viene ridotto a 2.

lava-obscures

lava-obscures: false

Con true vengono nascosti anche i blocchi che toccano la lava. Utile nel Nether, ma rende male con i minerali la cui texture non somiglia alla pietra.

use-permission

use-permission: false

Con true i giocatori con il permesso paper.antixray.bypass vedono i blocchi veri, utile agli amministratori per il debug. Il controllo è disattivato di default, perché i vecchi plugin di permessi reggono male il numero di verifiche.

hidden-blocks

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

L'elenco dei blocchi da nascondere. Nella modalità 1 vengono sostituiti dalla pietra della dimensione; nelle 2 e 3 da un blocco estratto a caso da questo stesso elenco. Un blocco aggiunto più volte esce più spesso. Aggiungere air crea buchi finti che ingannano i rilevatori di grotte, al prezzo di FPS più bassi per alcuni giocatori.

replacement-blocks

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

Blocchi mescolati anch'essi nelle modalità 2 e 3. Questo elenco non si usa nella modalità 1.


Ottimizzazione per Tipo di Server

Server sopravvivenza vanilla

Una configurazione equilibrata per una sopravvivenza classica.

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

Server fazioni e PvP

La protezione più forte, per i server competitivi. I minerali sono nascosti su tutta l'altezza del mondo, insieme al TNT. I contenitori non si possono nascondere.

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

Server economico

Una configurazione mirata alle risorse di valore, per proteggere l'economia del server.

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

Server prestazioni (grande popolazione)

La configurazione più leggera, per un server con molti giocatori. Nella modalità 1 replacement-blocks non si 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

Configurazione per Dimensione

Ogni dimensione può avere il proprio paper-world.yml. Minecraft 26.1 ha spostato le dimensioni in world/dimensions/minecraft/, quindi Nether ed End hanno cambiato cartella.

DimensionePrima della 26.1Dalla 26.1
Overworldworld/paper-world.ymlconfig/paper-world-defaults.yml (consigliato)
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)

L'End contiene poche risorse da proteggere, e i suoi bauli e scatole di Shulker non si possono nascondere. La documentazione di Paper consiglia di disattivare l'anti-xray in questa dimensione.

anticheat:
  anti-xray:
    enabled: false

Impatto sulle Performance

Ordini di grandezza per modalità

Questi valori sono ordini di grandezza, senza misure ufficiali di Paper. Misura sul tuo server con Spark.

MetricaModalità 1Modalità 2Senza anti-xray
CPU (generazione dei chunk)+5-10 %+15-25 %Riferimento
RAM per chunk+0,1 KBda +0,5 a 1 KBRiferimento
Banda+2-5 %+10-20 %Riferimento
Latenza di reteTrascurabile+1-5 msRiferimento

Cosa pesa sulle prestazioni

Più l'elenco hidden-blocks è lungo, più l'elaborazione è pesante.

# Leggero (da 5 a 10 blocchi)
hidden-blocks:
  - diamond_ore
  - emerald_ore
  - gold_ore
  - ancient_debris
  - obsidian
# Pesante (20 blocchi o più)
hidden-blocks:
  - coal_ore
  - deepslate_coal_ore
  - copper_ore
  - deepslate_copper_ore
  # ... 20 voci o più

Abbassare max-block-height riduce molto il carico.

# Prestazioni ottimali
max-block-height: 48
# Equilibrato
max-block-height: 64
# Protezione massima (costoso)
max-block-height: 320

update-radius a 2 controlla più blocchi vicini di 1. È il valore consigliato; 1 serve su un server molto carico.

update-radius: 1
update-radius: 2

Per un server molto carico

anticheat:
  anti-xray:
    enabled: true
    engine-mode: 1          # Modalità più leggera
    max-block-height: 48    # Limite basso
    update-radius: 1        # Raggio minimo
    hidden-blocks:          # Elenco corto
      - diamond_ore
      - deepslate_diamond_ore
      - ancient_debris
    replacement-blocks:
      - stone

Misurare con Spark

Spark è incluso in Paper dalla 1.21. Nella console di OuiPanel scrivi questi comandi senza la barra.

/spark profiler start
# Attendi qualche minuto mentre i giocatori giocano
/spark profiler stop

Nel rapporto cerca AntiXray, ChunkSerializer per la generazione e PlayerConnection per la rete. La guida Ticks, TPS e main thread su Minecraft aiuta a leggere il rapporto.


Risoluzione dei Problemi e Problemi Comuni

I blocchi veri compaiono per un attimo

I giocatori vedono i blocchi veri per un attimo durante il caricamento dei chunk.

La causa è spesso la latenza di rete o un server sovraccarico.

Tieni update-radius a 2 e controlla la compressione di rete in server.properties.

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

Alcuni blocchi restano nascosti dopo lo scavo

Dopo aver rotto un blocco, i blocchi vicini restano mescolati.

update-radius è troppo basso, oppure un bug colpisce la tua versione di Paper.

Alza il raggio e aggiorna Paper da Gestione Versioni di OuiPanel (Aggiorna).

# Alzare il raggio di aggiornamento
update-radius: 2
# Verificare che Paper sia aggiornato
# Ultima build su papermc.io

Le prestazioni calano

TPS basso e lag al caricamento dei chunk.

Alleggerisci la configurazione e accorcia l'elenco dei blocchi.

# Ridurre il carico
engine-mode: 1
max-block-height: 48
update-radius: 1
# Accorciare l'elenco dei blocchi
hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore
  - emerald_ore
  - deepslate_emerald_ore

Alcuni blocchi non vengono nascosti

Con l'X-Ray alcuni giocatori vedono ancora certi minerali.

Il blocco manca in hidden-blocks, è esposto all'aria, sta sopra max-block-height oppure è un'entità blocco (baule, spawner), che non si può nascondere.

Controlla che tutte le varianti siano elencate.

hidden-blocks:
  - diamond_ore
  - deepslate_diamond_ore  # Non dimenticare la variante deepslate

Incompatibilità con alcuni plugin

Un plugin di protezione o di economia funziona male perché interagisce con i blocchi in modo insolito. Aggiorna il plugin o contatta lo sviluppatore. Per far vedere i blocchi veri agli amministratori durante i test, attiva il permesso di aggiramento e dai paper.antixray.bypass agli amministratori.

use-permission: true

La guida Configurare LuckPerms spiega come dare un permesso.

Comandi utili

# Vedere la versione di Paper
/version
# Scrivere plugin e dipendenze in un file di diagnostica
/paper dumpplugins
# Profilare il server
/spark profiler start
/spark profiler stop

L'anti-xray non si ricarica a caldo: dopo ogni modifica riavvia il server dalla Console › Riavvia.


Buone Pratiche

Configurazione iniziale

  • Parti dalla modalità 2 o 3 per una protezione forte.

  • Poi regola in base alle prestazioni misurate.

  • Prova con giocatori fidati che usano l'X-Ray.

Elenco di blocchi consigliato

CategoriaBlocchi
Indispensabili (tutti i server)diamond_ore, deepslate_diamond_ore, emerald_ore, deepslate_emerald_ore, ancient_debris
Consigliati (sopravvivenza)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
Specialitnt (server PvP), obsidian (basi nascoste), mossy_cobblestone (dungeon)
Impossibili da nascondereBauli, bauli trappola, bauli di Ender, barili, scatole di Shulker, tramogge, dispenser, sganciatori, spawner: sono entità blocco

Manutenzione

  • Aggiorna Paper con regolarità per avere le correzioni.

  • Controlla le prestazioni con Spark.

  • Prova dopo ogni grande aggiornamento di Minecraft, come il cambio di cartelle della 26.1.

  • Annota le modifiche in un registro delle modifiche.

Sicurezza complementare

L'anti-xray non sostituisce le altre misure:

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

  • un registro dei blocchi (CoreProtect, Prism);

  • una moderazione attiva e le segnalazioni dei giocatori;

  • il controllo regolare dei giocatori sospetti.


Risorse e Riferimenti


Hai bisogno di aiuto?

Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.

Questo articolo ti è stato utile?

1946 visualizzazioni
Condividi questo articolo
Minecraft
Hai bisogno di un server Minecraft?

Scopri le nostre offerte di hosting Minecraft a partire da 1,99€/mese con installazione automatica delle mod.

Hosting server Minecraft →

Articoli correlati