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.

Changelog

1.0.14

• Fixes the README screenshot links for Thunderstore by using direct HTTPS image URLs.
• Keeps local PNG copies in the package for offline previews and distribution.

1.0.13

• Restricts the map grid to the host or an authorized administrator and keeps the control disabled for other players.
• Adds a plugin handshake before RPCs and sends state only to clients that have the mod, allowing vanilla clients to join without receiving unknown messages.
• Includes permission in the remote state so the grid can be enabled even when the client's Jötunn administrator check has not updated yet.
• Makes the remote grid use a compact snapshot of the server's zone state, keeping green/yellow colors correct without depending on the client's local ZoneSystem.
• Reapplies the point-of-interest filter after the server updates the icon list, keeping unexplored locations hidden in dedicated and singleplayer worlds.
• Sends progress messages as local chat lines, avoiding a lookup for a missing UserInfo and displaying the notice on the singleplayer host as well.
• Updates the remote modal every 5 seconds.
• Displays generation progress in chat every 30 seconds, using each connected client's selected language.
• Keeps server generation running when the player who started it leaves.
• Cancels the routine safely when the server shuts down, preserving previously saved progress.
• Re-registers RPCs when a new world or network session loads and publishes final state immediately after completion or cancellation.
• Keeps direct-connection delivery during the transition from routed RPCs between scenes.
• Prevents duplicate RPC registration when ZNet is destroyed and the menu loads, eliminating the An item with the same key has already been added error when returning to the menu.
• On menu exit, stops the routine without re-entering SaveWorld; Valheim's normal save remains responsible for the world save and no longer blocks the singleplayer loading screen.
• Explicitly answers requests from players without permission so the modal does not remain indefinitely at “Request sent to server”.
• Also uses ZNet's own administrator check and normalizes identifiers such as Steam_..., including the socket identity received during the handshake, aligning RPC authorization with the administrator status received by the client.

1.0.12

• Uses direct client-server RPC to transport modal requests and state more reliably on dedicated servers.
• Adds diagnostic messages to the server log for each request.

1.0.11

• Loads in the valheim_server.exe process as well.
• The modal on clients connected to a dedicated server queries and controls the server generator through RPC without starting generation locally.
• Fixes the version message shown in the log.

1.0.10

• Check zones now re-evaluates host/administrator permission after the server handshake, preventing it from staying disabled when the modal opens before the administration response.
• Also uses Jötunn's administrator indicator when available, without adding a required dependency to the mod.

1.0.9

• Includes the screenshots used by the README (images/worldpregen-modal.png and images/worldpregen-map-grid.png) in the package so they appear on the Thunderstore page.

1.0.0

• Reorganized the modal layout to separate the title, description, actions, progress, and messages.
• Removed grid gaps: generated zones stay green under fog and missing zones stay yellow.
• Menu and modal text follow the language selected in Valheim.
• State is bound to the world name; returning to the menu cancels the routine and clears counters before another world loads.
• Only one generation can run at a time; checking can follow an active generation.
• The icon filter and grid wait for player loading to finish so respawn is not blocked in saves with thousands of locations.

1.0.7

• Separate Cancel and Close buttons; closing the modal no longer stops generation.
• Missing zones appear yellow in the grid, including under fog, without revealing terrain.
• Points-of-interest icons remain hidden until the player explores them manually.

1.0.6

• Added the Map grid toggle to show generated and missing zones only where the minimap has already been explored.

1.0.5

• Added worldpregen start, check, status, and cancel commands for dedicated servers.
• The Cancel button stops the cascade without discarding already saved progress.
• Faster generation through limited terrain preloading, with back-pressure to keep the server responsive.

1.0.4

• Cascaded generation: small batches, a configurable pause, and retry of the same zone without flooding the terrain generator.
• Host/administrator checking is available during generation without starting a second cascade.

1.0.3

• Restored the modal background to a solid panel.
• Achievements and manual exploration continue to work; protection remains limited to ghost generation.

1.0.2

• Transparent modal, progress updates every 5 seconds, and an estimated time remaining.
• Pre-generation does not register achievement events; discoveries made by the player continue normally.
• Selects the game's font to avoid missing LiberationSans SDF warnings.

1.0.1

• Fixed zone counting on the current Valheim build: GetZoneCenter returns Vector2s, so the generator now calculates positions with the same formula as GetZonePos.

1.0.0

• First public release.
• ESC menu button with a configuration modal.
• Counts total, generated, and missing zones.
• Per-frame sliced generation using ghost zones.
• Progress bar and periodic/final saving.