A opção entity-per-chunk-save-limit na configuração de mundo do Paper limita quantas entidades de cada tipo são salvas ou carregadas por chunk. Ela pode ajudar a conter regiões com acumulação anormal, mas não é uma otimização gratuita: atingir o limite pode significar que algumas entidades não persistem como o administrador espera. Leia a descrição e os valores da sua versão antes de alterar qualquer coisa.

O nome é importante. A configuração trabalha por tipo de entidade e por chunk. Não é um limite global de jogadores ou mobs, não define quantas entidades são atualizadas perto de cada jogador e não remove automaticamente a causa da acumulação. O comportamento exato de salvamento e carregamento deve ser conferido na referência atual do Paper e validado em cópia descartável.

Entenda o risco para os dados

Entidades podem representar mobs, itens no chão, orbes de experiência, barcos, minecarts e objetos personalizados. Se um chunk excede um limite, limitar o que será salvo ou carregado pode afetar itens de farms, animais valiosos, decoração e conteúdos criados por plugins. Não trate todos os tipos como “lixo” que pode ser descartado.

Um valor de -1 desativa o limite para tipos configurados, conforme a documentação. Limites positivos não garantem que entidades excedentes sejam destruídas da mesma forma em toda situação; não assuma sem testar. A consequência pode depender do estágio de salvamento, do tipo específico, do plugin e da versão. Por isso, faça cópia integral e valide antes de qualquer aplicação em mundo ativo.

Considere ainda outros dados relacionados. Plugins podem manter registros de entidades em banco próprio, reabrir spawners, restaurar NPCs ou criar itens de missão. Limitar salvamento do mundo enquanto um plugin mantém sua própria referência pode resultar em dados divergentes. Identifique o dono de cada entidade antes de definir o limite.

Investigue a origem da acumulação primeiro

Use ferramentas de administração e profiling para localizar chunks com excesso e descobrir por que eles acumulam. Pode ser uma farm com coleta quebrada, itens que não são recolhidos, spawners, plugin gerando entidades, uma explosão de mobs ou área mantida carregada. Um limite aplicado globalmente pode esconder a causa e causar perdas em mundos que funcionam corretamente.

Correlacione coordenadas, dimensão, tipo de entidade e horário. Observe se a carga está presente com poucos jogadores ou só em um evento. Revise plugins recentes, mudanças em spawners, regras de spawn e configurações por mundo. Antes de limpar uma região, preserve a evidência e faça cópia de mundo e bancos.

Se o problema é pontual, prefira corrigir a construção ou a configuração responsável e avaliar uma limpeza controlada daquela área. O parâmetro pode ser apropriado como proteção adicional quando há uma política clara de retenção, mas não substitui monitoramento nem capacidade de recuperação.

Encontre o arquivo e a estrutura correta

As configurações de mundo do Paper incluem padrões globais e arquivos específicos de cada mundo ou dimensão. Confirme a versão e leia a documentação correspondente, porque caminhos e estrutura podem mudar. Em instalações atuais, a configuração padrão pode estar em config/paper-world-defaults.yml, e overrides por mundo podem estar dentro dos diretórios do mundo.

Antes de editar, desligue corretamente o servidor e faça backup. Preserve comentários e indentação YAML. A lista de entidades pode exigir nomes técnicos em formato específico e pode aceitar entidades além da lista padrão, conforme documentado. Um nome inválido pode ser ignorado ou produzir erro; não copie chaves sem confirmar o esquema da versão.

Confira qual mundo é afetado e se o arquivo local herda os valores padrão. Se um override por mundo existe, a alteração global pode não se aplicar. Leia o log de inicialização por avisos de configuração e compare a estrutura gerada após um boot de teste.

Teste em staging com cópias isoladas

Duplique o servidor inteiro em um diretório de staging, incluindo todos os mundos e bancos de plugins. Isole portas e integrações para não acessar produção. Copie uma região de teste representativa ou use uma cópia descartável do mundo completo. Faça uma contagem de referência antes do teste e registre exatamente os tipos que precisam ser preservados.

Aplique um limite conservador a um único tipo e ao escopo mais restrito que a configuração permite. Inicialize, visite a região, confirme o estado dos chunks, desligue normalmente e inicie novamente. Compare entidades, itens, inventários e dados de plugin. Uma inspeção só antes do restart não é suficiente, pois a configuração trata de salvamento e carregamento.

Repita com diferentes quantidades e tipos apenas se necessário. Se qualquer entidade importante desaparece ou o resultado é incerto, reverta a cópia e consulte documentação ou autor do plugin antes de avançar. Não faça extrapolação do teste para outras dimensões sem verificar se usam configuração distinta.

Monitore consequências e comunique limites

Se a mudança for aprovada, publique o escopo: mundos, tipos, valores e finalidade. Explique à equipe que certas entidades podem deixar de persistir ao ultrapassar o limite e como solicitar revisão de uma farm ou decoração. Isso evita surpresas e ajuda a descobrir efeitos colaterais cedo.

Monitore chunks atingidos, relatórios de itens ou animais ausentes, logs de plugins e perfil de desempenho. Compare taxa de crescimento de entidades e MSPT, mas atribua o resultado ao parâmetro somente se as outras condições forem semelhantes. Não mantenha configuração se ela reduziu uma métrica sem cumprir o objetivo ou causou perdas inaceitáveis.

Defina data de revisão e responsável. Se a origem da acumulação for corrigida e não houver necessidade de limite, remova-o e valide novamente. Configuração que permanece sem motivo tende a virar dívida operacional e pode surpreender futuros administradores.

Combine o controle com prevenção e backup

Estabeleça regras para farms, itens no chão e entidades persistentes; mantenha plugins atualizados e monitore padrões incomuns. Use alertas e intervenções localizadas em vez de confiar que um teto de salvamento resolverá qualquer incidente. Ao construir uma política de retenção, decida quais entidades são descartáveis e como exceções serão tratadas.

Backups devem ser completos e restauráveis. Faça cópia consistente com servidor parado ou mecanismo suportado, inclua mundos, dimensões e bancos, e teste a recuperação em outro diretório. Guarde um snapshot imediatamente anterior à mudança. Um backup criado depois que os dados foram descartados não recupera as entidades perdidas.

O recurso é uma ferramenta de controle com possíveis efeitos em dados. Use-o quando houver diagnóstico, política explícita e teste bem-sucedido; para resolver lag, comece encontrando o trabalho real no perfil do servidor. Uma configuração que não causa perdas em staging ainda deve ser monitorada quando chega a ambientes e populações diferentes.

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.