World Pre-Generator

Pré-gere as zonas do mundo de Valheim antes de explorá-las. O mod usa o caminho de zona fantasma do jogo e trabalha em lotes controlados, permitindo preparar o mundo enquanto o host acompanha o progresso.

Benefícios

• reduz as pausas e os picos de processamento causados pela geração durante a exploração;
• deixa o terreno, locais e estruturas prontos antes da chegada dos jogadores;
• mantém a exploração do mapa e as conquistas vinculadas à exploração manual;
• salva o progresso em intervalos configuráveis, permitindo continuar uma geração interrompida;
• oferece verificação independente, estimativa de tempo e cancelamento seguro;
• vincula a rotina ao nome do mundo ativo e cancela automaticamente ao voltar ao menu;
• permite somente uma geração por vez; a verificação pode acompanhar uma geração em andamento;
• permite visualizar no mapa M quais zonas já foram geradas, sem revelar o terreno oculto;
• funciona em mundo local, host multiplayer e servidor dedicado.

Capturas de tela

Modal de configuração, verificação, geração e cancelamento da pré-geração.

A grade mostra o estado das zonas sem revelar o terreno oculto: verde indica zona gerada e amarelo indica zona faltante.

Instalação

1. Instale o BepInExPack Valheim.
2. Extraia o conteúdo deste ZIP para a pasta do Valheim.
3. Confirme que o arquivo está em BepInEx/plugins/WorldPreGenerator/WorldPreGenerator.dll.
4. Inicie o jogo pelo seu gerenciador de mods.

O Configuration Manager é opcional. Quando instalado, ele mostra as opções do mod dentro do jogo.

Como usar no jogo

1. Entre no mundo como jogador local, host ou administrador.
2. Abra o menu de pausa com ESC e selecione Pré-gerar mundo.
3. Marque Mundo completo ou desmarque-o e informe um raio em metros.
4. Clique em Verificar zonas para atualizar os totais de zonas geradas e faltantes.
5. Clique em Gerar zonas faltantes para iniciar a cascata.
6. A barra, os contadores e o tempo estimado são atualizados a cada 5 segundos.
7. Use Fechar para ocultar o modal e deixar a geração continuar. Use Cancelar para interromper a geração e salvar o progresso já concluído.

O host pode verificar as zonas enquanto uma geração está em andamento. A verificação não inicia uma segunda geração.

Ao sair do mundo, a rotina é cancelada antes da troca de cena e o progresso já salvo é preservado. Ao entrar em outro mundo, os contadores e o estado do modal começam limpos; use Verificar zonas para ler o estado daquele save.

Grade do mapa

Ative Grade no mapa no modal e abra o mapa com M:

• verde: zona já gerada;
• amarelo: zona ainda faltante;
• a transparência é reduzida sob a névoa para preservar o mapa não explorado;
• a grade mostra somente o estado de geração e não chama a exploração do mapa;
• ícones de pontos de interesse permanecem ocultos até que a área seja explorada manualmente quando HideUnexploredLocationIcons está ativado.

Servidor dedicado

Os comandos são restritos ao console do servidor e a administradores:

worldpregen start full       inicia a geração do mundo completo
worldpregen start <raio>     inicia a geração dentro do raio em metros
worldpregen check full       verifica o mundo completo
worldpregen check <raio>     verifica as zonas dentro do raio
worldpregen status            mostra estado, contadores, falhas e ETA
worldpregen cancel            cancela a geração e preserva o progresso salvo

Também estão disponíveis os aliases worldpregen_start, worldpregen_check, worldpregen_status e worldpregen_cancel.

Configuração

Arquivo: BepInEx/config/com.kimbauer.valheim.worldpregen.cfg

• Interface.ShowMenuButton: mostra ou remove o botão do menu ESC;
• Interface.ShowChunkGrid: ativa a grade do mapa ao abrir o mundo;
• Interface.HideUnexploredLocationIcons: oculta ícones de locais até a exploração manual;
• Generation.DefaultRadius: raio inicial quando Mundo completo está desmarcado;
• Generation.MaxMillisecondsPerFrame: limite de trabalho por quadro; reduza para priorizar estabilidade;
• Generation.SaveEveryZones: salva a cada quantidade de zonas concluídas; 0 salva somente ao terminar;
• Generation.ZonesPerBatch: quantidade de zonas processadas por lote;
• Generation.MaxConcurrentZoneRequests: limite de terrenos aguardando processamento;
• Generation.BatchPauseSeconds: pausa entre lotes para manter o jogo responsivo.

Recomendações

Faça uma cópia de segurança do mundo antes de uma geração longa. Um mundo completo pode conter dezenas de milhares de zonas, levar horas e usar bastante CPU, memória, disco e espaço adicional no arquivo de save. A geração deve ser feita depois de instalar todos os mods que alteram terreno, locais ou zonas.

A criação final das zonas continua na thread principal do Unity para preservar a integridade dos objetos do jogo. O pré-carregamento limitado e os lotes configuráveis reduzem a pressão sobre o gerador, mas não eliminam o custo total de gerar o mundo.

Compatibilidade

Compatível com a versão atual do Valheim e do BepInExPack Valheim. Os textos do menu e do modal acompanham o idioma selecionado no Valheim.