ValheimLocationRestorer
Restaura masmorras, ruinas e locais abandonados com os dados originais de geracao, protege bases por bandeiras e roda em ciclos de dias.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.
