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
| Last updated | a day ago |
| Total downloads | 11 |
| Total rating | 0 |
| Categories | Tools Server-side Client-side World Generation AI Generated |
| Dependency string | Northlight-ValheimLocationRestorer-0.3.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2360README
Valheim Location Restorer 0.3.0
Restaura e reinicializa locais gerados naturalmente pelo mundo de Valheim — masmorras, ruínas, cabanas, acampamentos, fortificações, monumentos e estruturas costeiras — manualmente ou em ciclos automáticos, preservando construções de jogadores, respeitando áreas protegidas por bandeiras e com o servidor no controle em multiplayer.
Versão 0.3.0 (mesmo código da 0.2.0/0.2.1). Compilada contra o Valheim 1.0.21, BepInEx 5.4.23 e Jötunn 2.30.2. A restauração, a proteção e a recuperação foram testadas num servidor dedicado com mundos descartáveis (
docs/TEST_REPORT.md). Ainda não testadas: o painel F8 num cliente e o multiplayer com clientes conectados. Faça backup do mundo e teste antes numa cópia.
Requisitos
| Dependência | Versão de referência |
|---|---|
| Valheim | 1.0.21 (testado) |
| BepInExPack_Valheim (denikson) | 5.4.2360 |
| Jötunn (ValheimModding-Jotunn) | 2.30.2 |
| BepInEx Configuration Manager | opcional (só a interface F1) |
Instale no servidor e nos clientes administradores. Jogadores sem o mod conseguem entrar e recebem os avisos na tela (mensagem nativa do jogo), mas não têm o painel.
Instalação
- Instale o BepInExPack_Valheim e o Jötunn (r2modman/Thunderstore ou manual).
- Copie
ValheimLocationRestorer.dllparaBepInEx/plugins/Braian-ValheimLocationRestorer/. - Inicie o jogo/servidor uma vez para gerar
BepInEx/config/Braian.ValheimLocationRestorer.cfg. - Ajuste as opções (arquivo ou F1). Referência completa:
docs/CONFIGURATION.md.
Compilar
- Instale o .NET SDK 8 ou superior (compila
net472via Microsoft.NET.Sdk). - Copie
Environment.props.exampleparaEnvironment.propse ajusteVALHEIM_INSTALL,BEPINEX_PATHeJOTUNN_DLL. dotnet build -c Release(ou./build.ps1). ComDEPLOY_PATHdefinido, a DLL é copiada para o BepInEx automaticamente.- Testes da lógica pura:
dotnet test tests/ValheimLocationRestorer.Tests. - Pacote Thunderstore:
./package-thunderstore.ps1(gera o zip empackage/build/). - Testes no jogo (servidor dedicado, perfil isolado, mundos novos):
./run-integration-tests.ps1. Nada é copiado para a pasta do jogo.
Caminhos longos: se o projeto estiver numa pasta com caminho muito longo (mais de 260 caracteres somando
obj\...), o compilador pode falhar sem mensagem. Use uma pasta curta ousubst X: <pasta>.
Como funciona
Restauração com dados originais
Cada local gerado tem no mundo um objeto de rede LocationProxy com o hash do local, a seed e a rotação de geração. O mod usa exatamente esses dados para chamar a rotina do próprio jogo (ZoneSystem.SpawnLocation). Se esses dados não existirem, o local não é restaurado e aparece como "Sem dados originais" — o mod nunca faz uma reconstrução aproximada.
Sequência de uma restauração:
- Validação com dados frescos: exclusão de boss, bandeiras, objetos de jogadores, jogadores presentes, servidor ocupado, intervalo mínimo, categoria e modo habilitados.
- O prefab do local é carregado antes de tocar no mundo. Se falhar, nada é alterado.
- No interior (a zona do local acima de y = 3000, onde o
DungeonGeneratormonta as salas) todo o conteúdo gerado é removido em lotes, assim como as criaturas dos spawners do local. - O local é recriado com a seed e a rotação originais, pela mesma rotina da geração do jogo. As salas da masmorra saem idênticas, porque a seed delas vem da seed do mundo e da posição. Numa zona descarregada, o terreno é carregado temporariamente para os objetos assentarem no chão como na geração original.
- No exterior, cada objeto antigo só é substituído quando a recriação gera o gêmeo dele (mesmo prefab, mesmo lugar). Vegetação natural com o mesmo prefab não é apagada. Objetos recriados fora do plano, o LocationProxy novo e qualquer objeto recriado igual a um que ficou são descartados. Assim nada é duplicado.
- O novo estado vira a referência do local, entra no histórico e o diário de recuperação é limpo.
Modos
| Modo | O que faz |
|---|---|
| A — Completa | Recria tudo (exterior e interior) |
| B — Estrutural | Só estruturas e portas; baús, criaturas e recursos são preservados |
| C — Masmorra | Só o interior da masmorra: layout de salas, portas, inimigos, baús, recursos |
| D — Personalizada | Você escolhe as classes (estruturas, portas, baús, criaturas, recursos, layout, outros) e as regiões (exterior/interior) |
O que nunca é tocado
- Bosses (regra permanente no código): pedras de invocação, altares, locais de invocação e progressão (Eikthyr, The Elder, Bonemass, Moder, Yagluth, The Queen, Fader, StartTemple, Vegvisirs). O mod verifica por nome e por componente (
OfferingBowl,BossStone,Vegvisir,ItemStandcom poder de guardião), então locais renomeados ou de outros mods também são pegos. Mercadores e locais de missão (Haldor, Hildir, Bog Witch) também ficam de fora. - Objetos de jogadores: qualquer coisa com criador (peças, baús, portais, navios), animais domesticados, lápides e itens soltos dentro de masmorras. Com Protect Player Buildings ligado (padrão), um local com qualquer um desses objetos é ignorado inteiro.
- Áreas de bandeira: qualquer bandeira do jogo colocada por um jogador protege um raio de 50 m. Se o local encostar no círculo, ele é excluído inteiro: o teste usa a área ocupada pelo local (o raio declarado ou o objeto mais distante, o que for maior), não só o centro. Masmorras são protegidas também pelo interior.
- Locais não classificados (ex.: meteoritos, ninhos) nunca são restaurados automaticamente.
Ciclo automático (padrão)
- Dia 1: início do ciclo.
- Dias 2 a 8: funcionamento normal.
- Dia 9: aviso a todos os jogadores conectados.
- Dia 10: depois da virada do dia causada pelo sono, a restauração começa.
- Dia 11: começa o próximo ciclo.
O mod nunca força o sono. Se ninguém dormir, ele espera a próxima virada válida. Locais com jogadores dentro (masmorras sempre) são adiados e tentados de novo a cada 60 s. Um mesmo local nunca é restaurado duas vezes no mesmo ciclo. Por padrão, a restauração automática só mexe em locais alterados desde a última verificação.
Uso
Painel (F8, somente administradores): lista por categoria, ordenada pela distância até você, com nome, bioma, coordenadas, distância, estado e proteção. Ver marca o local no mapa. Restaurar abre a escolha do modo e depois Confirmar. Também há a aba Histórico.
Console (F5):
vlr status
vlr list [Dungeons|Ruins|...|all] [página] [free] [texto]
vlr view <id>
vlr restore <id> [complete|structural|dungeon|custom:structures+doors[:exterior|interior|both]] [force]
vlr history [página]
vlr rescan [id|all]
vlr banners
vlr ui
Restaurar e rescan exigem estar no adminlist.txt do servidor, verificado pela conexão do jogador, que não pode ser forjada. force ignora só o intervalo mínimo por local e nunca as regras de segurança.
Arquivos que o mod cria (no servidor)
BepInEx/config/Braian.ValheimLocationRestorer.cfg
BepInEx/config/Braian.ValheimLocationRestorer.categories.txt (regras de categoria opcionais)
BepInEx/config/Braian.ValheimLocationRestorer/worlds/<mundo>_<uid>/
state.json ciclo, bandeiras registradas, referências por local
history.json histórico de operações
journal.json diário de recuperação da operação em andamento
Todas as gravações são atômicas e mantêm um .bak.
Limitações conhecidas
Veja docs/IMPLEMENTATION_REPORT.md (seção Limitações). As principais:
- Alterações de terreno (escavação/aplainamento) não são revertidas.
- A detecção de "local alterado" usa uma impressão digital dos objetos. Criaturas não entram nela, então matar inimigos de uma masmorra sem mexer em baús, portas ou estruturas não a marca como alterada. Use o modo manual ou desligue Only Restore Modified Locations.
- Sem os dados originais (
LocationProxy), o local não é restaurado.
Faça backup do mundo antes de usar. O Valheim guarda backups em worlds_local.
Dependências e créditos
Este mod requer as seguintes dependências, declaradas no manifest.json e instaladas pelo gerenciador de mods:
- BepInExPack Valheim — framework de plugins.
- Jötunn — biblioteca de modding para Valheim.
Créditos: BepInEx, Jötunn e equipe NorthLight.