A configuração global player-max-chunk-send-rate limita quantos chunks por segundo o servidor envia a cada jogador. A referência do Paper informa valor padrão de 75 e -1 para desativar o limite. Esse controle afeta o ritmo de envio ao cliente; não aumenta a distância de visão, não acelera geração de terreno e não corrige falhas de rede sozinho.

Um limite menor pode suavizar picos de envio e reduzir rajadas para um jogador, mas também pode prolongar a tela de carregamento ao entrar ou se teleportar. O valor deve ser avaliado com a população, view distance, CPU, banda e comportamento de chunk loading.

Separe envio, geração e simulação

O servidor pode precisar gerar um chunk novo antes de enviá-lo, ler um chunk existente do disco e então transmitir dados ao cliente. `player-max-chunk-send-rate` controla a etapa de envio por pessoa. Se geração ou IO são lentos, reduzir ou aumentar taxa de transmissão não resolve a causa.

view-distance define área de dados oferecida ao cliente; simulation-distance controla área de simulação. Uma taxa de envio por segundo pode mudar velocidade com que chunks chegam dentro dessa área, mas não o tamanho dela nem quais entidades são tickadas.

Se jogador relata chunks pretos ao voar ou teleportar, identifique se terreno ainda não foi gerado, se o disco demora ou se cliente recebe pacotes lentamente. Compare mundo novo e antigo, movimento rápido e entrada parada. Capture perfil enquanto ocorre.

Quando limitar o envio pode ajudar

Se a banda ou a taxa de processamento de clientes se torna problema, limitar envio pode distribuir carga ao longo do tempo. Eventos de teleporte, voo rápido ou entrada em regiões extensas podem gerar rajadas. Um limite pode tornar a transmissão mais gradual e previsível, dependendo da rota e da conexão.

Em redes com clientes em dispositivos modestos, envio gradual pode melhorar experiência de renderização; porém o cliente também pode precisar dos chunks para jogar. Em PVP ou minigame competitivo, carregar lentamente pode esconder visão, impedir movimento ou desvantajar quem usa conexão limitada.

Não use ajuste para mascarar falta de banda do host ou rede instável. Se a capacidade é insuficiente, reduzir transmissão para todos pode diminuir qualidade; investigue datacenter, proxy, limites e picos de recurso.

Meça a experiência por jogador

Teste com clientes em conexões e dispositivos distintos. Meça tempo até spawn visível, chunk load durante teleporte, taxa de dados e desconexões. Agrupe jogadores em um lobby e espalhados em regiões diferentes; o número por pessoa não revela sozinho a carga agregada.

Compare valores um por vez e repita mesma sequência: conectar, caminhar, voar em modo de teste e trocar de mundo. Registre view distance e população, porque ambos afetam quantos chunks podem aguardar envio. Faça em staging com dados equivalentes.

Defina critério de sucesso antes do teste: redução de pico sem aumento excessivo do tempo de carregamento, ou melhora de estabilidade sem prejuízo de visibilidade. Se há apenas uma melhora para um caso e regressão para outros, considere configuração de mundo ou modos diferentes, se a opção puder ser escopada.

Confira a configuração global correta

Paper configura esse parâmetro em config/paper-global.yml segundo a referência atual. Confirme versão e arquivo ativo. Valores globais podem afetar todos os mundos e jogadores; não copie chave de `paper.yml` antigo sem guia de migração.

Faça backup, preserve YAML e altere uma linha. Reinicie de forma controlada se necessário. Leia log por erros e verifique o arquivo depois do boot para saber se painel ou script substituiu o valor.

Considere overrides e propriedades de JVM que definam limites de view distance. Uma configuração que “não funciona” pode ser recortada ou outra opção estar dominando a experiência. Documente todos os valores relacionados.

Teste compatibilidade com proxy e plugins

Em Velocity, o proxy pode também controlar ou influenciar o fluxo de cliente e troca entre servidores. Teste entrada pública, backend, transferência e fallback. Não abra acesso direto aos backends durante teste; mantenha forwarding e firewall seguros.

Plugins de teleportes, mapas e minigames podem pedir carregamento rápido ou enviar jogadores para regiões distantes. Simule fluxos reais e verifique se a taxa provoca timeout ou chunk faltando. Atualize plugins se eles usarem API incompatível com versão.

Teste versões de cliente, Geyser e plugins de protocolo que a rede suporta. Em cross-play, entrada e percepção podem diferir; colete feedback de ambas as plataformas.

Promova com rollback pronto

Anote valor anterior e faça cópia de paper-global.yml. Aplique em janela, confirme status do Paper e observe MSPT, chunks enviados, uso de rede e experiência. Mantenha logs e um comando de reversão disponível para responsável.

Se o acesso ao spawn piora, o chunk rate aumenta latência percebida ou o perfil não melhora, reverta. Não combine a alteração com novo view-distance ou worker-thread count na mesma rodada. Múltiplas mudanças ocultam qual fator produziu resultado.

Reavalie após update do Paper, expansão de slots ou mudança de proxy e link. Taxa apropriada depende da capacidade e do jogo, não de um número mágico.

Comunique efeitos aos jogadores

Se a mudança altera tempo de carregamento, informe a comunidade e explique como reportar região e momento em que chunks falham. Evite instruções que mandem desligar recursos do cliente ou repetir teleporte até abrir o mapa.

Atendimento deve pedir versão do cliente, modo de conexão, coordenadas aproximadas e se a falha é reproduzível, sem solicitar credenciais. Uma boa coleta de evidência distingue rede, geração e envio sem culpar o usuário.

Documente decisão junto às métricas e revise em eventos de pico. Esse histórico ajuda a manter uma experiência consistente para quem joga no celular, computador simples ou conexão rápida.

Distinga cliente lento de envio do servidor

O jogador pode receber chunks, mas renderizá-los devagar por CPU, GPU, memória ou mods. Pergunte se outros jogadores no mesmo ponto observam a mesma falha e compare conexão local e externa. Evite diagnosticar rede do Paper a partir de uma captura isolada do cliente.

Verifique se o problema acompanha uma conta ou dispositivo em vários mundos. Se somente um cliente falha, teste versão limpa suportada; se todos falham ao entrar em uma área, examine geração, disco e plugins daquela dimensão.

Não peça para usuários apagarem arquivos de mundo do cliente sem instrução específica e backup. Limpar cache pode forçar mais download e aumentar a carga; só faça quando evidência indicar cache local corrompido.

Defina metas de experiência

Para lobby, estabeleça tempo máximo até o spawn e telas básicas estarem disponíveis. Para survival, defina expectativa durante teleporte e exploração. Metas diferentes podem justificar políticas distintas, mas devem ser testadas e explicadas.

Considere acessibilidade e segurança competitiva: terrain que chega atrasado pode ocultar perigos, impedir movimento ou mostrar oponente tarde demais. Reproduza em modo de jogo real e não somente em espaço vazio.

Inclua players com conexões modestas no rollout. Se o limite é global, um ajuste baseado apenas em banda de datacenter pode piorar experiência de celular e rede doméstica, então use feedback junto a telemetria.

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.