Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
ValheimLocationRestorer
Restaura masmorras, ruinas e locais abandonados com os dados originais de geracao, protege bases por bandeiras e roda em ciclos de dias.
By Northlight
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_hashnão existe (éZoneLocation.Hash);ZRoutedRpc.GetServerPeerIDé privado;NetworkManagerambíguo com o do Jötunn; faltava a referênciaSoftReferenceableAssets.dll. - Zonas
Vector2s: o jogo usaVector2s(antesVector2i). O catálogo liam_locationInstancescomoDictionary<Vector2i, …>e ficava sempre vazio. - Busca de objetos só no setor central:
FindSectorObjectsrecebia umSimulationDistancevazio. 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:
JsonUtilitygravava{}para ciclo, bandeiras, estado dos locais, histórico e diário de recuperação. Foi trocado peloMiniJson(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 doDungeonGeneratorvem 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:
SnapToGroundmede 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 peloDungeonGenerator. 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 porZRoutedRpc, cujo remetente pode ser forjado pelo cliente. A verificação de admin usaZNet.IsAdmin(host). - Restaurar e forçar varredura sempre exigem administrador. Validate Server Permissions agora controla só a leitura.
- Os comandos
vlr listevlr historyvoltam 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.SkipToMorningconcluí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).