Northlight-ValheimLocationRestorer icon

ValheimLocationRestorer

Restaura masmorras, ruinas e locais abandonados com os dados originais de geracao, protege bases por bandeiras e roda em ciclos de dias.

CHANGELOG

Changelog

0.3.0 — 17/11/2026

  • Nova versão de publicação no Thunderstore (a 0.2.1 já existia com o mesmo namespace/nome/versão).
  • Nenhuma alteração de código ou de comportamento em relação à 0.2.1.
  • Servidor e clientes precisam usar a 0.3.0 juntos: a verificação de versão do Jötunn compara major.minor.

0.2.1 — 17/11/2026

  • Atualização de versão para publicação, com novo ícone e créditos no README.
  • Nenhuma alteração de comportamento do mod em relação à 0.2.0.

0.2.0 — 17/11/2026

Correções feitas contra a API real do Valheim 1.0.21 (assembly descompilado), compiladas e validadas em testes de integração num servidor dedicado (veja docs/TEST_REPORT.md). A versão sobe para 0.2.0 porque o protocolo de rede mudou: servidor e clientes administradores precisam da mesma versão.

Erros que impediam o mod de funcionar

  • Não compilava: ZoneLocation.m_hash não existe (é ZoneLocation.Hash); ZRoutedRpc.GetServerPeerID é privado; NetworkManager ambíguo com o do Jötunn; faltava a referência SoftReferenceableAssets.dll.
  • Zonas Vector2s: o jogo usa Vector2s (antes Vector2i). O catálogo lia m_locationInstances como Dictionary<Vector2i, …> e ficava sempre vazio.
  • Busca de objetos só no setor central: FindSectorObjects recebia um SimulationDistance vazio. Objetos fora do setor central não eram removidos, não entravam na checagem de duplicatas e não contavam para a proteção.
  • Catálogo vazio em mundo novo: o catálogo era montado antes de o jogo terminar de posicionar os locais. Agora espera ZoneSystem.LocationsGenerated.
  • Persistência perdida no servidor dedicado: JsonUtility gravava {} para ciclo, bandeiras, estado dos locais, histórico e diário de recuperação. Foi trocado pelo MiniJson (testado; lê os arquivos da 0.1.x).
  • Rotação original perdida após reiniciar: ao salvar o mundo, o jogo trunca a rotação dos ZDOs para 0,5° (ZPackage.WriteSmallRotation). Depois de um reinício, a masmorra era recriada ~9 cm deslocada e com outras salas, porque a seed do DungeonGenerator vem da posição. Agora a rotação de geração exata (passos de 22,5°) é recuperada do proxy (Logic/RotationMath, testado).
  • Restauração de zona descarregada com altura errada: SnapToGround mede a altura por raycast no terreno. Agora o terreno da zona é instanciado temporariamente, como na geração vanilla.

Masmorras

  • O interior agora é a zona do próprio local acima de y = 3000 (Character.InInterior). Antes era um raio em volta da entrada, a partir de 4000 m, que perdia objetos e falhava nas masmorras com interior deslocado (Mistlands). As salas são recriadas de forma determinística pelo DungeonGenerator. Os testes confirmaram os dados de salas idênticos byte a byte.
  • Captura exata de tudo o que a recriação gera (postfix em ZDOMan.CreateNewZDO), inclusive portas e objetos das salas.

Segurança e preservação

  • Exterior por substituição: um objeto antigo só é removido quando a recriação gera o gêmeo dele no mesmo lugar. Árvores e pedras naturais com o mesmo prefab do local deixaram de ser apagadas.
  • Itens soltos, lápides (componente TombStone) e prefabs desconhecidos nunca são apagados, inclusive no exterior.
  • Pedras rúnicas que revelam locais no mapa entram nas exclusões permanentes de progressão.
  • Duplicatas comparadas na horizontal (35 cm, tolerância vertical de 2,5 m; 2 m para itens soltos).
  • Recuperação: na retomada, remove o LocationProxy extra e as cópias deixadas por uma execução interrompida.

Multiplayer

  • Pedidos chegam pela conexão do próprio jogador (ZRpc). Antes vinham por ZRoutedRpc, cujo remetente pode ser forjado pelo cliente. A verificação de admin usa ZNet.IsAdmin(host).
  • Restaurar e forçar varredura sempre exigem administrador. Validate Server Permissions agora controla só a leitura.
  • Os comandos vlr list e vlr history voltam a imprimir no console. Antes a resposta ia só para o painel, mesmo fechado.

Ciclo

  • A espera pelo sono passou a valer a manhã alcançada pelo sono (EnvMan.SkipToMorning concluído). A janela de 180 s falhava quando os jogadores dormiam depois da meia-noite. O mod continua sem nunca forçar o sono.

0.1.0 — 14/11/2026

Primeira versão (não compilada nem testada no jogo).