O Chunky gera antecipadamente os chunks do teu mundo. Normalmente, o servidor só calcula cada chunk quando um jogador entra nele pela primeira vez; é exatamente esse o processo mais pesado que um servidor Minecraft conhece. Com um mundo pré-gerado, isso deixa de acontecer, e jogadores que voam para longe ou viajam com Elytra já não fazem o servidor engasgar. Este guia mostra como definir uma área, iniciar a geração e o que acontece com o espaço em disco e o desempenho. As capturas de tela vêm de um servidor de teste com Paper 1.21.4 e Chunky 1.4.40.

Instalação

O Chunky existe como plugin para Paper e Spigot e como mod para Fabric, NeoForge e Forge. No painel, encontras em Plugins → Browser; na página do plugin também há o assistente do Chunky, que inicia a geração e mostra o progresso. Os comandos precisam da permissão chunky.command; ela deve ficar no grupo de moderação.

Definir a área e iniciar

A geração acontece em quatro passos:

/chunky world mundo
/chunky shape square
/chunky center 4000 4000
/chunky radius 128
/chunky start

world escolhe o mundo (padrão: o mundo em que estás). shape define a forma; square é a habitual, circle economiza os cantos. center é o ponto central, radius é a distância em blocos até a borda. O Chunky confirma cada configuração no chat e, ao iniciar, informa mundo, forma, centro e raio.

Saída do Chunky: seleção definida, tarefa iniciada, sem outras tarefas
Saída do Chunky: seleção definida, tarefa iniciada, sem outras tarefas

Se o mundo tiver uma world border, /chunky worldborder usa-a diretamente como área. É o jeito mais limpo, porque os jogadores de qualquer forma não conseguem passar dela.

Qual deve ser o tamanho da área?

Calcula pela área. Um raio de 128 blocos resulta em 256 × 256 blocos, ou seja, 16 × 16 chunks, 256 chunks. Um raio de 5000 blocos já são 390.625 chunks. No disco, um chunk gerado ocupa aproximadamente 10 a 30 KB, dependendo do terreno; 5000 blocos de raio significam, portanto, vários gigabytes. Antes de iniciar, verifica no painel o espaço livre do teu servidor.

Para um servidor com cinco a dez jogadores, normalmente basta um raio de 2000 a 3000 blocos. O Nether precisa de um oitavo disso, porque oito blocos do Overworld correspondem a um bloco do Nether.

Pré-gerar depois um mundo já jogado

O Chunky gera apenas chunks que ainda não estão no disco. Por isso, podes completar a pré-geração de um mundo onde já se jogou a qualquer momento: áreas já visitadas são ignoradas, o progresso avança rápido no início e fica mais lento quando começa o terreno desconhecido.

O importante é a ordem quando crias uma nova world border: primeiro define a borda, depois usa /chunky worldborder e só então /chunky start. Caso contrário, vais gerar chunks que ficam atrás da borda e não serão acessados — eles ocupam espaço sem trazer benefício. Overworld, Nether e End são mundos separados e cada um precisa da sua própria execução com /chunky world.

Durante a geração

O Chunky trabalha dando prioridade aos jogadores: se alguém entrar no servidor, a geração fica mais lenta. Mesmo assim, vale a pena deixar áreas grandes rodarem à noite ou quando o servidor estiver vazio. Comandos úteis:

  • /chunky progress mostra o progresso, chunks por segundo e o tempo restante.
  • /chunky pause pausa, /chunky continue continua, também depois de uma reinicialização.
  • /chunky cancel cancela; os chunks já gerados permanecem.

A velocidade depende da CPU. Um núcleo consegue aproximadamente 20 a 60 chunks por segundo; um raio de 3000 blocos leva assim uma a duas horas.

Erros típicos

  • Servidor cheio. A geração para quando o disco fica cheio, e o servidor já não consegue salvar. Verifica antes o espaço e cria um backup.
  • Mundo errado. O comando usou o mundo em que estavas. Define o nome com /chunky world.
  • Geração perdida após reiniciar. O Chunky guarda a tarefa; /chunky continue continua-a. Só cancel a apaga.
  • Área pequena demais. O Chunky não gera nada fora da área; jogadores que viajarem mais longe voltarão a acionar o carregamento normal de chunks.

FAQ

Quanto tempo demora a pré-geração?

Conta com 20 a 60 chunks por segundo e por núcleo. Um raio de 3000 blocos fica assim entre uma e duas horas, 5000 blocos em várias horas. /chunky progress mostra os chunks por segundo e o tempo restante estimado para o teu servidor concreto.

O servidor precisa estar vazio durante a pré-geração?

Não. O Chunky dá prioridade aos jogadores e fica mais lento assim que alguém está online. Para áreas grandes, ainda assim vale a pena escolher uma janela com o servidor vazio, porque a execução termina muito mais rápido.

De quanto espaço em disco preciso?

Um chunk gerado ocupa aproximadamente 10 a 30 KB, dependendo do terreno. Um raio de 2000 blocos são cerca de 62.500 chunks, ou seja, aproximadamente 0,6 a 1,9 GB. Verifica o espaço livre no painel antes de começar — se o disco ficar cheio, o servidor já não consegue salvar.

Preciso pré-gerar o Nether e o End separadamente?

Sim, cada dimensão é um mundo próprio e precisa da sua própria execução com /chunky world. Para o Nether, basta um oitavo do raio do Overworld, porque um bloco do Nether corresponde a oito blocos do Overworld.

O progresso perde-se numa reinicialização?

Não. O Chunky salva a tarefa em andamento; depois da reinicialização, /chunky continue continua-a. Só /chunky cancel descarta a tarefa — os chunks já gerados permanecem preservados.

Guias relacionados

Se o carregamento de chunks é mesmo a causa dos travamentos, vê em spark: analisar lag. A world border e outros valores básicos são explicados em configurar server.properties.

Fontes

Chunky: ver exemplo

Gravações próprias de um ambiente de demonstração. A versão e a configuração mostradas podem diferir do teu servidor.

  1. A mesma rota ilustra o antes e o depois. A segunda passagem também pode beneficiar da cache; não é uma medição geral de desempenho.
A mesma rota: à esquerda sem pré-geração, à direita após. Demonstração individual num M1 Pro, não é um teste do servidor.
A mesma rota: à esquerda sem pré-geração, à direita após. Demonstração individual num M1 Pro, não é um teste do servidor.

Minecraft-Demo · 2026-09-25

Para este exemplo, o raio foi definido em 128 blocos.
Para este exemplo, o raio foi definido em 128 blocos.

1.4.40