Quando chunks aparecem devagar no Paper, “lag de chunk” pode significar três problemas diferentes: terreno ainda está sendo gerado, dados existentes estão lentos para ler ou o servidor envia chunks ao jogador em ritmo limitado. O diagnóstico fica mais claro ao comparar região nova e conhecida, observar o perfil enquanto ocorre e conferir o limite player-max-chunk-send-rate na configuração global.

Esse parâmetro limita quantos chunks por segundo são enviados a cada jogador. Ele não aumenta view distance, não gera terreno e não acelera disco. Antes de ajustá-lo, descubra qual etapa está atrasada.

Reproduza o caso com dados conhecidos

Escolha rota segura em mundo de teste: uma região já explorada e uma região que ainda não foi gerada. Repita o mesmo movimento, velocidade e teleporte. Registre versão do cliente, Paper, plugins, população e coordenadas. Se só terreno novo demora, investigue worldgen; se mapa conhecido também demora, leitura ou envio pode estar envolvido.

Compare entrar no spawn, teletransportar para região carregada, teleportar para região antiga descarregada e viajar para terreno novo. Cada ação aciona caminhos diferentes. Mantenha mesma distância de view e mesma instância para que variáveis não confundam resultado.

Peça a mais de um usuário para testar. Um cliente com render distance baixo ou computador sem recursos pode mostrar atraso visual mesmo quando dados já chegaram. Compare outro cliente padrão e rede externa.

Use spark durante o sintoma

Paper inclui spark e recomenda capturar perfil enquanto problema acontece. Observe tempo gasto em geração, carregamento, compressão, envio, plugins e thread principal. Não use perfil capturado depois que chunks foram carregados; cache pode esconder a causa.

Registre MSPT, CPU por núcleo, memória, GC, latência de disco, bytes de rede e chunk rate. Se disk wait domina, reduzir send rate não remove leitura. Se worldgen domina, geração prévia pode ajudar mais. Se envio domina, compare limite, view distance e banda.

Preserve link de perfil e logs com acesso restrito. Remova nome e IP de jogadores antes de compartilhar. Um relatório completo ajuda mantenedores a distinguir server thread de cliente ou rede.

Separe geração de leitura de disco

Geração cria terreno novo e pode demandar CPU e gravação. Leitura abre região existente e pode ser limitada por disco, cache ou descompressão. Compare mapas de idade diferente e veja se existe pico de geração no perfil.

Se geração é lenta, avalie pré-gerar mapa numa janela ou cópia, mas monitore CPU, disco e espaço. Se leitura é lenta, verifique saúde e latência do storage, concorrência de backup e volume montado.

Não copie regiões enquanto o Paper escreve sem snapshot consistente. Para comparar, desligue corretamente ou use cópia suportada e execute instâncias em diretórios separados.

Verifique taxa de envio e distâncias

Consulte `player-max-chunk-send-rate` na documentação global. O valor -1 desativa o limite conforme referência atual. Alterar pode afetar tempo para o cliente receber a área, mas mais taxa pode pressionar banda ou CPU. Meça com jogadores reais e cenários representativos.

view-distance define quantidade máxima de terreno enviado, enquanto simulation-distance afeta entidades em ticking. Paper pode definir limites e valores por mundo ou propriedade. Confira todas as fontes e overrides; uma mudança em arquivo pode não ser o valor efetivo.

Faça staging, altere uma opção por vez e compare tempo de spawn, tempo de teleport, MSPT e bytes por jogador. Teste conexões modestas, porque a média de datacenter não representa o cliente final.

Investigue proxy, cliente e plugins

Em Velocity, o proxy recebe tráfego público e encaminha aos backends. Compare latência cliente-proxy e proxy-backend. Firewalls, compression e rede entre máquinas podem ser parte do atraso. Teste troca de servidor e Geyser se a rede aceita Bedrock.

Plugins de teleport, mapa, proteção e instâncias podem pedir chunks de forma síncrona ou carregar regiões de modo especial. Reproduza sem integração suspeita apenas em staging. Atualize plugins e reporte chamada bloqueante ao autor.

Cliente pode renderizar lento mesmo após receber chunk. Teste launcher sem mods, memória disponível, render distance e conexão. Não recomende apagar dados do usuário sem instrução e backup.

Plano de otimização com reversão

Defina meta: reduzir tempo p95 de chunk num cenário documentado, sem ultrapassar MSPT e banda. Faça backup, altere somente o subsistema identificado e monitore por janela de pico. Guarde valores e perfil antes/depois.

Se mudança piorar latência, restaurar valor anterior deve ser imediato. Não combine taxa de envio, view distance, worker threads, compression e formato de região numa única atualização. Testes separados revelam qual camada precisa de solução.

Se nenhum ajuste de Paper muda o resultado, corrija storage ou rede do host e consulte provedor. Um limite por jogador não pode compensar disco lento, perda de pacotes ou CPU saturada por worldgen.

Comunique uma falha útil

Para suporte, envie versão, coordenadas aproximadas, cenário, hora e se a região é nova. Anexe log e perfil sanitizados, sem seed ou dados pessoais se não forem necessários. Evidência reproduzível acelera a triagem.

Após corrigir, monitore em horário normal e de pico. Registre o resultado e repita o teste depois de atualizar Paper, plugin de teleporte ou hardware. O mesmo sintoma pode mudar de causa ao longo do tempo.

Verifique disco e backups concorrentes

Jobs de backup podem ler muitos arquivos enquanto jogadores exploram. Compare latência durante e fora da janela de backup, e veja se snapshots usam IO do mesmo volume. Agende cópia pesada fora de pico ou use storage separado quando a infraestrutura permitir.

Confira espaço livre, inode/quota quando aplicável e mensagens do sistema sobre volume. Disco quase cheio ou throttling do provedor pode piorar leitura e gravação. Não execute benchmark que sobrescreva dados de produção para medir velocidade.

Se a compressão de região mudou recentemente, compare CPU de descompressão e suporte das ferramentas. Restaure formato anterior somente com dados e backup compatíveis, pois trocar propriedade não converte automaticamente arquivos já escritos.

Verifique geradores e datapacks

Datapacks, world generators e plugins podem mudar custo de chunks novos. Faça cópia com mesma seed, versão, datapacks e plugins e compare geração. Um mundo limpo sem geradores customizados não representa produção.

Se geração é lenta, pré-gerar áreas de exploração planejadas pode reduzir surpresa, mas aumenta armazenamento e precisa de planejamento de fronteira. Monitore o processo e mantenha backup antes de gerar grande volume.

Após atualizar datapack, teste dimensões e biomas. Chunk de região nova pode usar gerador diferente dos arquivos antigos, então registre versão e seed e documente a transição.

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.