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
| Aspetto | Descrizione |
|---|---|
| Prestazioni | Ottimizzato nel codice del server |
| Compatibilità | Funziona con tutti i client vanilla |
| Manutenzione | Aggiornato con Paper |
| Affidabilità | Nessuna dipendenza esterna |
| Configurazione | Regolabile 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
| Criterio | Modalità 1 | Modalità 2 | Modalità 3 |
|---|---|---|---|
| Protezione | Di base | Forte | Forte |
| CPU | Basso | Moderato | Moderato |
| Rete | Basso | Moderato | Inferiore alla modalità 2 |
| Consigliata per | Server rilassati | Server competitivi | Server 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
Nella Console, clicca su Ferma.
Apri Gestione file, poi la cartella
config, e clicca supaper-world-defaults.yml. Si apre la finestra «Modifica di paper-world-defaults.yml».Sostituisci la sezione
anticheatcon la configurazione voluta, poi clicca su Salva.Avvia il server dalla Console. Le modifiche valgono solo dopo il riavvio: non usare
/reload.

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 inreplacement-blocks: lìchestnasconde i tesori sepolti semax-block-heightviene alzato.
Impostazioni in dettaglio
| Parametro | Predefinito | Funzione |
|---|---|---|
enabled | false | Attiva o disattiva l'anti-xray |
engine-mode | 1 | Modalità 1, 2 o 3 |
max-block-height | 64 | Altezza massima in cui agisce l'anti-xray, in multipli di 16 (gli altri valori sono arrotondati per difetto) |
update-radius | 2 | Raggio dei blocchi rivelati quando un giocatore agisce: 1 o 2 (0 serve per i test) |
lava-obscures | false | Nasconde anche i blocchi che toccano la lava |
use-permission | false | Fa vedere i blocchi veri ai giocatori con paper.antixray.bypass |
hidden-blocks | elenco di minerali | Blocchi da nascondere |
replacement-blocks | stone, oak_planks, deepslate | Blocchi 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.
| Dimensione | Prima della 26.1 | Dalla 26.1 |
|---|---|---|
| Overworld | world/paper-world.yml | config/paper-world-defaults.yml (consigliato) |
| 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 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.
| Metrica | Modalità 1 | Modalità 2 | Senza anti-xray |
|---|---|---|---|
| CPU (generazione dei chunk) | +5-10 % | +15-25 % | Riferimento |
| RAM per chunk | +0,1 KB | da +0,5 a 1 KB | Riferimento |
| Banda | +2-5 % | +10-20 % | Riferimento |
| Latenza di rete | Trascurabile | +1-5 ms | Riferimento |
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
| Categoria | Blocchi |
|---|---|
| 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 |
| Speciali | tnt (server PvP), obsidian (basi nascoste), mossy_cobblestone (dungeon) |
| Impossibili da nascondere | Bauli, 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.
Scopri le nostre offerte di hosting Minecraft a partire da 1,99€/mese con installazione automatica delle mod.
Hosting server Minecraft →