O Paper inclui Anti-Xray baseado em obfuscation e configurável por mundo. Os três modos substituem ou reorganizam blocos enviados ao cliente de formas distintas, trocando custo de processamento, proteção contra leitura de minérios e tamanho/compactação dos pacotes. Escolha conforme exploração, hardware e tolerância da comunidade; nenhum modo impede todo método de descobrir recursos.

A configuração vive em paper-world-defaults.yml e pode receber overrides em paper-world.yml. Mudanças exigem reinício completo; `/reload` não aplica Anti-Xray corretamente segundo o guia oficial.

Compare os modos

Engine mode 1 substitui blocos selecionados por blocos de aparência apropriada à dimensão, como stone/deepslate, netherrack ou end stone. É menos pesado para cliente do que mode 2, mas blocos expostos a ar ou água e certas situações podem revelar minério real.

Mode 2 troca blocos escondidos e blocos de substituição por blocos aleatórios da lista. Isso tende a esconder melhor, com maior custo de processamento e possível impacto nos clientes. Mode 3 aplica aleatoriedade por camada vertical do chunk; o guia do Paper aponta possível redução de carga de rede no join e benefício à compressão do pacote em certos cenários.

Esses efeitos dependem do cliente, da lista, versão e dimensão. Teste ferramenta de mineração em mundo de staging e compare desempenho. Não considere nenhum modo infalível: seed conhecida ou reversível pode permitir prever geração, e blocos expostos ao ar têm limitações.

Escolha blocos e altura por dimensão

Liste minérios e variantes deepslate que existem na versão, além de blocos de substituição compatíveis com terreno. Nether e End têm necessidades diferentes da Overworld. Cofres e entidades de bloco têm restrições; o Paper alerta que tile entities não devem ser usadas como substitutos falsos em certos modos.

max-block-height determina a altura máxima onde Anti-Xray opera e aceita múltiplos de 16, com arredondamento para baixo segundo referência. Ajuste após entender distribuição vertical de recursos na versão e dimensão. Valor baixo pode deixar áreas sem proteção; alto pode aumentar trabalho desnecessário.

Em mode 1, blocos expostos ao ar não podem ser ocultados da mesma maneira. Em mode 2/3, incluir ar em hidden-blocks pode ajudar a obstruir minérios, mas pode causar queda de FPS para alguns clientes. Avalie acessibilidade e experiência de jogadores com máquinas simples.

Configure por mundo com cuidado

Ative na configuração padrão para os mundos que não têm override e use arquivo específico para Nether ou dimensão customizada quando necessário. Paper documenta que arquivos por mundo herdam padrões e não precisam copiar todo o arquivo. Adicione somente bloco de configuração relevante e mantenha YAML válido.

Confirme o mundo ativo e que a configuração não é herdada de uma pasta antiga. Depois de reiniciar, inspecione log e comportamento. Uma alteração em defaults não substitui override manual, então revise ambos.

Se `use-permission` estiver ativo, operadores e usuários com `paper.antixray.bypass` podem ver comportamento diferente. Teste com conta comum e administrativa para evitar falso diagnóstico. Não conceda bypass a equipe que joga competitivamente sem política transparente.

Meça custo para servidores e clientes

Compare MSPT, CPU, pacote de chunk, uso de rede e FPS do cliente em área semelhante antes e depois. Teste entrar numa região já explorada e gerar chunks novos. Use spark enquanto carga ocorre e inclua clientes modestos no teste.

Mode 1 tende a menor custo de cliente; modos 2 e 3 podem fornecer ocultação diferente e alterar compressão. O custo real depende de dimensão, view distance, quantidade de jogadores e largura de banda. Não aplique escolha de servidor grande sem validar no seu host.

Se desempenho piora, reduza escopo ou volte à configuração anterior. Não compense baixando todas as distâncias sem entender o impacto na jogabilidade. Proteção justa precisa manter interação aceitável e não transformar mineração em stutter.

Entenda limites e bypass

Obfuscation protege dados que o cliente recebe; não substitui anticheat, controle de acesso nem segredo da seed. Jogador com seed pode prever minério em geração determinística. Paper sugere dificultar reversão usando feature seeds e opções de sementes de estruturas, sem prometer solução completa.

O Anti-Xray não cobre ores expostos ao ar e áreas acima de max-block-height. Configuração desatualizada pode esquecer minérios novos ou variantes deepslate. Revise lista depois de update do Minecraft.

Anticheat pode ajudar contra extensão de alcance e outros bypasses. Escolha plugin confiável, configure sem falsos positivos e teste junto. Nenhuma extensão elimina necessidade de moderação, logs e revisão de denúncias.

Implante com reinício e teste

Faça backup dos arquivos, altere somente a seção Anti-Xray e programe reinício. Não use `/reload`. Após boot, teste com contas autorizadas e ferramenta conhecida em staging; verifique altura, blocos e dimensão. Compare cliente com Xray e cliente normal sem publicar método de abuso no servidor.

Monitore FPS, MSPT, pacote, denúncias e desempenho de mineração. Se há erro de YAML, restaure cópia e corrija indentação. Mantenha changelog de modo, altura, hidden/replacement blocks e overrides.

Comunique que servidor usa proteção e como reportar falha. Não forneça lista pública de bypasses ou detalhes de seed. Ao pedir suporte, envie configuração sanitizada, versão e perfil spark relevante, removendo informação sensível.

Atualize e revise as listas

Depois de cada versão Minecraft, confirme blocos de minério e substitutos para Overworld, Nether e dimensões customizadas. O Paper pode atualizar defaults, mas overrides copiados manualmente envelhecem. Compare com recomendação oficial, faça backup e teste novamente.

Revise se a comunidade prefere proteção mais forte ou menor custo. Modos podem ter trade-offs visuais. Documente decisão com experiência observada e não apenas com o número de engine mode.

O Anti-Xray faz parte de defesa em camadas. Configuração por dimensão, listas completas, height, ausência de bypass indevido e testes periódicos produzem resultado mais confiável que ativar uma chave sem validar.

Teste mundos existentes e recém-gerados

Alterações de configuração afetam como chunks são enviados, não reescrevem automaticamente o mundo em disco. Teste uma área antiga e outra recém-gerada. Se o comportamento difere, confira cache de cliente, chunk já carregado, dimensão e momento do reinício.

Após mudar listas, peça ao cliente de teste sair e entrar novamente na região para forçar envio de chunk atualizado. Não use reload. Reinicie Paper e valide logs para garantir que novo bloco foi lido.

Monitore também uso de banda, porque obfuscation pode mudar tamanho e compressão de pacotes. Se login ficou lento, compare taxa de chunks, view distance e perfil antes de desabilitar proteção inteira.

Prepare os administradores

Documente como ativar bypass para debugging somente em ambiente controlado. Operadores podem ter bypass implícito conforme opção. Pessoas que jogam competitivamente não devem receber acesso que revele blocos ocultos sem política pública.

Treine suporte para perguntar dimensão, coordenada vertical e lista de bloco que não foi escondido. Esses dados ajudam a verificar max-block-height, exposição ao ar ou lista desatualizada sem compartilhar ferramenta de cheat.

Se pedir ajuda à comunidade técnica, publique configuração sanitizada e perfil de desempenho sem seed ou dados privados. Remova nomes e IPs; mantenha evidência completa apenas no canal interno.

Preserve compatibilidade com mapas e construtores

Anti-Xray modifica blocos enviados ao cliente e pode afetar mapas de aventura, plugins de mineração e ferramentas que dependem de leitura de bloco do cliente. Teste minigames, resource packs e modos de espectador que usam visualização de minérios ou blocos especiais.

Se um mapa exige mostrar bloco oculto para todos, analise modo e permissões com o construtor. Desativar globalmente em produção pode abrir vantagem de mineração. Prefira mundo separado ou exceção cuidadosamente delimitada se a configuração permitir.

Teste cliente Java e qualquer plugin de protocolo suportado. Interpretação visual pode variar com textura ou mod de Xray, então a validação deve incluir cliente padrão e a política de moderação.

Tenha plano para falso positivo de desempenho

Queda de FPS após ativar mode 2 ou incluir ar em hidden-blocks pode ocorrer em certos clientes. Colete modelo de máquina, área e altura sem solicitar dados desnecessários. Compare mode 1 e configuração recomendada em staging.

Se cliente tem queda severa, ofereça orientação ou ajuste menos custoso sem remover toda proteção. Documente trade-off e mantenha fairness em modos competitivos. Uma alteração de emergência precisa ter responsável e data para revisão.

Reveja relatos depois de cada evento de mineração. Se há queixas de ore exposto, confirme se está acima do limite, em contato com ar ou fora da lista. Esse diagnóstico preciso evita elevar custo sem corrigir causa.

Fontes e referências

Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.