Lovemaps Dungeons

Resumo

Confirmado: Lovemaps Dungeons, de Damien, publica mapas para VTT identificados como OotDL e destinados a locais de Odyssey of the Dragonlords. As páginas dos packs afirmam que os mapas não incluem regras nem conteúdo de aventura e requerem o livro oficial para jogar.

Uso relevante em Thylea

É uma fonte externa a considerar para preparação visual da campanha Heroes of Thylea, especialmente para:

• The Ultros;
• Island of the Fates;
• The Necropolis e Tomb of Xander;
• Sour Vintage, Boar Cave e encontros;
• The Great Games;
• Charybdis, the Ravening Mouth.

Adquirir e usar os arquivos somente pelos canais autorizados pelo criador, respeitando a licença aplicável ao pack.

Implementação local registrada

Em 2026-09-16, um registro operacional informou a criação do módulo local Lovemaps-Dungeons-Odyssey para Foundry VTT v13, consolidando os packs OotDL numerados de 047 a 076 em compêndios de cenas organizados por capítulo e local.

O registro relata remapeamento de referências de assets para o diretório do módulo e validação de integridade dos caminhos. A ativação no Foundry e o carregamento das cenas permanecem sujeitos ao teste manual no mundo de destino; não há aqui confirmação independente de execução em mesa.

Instalação local para teste

Relato operacional (2026-09-17; sem verificação independente no vault): a versão consolidada foi instalada para teste local em C:\\Users\\Yanbd\\foundry-data\\v13-dungeon-archive\\Data\\modules\\yan-curated-lovemaps-odyssey (renomeada do identificador preliminar lovemaps-dungeons-odyssey para alinhar com o padrão de módulos curados por criador: yan-curated-lovemaps-odyssey). O inventário declarado é de 126 mapas em alta resolução, 92 miniaturas e 92 cenas distribuídas em seis packs de compêndio: capítulos 1, 2, 3, 5, 6 e 7.

O mesmo relato registra a atualização do module.json, das flags e dos scripts internos atualizar-assets.mjs e integrar-novo-mapa.mjs para o novo identificador. Teriam sido reescritas 125 referências de assets (background.src, thumb e texture.src) nos packs; a inspeção declarada de 12.907 documentos não encontrou referências residuais a modules/lovemaps-dungeons-odyssey/. O README.md e esta documentação de referência também foram informados como sincronizados. Esses resultados permanecem evidência operacional declarada até uma inspeção direta da cópia local.

O registro também informa que os packs preservam pastas nativas de compêndio para localizar cenas por masmorra ou região. A validação funcional pendente deve ser feita em cópia de mundo de teste no Foundry VTT v13: habilitar o módulo e abrir ao menos uma cena de cada pack, confirmando que background.src, miniaturas e tiles resolvem pelo CDN e que o carregamento não bloqueia o cliente.

Organização declarada do manifesto e dos assets

Relato operacional (2026-09-17; sem verificação independente no vault): o module.json da instalação de teste foi estruturado a partir do padrão observado no módulo de produção Cze & Peku. Ele declara uma pasta raiz via packFolders e seis compêndios de cenas, organizados por capítulo; cada compêndio preserva subpastas internas por masmorra ou região. O relato informa 30 subpastas no total.

Migração concluída para R2/CDN

Relato operacional (2026-09-17; sem verificação independente no vault): a migração para o prefixo lovemaps/ do bucket Cloudflare R2 foi concluída com rclone. O registro declara 218 objetos enviados — 126 mapas em alta resolução e 92 miniaturas, totalizando 200,56 MB — e resposta HTTP 200 OK no CDN público https://assets.yanbraga.com/lovemaps/ para caminhos de mapas e miniaturas.

O mesmo registro declara que scripts/atualizar-assets.mjs atualizou 125 referências de assets nos seis packs LevelDB, substituindo o prefixo local modules/yan-curated-lovemaps-odyssey/ por https://assets.yanbraga.com/lovemaps/. A auditoria relatada não encontrou referências locais remanescentes. Após isso, as pastas locais maps/ e assets/ foram removidas e o módulo teria passado de aproximadamente 206 MB para 5,49 MB.

A migração substitui o plano anterior de upload e limpeza. Ainda falta a validação funcional no Foundry: em uma cópia de mundo de teste, abrir ao menos uma cena de cada um dos seis packs e conferir background.src, thumb, texture.src, tiles e carregamento no cliente. Para operações genéricas de R2 com rclone, consultar o guia de R2 e rclone.

Confirmado (documentação do Foundry): o schema de módulos v13 inclui os campos packs e packFolders; o manifesto module.json define o conteúdo incluído pelo módulo. A documentação confirma a disponibilidade desses mecanismos, mas não valida esta configuração específica nem os scripts relatados.

Incidente de desempenho e organização dos packs

Relato operacional (2026-09-16): no mundo heroes-of-thylea, o compêndio inicial monolítico teria concentrado cerca de 13 mil registros de cenas, paredes e fontes de luz. O carregamento inicial reportado chegou a 37.212 ms, acompanhado de crescimento do payload de dados do mundo; o registro também apontou um cache do módulo swipe-vtt com 9,7 MB.

Como correção relatada, Lovemaps-Dungeons-Odyssey foi dividido em seis packs de compêndio por capítulo: Ch. 1 (The Heroes of Mytros), Ch. 2 (The Labor of the Gods), Ch. 3 (The City of Mytros), Ch. 5 (The Cerulean Gulf), Ch. 6 (The Sunken Kingdom) e Ch. 7 (The Nether Sea & Praxys). A decisão operacional é evitar a indexação de um pack único muito grande no login e carregar os conjuntos de cenas por capítulo conforme a necessidade.

Essas medições e a implantação foram reportadas no atendimento, mas não foram verificadas de forma independente neste vault. Antes da próxima sessão, confirmar no mundo afetado o tempo de abertura, os logs do servidor e a disponibilidade das cenas de cada pack; não excluir o pack antigo nem alterar o cache de swipe-vtt sem backup e teste reproduzível.

Auditoria complementar de payload do mundo

Relato operacional (2026-09-16; ainda sem verificação independente): uma auditoria posterior do mundo Heroes of Thylea reportou cerca de 32 MB de JSON bruto transmitido no carregamento de cada cliente. Os maiores volumes informados foram:

• monks-player-settings: 13,3 MB em dados de usuários, distribuídos entre perfis de GM;
• swipe-vtt.actorCache: 10,6 MB nas configurações do mundo;
• regras de autorreconhecimento de autoanimations: 4,5 MB nas configurações do mundo;
• histórico de chat: 3,7 MB em 3.476 mensagens.

Trate os números como diagnóstico inicial, não como fato confirmado. A ordem de investigação registrada é: fazer backup do mundo, medir novamente o login e o tamanho dos documentos, limpar ou redefinir apenas caches/históricos dispensáveis em uma cópia de teste, e então repetir a medição. Não desativar módulos de produção nem apagar o chat sem confirmar a necessidade funcional e a recuperação possível.

Resolução posterior relatada

Relato operacional (2026-09-16; sem verificação independente no vault): uma intervenção posterior no mundo ativo atribuiu um bloqueio de entrada de um perfil de GM a aproximadamente 6,7 MB de client-settings armazenados nas flags de usuário pelo monks-player-settings. O atendimento informou a limpeza das flags de dois perfis de GM, reduzindo o documento afetado para cerca de 8 KB, e a desativação de monks-player-settings e swipe-vtt para impedir a recriação dos volumes de dados.

O módulo Lovemaps-Dungeons-Odyssey teria permanecido ativo com os seis packs por capítulo. Como a ação e o retorno de desempenho não foram confirmados por leitura independente do mundo, manter os módulos desativados e os dados removidos como estado relatado; antes de uma sessão, testar a entrada de GM e jogador, confirmar a disponibilidade das cenas e preservar backup recuperável.

Estado após reinício relatado

Relato operacional (2026-09-16; sem verificação independente no vault): após o reinício do Foundry, o mundo heroes-of-thylea foi informado como online em Foundry VTT v13.351, com D&D5e 5.3.3. O compêndio Lovemaps-Dungeons-Odyssey.lovemaps-maps teria carregado 92 cenas em 36 pastas.

Esse é um inventário pontual declarado pelo atendimento, não uma medição reproduzida. Antes de usar em sessão, abrir o mundo como GM, conferir a contagem e a importação de uma cena de cada pack, e confirmar que o login de jogador continua funcional.

Desativação temporária posterior

Relato operacional (2026-09-16; sem verificação independente no vault): em uma ação posterior, o módulo Lovemaps-Dungeons-Odyssey foi desativado na configuração do mundo ativo, a pedido do responsável pela mesa. Esta informação substitui o estado anteriormente relatado de módulo ativo; a desativação foi solicitada como temporária.

Antes de reativá-lo, confirmar que o login de GM e jogadores está estável e testar a abertura de uma cena de cada pack em cópia recuperável do mundo.

Migração de documentos em teste local

Relato operacional (2026-09-17; sem verificação independente no vault): em uma instalação isolada de teste com Foundry VTT v13.351, a lentidão de abertura com somente este módulo habilitado foi atribuída à migração dos documentos embutidos dos packs. O atendimento reportou que 12.907 registros — 92 cenas, 30 pastas, 12.290 paredes, 292 fontes de luz e 33 tiles — receberam metadados _stats com coreVersion: "13.351"; também foi removida do module.json a declaração de sistema dnd5e considerada desnecessária para packs de cenas.

Confirmado (documentação do Foundry): documentos primários usam _stats para metadados de auditoria, migração e compatibilidade, incluindo coreVersion, systemId e systemVersion. A documentação não confirma o diagnóstico, as contagens nem o ganho de desempenho deste módulo específico; portanto, a atribuição causal e a alegação de que todas as migrações foram evitadas permanecem como relato operacional.

Antes de promover os packs alterados, manter backup dos bancos originais e medir uma inicialização a frio no mundo de teste. Registrar tempo até a tela de mundo, mensagens de migração no log e abertura de ao menos uma cena por pack; só então comparar com a cópia anterior. Não aplicar a alteração diretamente ao mundo de produção sem teste reproduzível.

Falha de validação de _stats reportada

Relato operacional (2026-09-17; sem verificação independente no vault): após o mundo de teste abrir normalmente em modo seguro e voltar a permanecer em carregamento contínuo ao habilitar Lovemaps-Dungeons-Odyssey, o console teria registrado DataModelValidationError para uma Folder: _stats.lastModifiedBy não atendia ao formato de ID alfanumérico de 16 caracteres. O relatório atribui o valor inválido à cadeia hermes e informa sua substituição por null nos documentos do módulo, seguida de auditoria que não encontrou outros erros de validação nos seis packs.

Confirmado (documentação do Foundry): o schema dos documentos v13 inclui o campo _stats como DocumentStatsField. A documentação consultada não confirma o valor, a auditoria, a causa do bloqueio nem o resultado da correção desta cópia local; trate-os como hipótese operacional até repetir a abertura a frio em mundo de teste.

Confirmação operacional posterior (2026-09-17): após a correção, o responsável confirmou que a instalação de teste está funcionando perfeitamente. Isso confirma o resultado prático relatado para esta cópia local, mas não substitui o procedimento de backup e teste reproduzível antes de qualquer promoção ao mundo de produção.

Para reproduzir com segurança: preservar uma cópia dos bancos de compêndio, habilitar somente o módulo no mundo de teste, registrar o erro completo do console e confirmar que a inicialização conclui. Em seguida, abrir uma cena de cada pack e conferir walls, lights, tiles, miniaturas e background.src. Não promover a alteração para o mundo de produção apenas pela ausência de erro no auditor.

Padrão de consolidação a reutilizar

Relato operacional (2026-09-17; sem verificação independente no vault): a análise do módulo de produção Cze & Peku para Foundry v13 apontou uma alternativa à consolidação monolítica: manter packs de cenas granulares, preservar os assets fora dos bancos de compêndio e reescrever as referências de cada cena para o caminho consolidado do módulo. A tentativa anterior de unir grandes coleções de cenas em poucos bancos foi relatada como inadequada para o carregamento do Foundry.

Para futuras revisões do módulo Lovemaps, conservar a divisão por capítulo/local já adotada, tratar cada pack como unidade de teste e não introduzir um pack global de cenas. Antes de qualquer conversão, trabalhar sobre cópia dos módulos de origem; validar module.json, referências de background.src, miniaturas, tiles e abertura de ao menos uma cena de cada pack em mundo de teste. Esta é uma decisão operacional baseada no caso Cze & Peku, não uma conclusão de desempenho medida independentemente para Lovemaps.

Confirmado (documentação do Foundry): módulos podem incluir conteúdo de compêndio na pasta packs, e cada pack corresponde a uma coleção própria de documentos. A documentação sustenta a organização em packs, mas não estabelece um tamanho máximo nem comprova que a granularidade resolve este caso específico.

Rastreabilidade de versão e repositório

Relato operacional (2026-09-17; sem verificação independente no vault): uma iteração posterior do módulo yan-curated-lovemaps-odyssey declarou a versão 1.1.0, a inicialização de repositório Git local e o commit 623ec04 (refactor: padronizacao yan-curated-lovemaps-odyssey e migracao CDN (v1.1.0)). O registro também informa a inclusão de histórico de versões no README.

A decisão operacional para cada nova iteração de módulos Foundry é: elevar a versão de modo coerente no module.json e README, registrar mudanças no changelog, testar em cópia de mundo, e criar commit Git local com mensagem descritiva. O commit só deve incluir alterações verificadas e não pode conter credenciais, tokens, URLs privadas ou dados de produção.

Status da evidência: versão, hash, conteúdo do commit e atualização de documentação acima são relato operacional do lote de captura. Antes de promover o módulo, inspecionar diretamente o repositório, o manifesto, README/changelog e a cópia de teste.

Limitações e cuidados

• Os packs são recursos visuais; não substituem o livro oficial da aventura.
• Antes de importá-los no Foundry, conferir a licença, a resolução e a grade; manter os arquivos de assets versionados conforme a convenção do mundo.
• Esta nota não registra nem recomenda fontes não autorizadas de material protegido.

Fontes

• Foundry Virtual Tabletop — Introduction to Module Development, consultado em 2026-09-17.
• Foundry Virtual Tabletop — API Documentation v13: Module, consultado em 2026-09-17.
• Foundry Virtual Tabletop — API Documentation v13: CompendiumCollection, consultado em 2026-09-17.
• Foundry Virtual Tabletop — API Documentation v13: Scene (_stats), consultado em 2026-09-17.
• Foundry Virtual Tabletop — API Migration Guides, consultado em 2026-09-17.
• Evidência local: registros operacionais de atendimento sobre o módulo Lovemaps-Dungeons-Odyssey, sua instalação local de teste e o incidente de login no mundo Heroes of Thylea, 2026-09-16–2026-09-17; medições, implantação e retorno de desempenho ainda sem verificação independente no vault.
• Evidência local: lote de captura de conhecimento de 2026-09-17, evento d3d3361f2bce1056ab373a2b. Registra a decisão de versionar, manter changelog, testar e realizar commit Git por iteração; versões e hash mencionados são relatos operacionais até inspeção direta do repositório.
• Lovemaps Dungeons — Patreon, consultado em 2026-09-11.
• 059-OotDL-Ultros — Lovemaps Dungeons, consultado em 2026-09-11.
• 071-OotDL-Island of the Fates — Lovemaps Dungeons, consultado em 2026-09-11.
• 047-OotDL-Sour Vintage/Boar Cave/Encounters — Lovemaps Dungeons, consultado em 2026-09-11.