O Anti-Xray do Paper altera os blocos enviados aos clientes para reduzir a informação que um jogador consegue obter olhando através de paredes. É uma defesa de ofuscação na transmissão; não detecta todo tipo de trapaça, não substitui a administração e não concede proteção absoluta ao mundo.
A opção fica na configuração por mundo do Paper e possui modos com efeitos e custos diferentes. Este roteiro ajuda a testar o comportamento antes de habilitar a mudança no servidor público, identificar qual arquivo governa o mundo e evitar copiar configurações obsoletas de uma versão diferente.
Confirme versão, software e objetivo
Confira que a instância executa Paper ou uma implementação que mantenha esse recurso. Anote a versão exata e abra o manual correspondente. Um nome de chave encontrado em um vídeo antigo não confirma que a estrutura de configuração permanece igual.
Defina a ameaça a reduzir. Se o objetivo é dificultar a identificação de minérios raros em regiões ainda não carregadas pelo cliente, esse é um cenário específico de ofuscação. Isso não impede que um jogador obtenha informações por outros métodos, explore regiões já conhecidas ou abuse de outro problema no servidor.
Faça o teste em uma cópia e guarde a configuração que funciona. Se o servidor já usa um plugin de proteção relacionado, entenda como esse plugin interage antes de ativar opções sobrepostas. Dois mecanismos podem alterar a transmissão sem produzir o benefício esperado e complicar o diagnóstico.
Encontre o arquivo e o escopo corretos
Paper mantém padrões por mundo em config/paper-world-defaults.yml; configurações específicas podem ficar em arquivos paper-world.yml dentro da estrutura daquele mundo. A documentação explica que esses arquivos herdam os padrões quando não existe uma substituição. Mudar o padrão pode, portanto, afetar vários mundos sem que o administrador tenha alterado cada pasta individualmente.
Faça uma cópia dos arquivos antes de editar. Pare o servidor normalmente e altere apenas as opções descritas na documentação atual de Anti-Xray. Não copie o arquivo inteiro de configuração de outra instalação: ele pode ter uma versão interna diferente ou sobrepor valores que você nunca pretendeu alterar.
Se o objetivo vale apenas para o mundo principal, confirme o nome do mundo e escolha o escopo apropriado. O Nether e o End têm conjuntos de blocos e expectativas diferentes. Não presuma que uma lista de blocos desenhada para a camada de rocha do Overworld produza o resultado desejado em todas as dimensões.
Escolha um modo de engine com base no comportamento
A configuração oficial descreve engines diferentes. Em termos práticos, os modos determinam como blocos escondidos são representados ao cliente e quais blocos podem ser substituídos ou misturados. Leia a descrição por inteiro e avalie a lista de blocos que o modo reconhece antes de habilitar.
Comece com a opção mais simples que atende ao objetivo, em um mundo de teste e com textura e configuração comuns. Confira comportamento próximo à superfície e em profundidades relevantes. Não escolha somente com base na promessa de “mais proteção”: mais trabalho de processamento ou alteração visual pode não trazer benefício proporcional para seu caso.
Se alterar listas de blocos, use identificadores válidos para a versão. Teste minérios e materiais importantes para o jogo e plugins de mineração. Uma lista que omite um minério adicionado pelo datapack ou pela versão atual não trata esse bloco. Outra que inclui blocos que não existem gera ruído e dificulta a revisão.
Aplique a mudança de forma controlada
- Pare a instância de teste e faça uma cópia dos arquivos de configuração.
- Escolha o arquivo e o escopo do mundo usando a estrutura documentada para aquela versão.
- Altere o modo e as listas exigidas pelo objetivo, sem copiar configurações irrelevantes.
- Inicie novamente e procure avisos de YAML, chave desconhecida ou configuração ignorada.
- Conecte uma conta comum e compare a percepção dos blocos em áreas de teste.
- Verifique mineração, visão e comportamento em todas as dimensões incluídas na mudança.
- Reinicie e repita a observação para confirmar que a opção persiste.
Guarde o log da inicialização antes e depois. Se a performance mudar, meça durante a tarefa real e compare uma condição parecida. Não atribua automaticamente todo aumento de MSPT à configuração sem considerar carga de jogadores, geração de chunks e plugins.
Investigue incompatibilidades de jogo
Paper pode corrigir comportamentos de Vanilla e a configuração de mundo explica diversas opções específicas. Jogadores técnicos podem notar diferenças em máquinas e mecanismos, mesmo quando a conexão e a mineração continuam funcionando. Consulte o guia de experiência Vanilla do Paper caso um dispositivo pareça se comportar de forma diferente.
Teste clientes e plugins que alteram pacotes ou visualização. Para reproduzir um relato, compare o mesmo bloco, a mesma posição e a mesma rota de acesso em uma configuração sem mudança, dentro de um ambiente restrito. Use um jogador comum, não OP, e documente a versão e os recursos visuais do cliente usados.
Se o problema só aparece em uma região, confirme se aquele mundo contém configuração própria que substitui o padrão. Restaurar um valor global pode não mudar o override existente. Mantenha a modificação específica em vez de remover todos os arquivos do mundo às cegas.
Evite conclusões erradas sobre Anti-Xray
O mecanismo não deve ser anunciado como garantia de ausência de trapaça. Ele trata de ofuscação e não impede toda fonte de informação. Mantenha regras, administração e atualizações de software como controles separados. A comunidade deve entender que uma medida técnica reduz uma oportunidade definida, sem transformar alegações de segurança em absolutos.
Não tente medir o resultado entrando com um cliente ou ferramenta maliciosa em um servidor público. Use um ambiente controlado com conta e dados descartáveis. Se uma análise de segurança exige reproduzir uma técnica exploratória, restrinja-a à instância de teste e siga as regras de divulgação do projeto responsável.
Reverta sem perder outras configurações
Se surgirem problemas, reverta somente as chaves alteradas e reinicie Paper. Compare com a cópia preservada, não com valores encontrados em outro artigo. Verifique que a entrada inválida ou o arquivo com erro foi corrigido e que outros ajustes por mundo permaneceram intactos.
Se uma mineração deixar de funcionar, não desligue o sistema em produção até confirmar a causa. Compare a versão do Paper, os plugins que modificam pacotes e a configuração do mundo. Um teste reproduzível identifica se o problema é o modo escolhido, uma lista de blocos ou um mecanismo diferente.
Libere com observação pós-mudança
Após aprovação na cópia, faça uma cópia nova do estado público e aplique a alteração numa janela curta. Confirme o início, conecte com uma conta comum e acompanhe os relatos de mineração e performance. Guarde quem alterou o arquivo, qual mundo recebeu a configuração e como retornar ao estado anterior.
Consulte a referência oficial de configuração do Anti-Xray sempre que mudar de versão. Consulte também a orientação do Paper para problemas de gameplay. As opções de versão e os valores padrão podem mudar, por isso, a configuração precisa ser conferida na instalação atual.
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.