Campaign Codex

Resumo

Confirmado: Campaign Codex amplia, em vez de substituir, o sistema de Journals do Foundry VTT. O módulo fornece cinco tipos de folhas, vínculos entre conteúdos e ferramentas de organização; suas entradas podem se relacionar com cenas, Actors e Items.

Uso relevante para Yan

Ɖ o repositório de lore estruturado dentro de mundos do Foundry. No fluxo de criação de NPC, a ficha mecĆ¢nica e os assets pertencem ao Actor; a entrada de Campaign Codex concentra biografias, conexƵes e apresentação de campanha. NĆ£o tratar um Journal comum como equivalente: a folha do Codex lĆŖ dados das flags do módulo.

Schema e cuidados operacionais

Confirmado localmente em Arquitetura e Fluxos:

  • conteĆŗdo principal lido pela folha: flags.campaign-codex.data.description e flags.campaign-codex.data.notes;
  • imagem de capa/card: flags.campaign-codex.image;
  • escrever apenas pĆ”ginas de JournalEntry nĆ£o preenche a folha do Codex;
  • usar <section class="secret">...</section> para conteĆŗdo secreto conforme a convenção operacional registrada;
  • após qualquer escrita, reler o documento pela rota aprovada e validar conteĆŗdo, ownership, pasta e renderização. NĆ£o editar o banco do Foundry diretamente.

Mapeamento reportado de relaƧƵes — 2026-09-30

Relato operacional — nĆ£o verificado diretamente nesta curadoria: uma inspeção declarada do código e de mundos apontou que flags.core.sheetClass seleciona as folhas campaign-codex.NPCSheet, LocationSheet, TagSheet e QuestSheet, enquanto flags["campaign-codex"].type identificaria npc, location, region, shop, group, tag ou quest.

O relato atribui os seguintes campos a flags["campaign-codex"].data:

  • NPC: linkedActor, description, notes, tags, linkedLocations, associates, linkedShops, inventory e tagMode;
  • Location: description, notes, parentRegion, linkedScene, linkedNPCs e linkedShops;
  • Tag/facção: description, notes, linkedNPCs, members e linkedGroups;
  • Quest: description, notes e quests, cujos cartƵes conteriam id, title, status, objectives, urgency e boardColumn.

Os tipos concretos, a direção dos UUIDs, a semântica de members e a compatibilidade por versão continuam pendentes de reprodução no módulo efetivamente instalado. Não usar este mapeamento como contrato de escrita antes dessa validação.

PermissƵes e sigilo

A marcação de segredo não é, por si só, prova de que o conteúdo foi excluído do cliente de jogadores. Qualquer integração precisa validar permissões e entrega de dados com uma conta não-GM antes de ser considerada segura.

Macros incluĆ­dos — inventĆ”rio reportado em 2026-10-05

Relato operacional — nĆ£o verificado diretamente nesta curadoria: uma inspeção declarada do compĆŖndio campaign-codex.macros reportou 22 macros, agrupadas em quatro categorias. A disponibilidade, os nomes completos e o comportamento variam conforme a versĆ£o instalada; antes de executar, abrir o Macro Compendium no mundo de teste e revisar o script.

  • Importadores Markdown → Campaign Codex: MD to CC - Experimental Dialog e D&D5e MD to CC - Experimental receberiam um arquivo Markdown, reconheceriam cabeƧalhos e referĆŖncias e criariam uma hierarquia de entradas/pastas do Codex. SĆ£o candidatos para acelerar a conversĆ£o de prep textual, mas exigem uma cópia de teste: importação em massa pode criar ou alterar Journals.
  • Parsers Watabou/Donjon: os macros relatados para One Page Dungeon, Village, Medieval City, Cave SVG, Neighbourhood, Perilous Shores e Donjon receberiam exportaƧƵes dos geradores e construiriam cenas e conteĆŗdo correlato. HĆ” confirmação pĆŗblica especĆ­fica de um parser de cavernas Watabou que importa um SVG como cena com paredes; os demais comportamentos permanecem relato atĆ© reprodução local.
  • Uso para o fluxo do Yan: esses grupos sĆ£o potencialmente Ćŗteis somente para prep novo e experimental. NĆ£o apontar as macros para worlds de produção sem backup/export e inspeção posterior de cenas, paredes, portas, Journals, permissƵes e links do Codex.

Escopo de execução

Macros de importação e de geração de cena têm efeito de escrita no world. Testar em world descartÔvel, com arquivos de entrada copiados e um plano de reversão; não presumir idempotência nem compatibilidade entre sistemas.

Integração com QuickWiki

QuickWiki deve consumir entidades e pastas do Campaign Codex somente para leitura, preservando as flags e os metadados do módulo. A API, a versão efetivamente instalada e o modelo de permissões devem ser confirmados antes de tornar esse conector uma dependência.

QuestƵes em aberto

  • Quais campos e relaƧƵes especĆ­ficos estĆ£o presentes na versĆ£o instalada em cada world.
  • Quais tipos de folha sĆ£o usados em cada campanha e como cada um persiste seus links.
  • Se o conteĆŗdo secreto Ć© efetivamente filtrado antes do trĆ”fego/DOM de jogadores.

Fontes

  • Confirmado: Campaign Codex v13 README, repositório do projeto, consultado em 2026-09-30.
  • Confirmado: Campaign Codex no Foundry VTT, Foundry Virtual Tabletop, consultado em 2026-09-30.
  • Confirmado localmente: Arquitetura e Fluxos §7.4, consultado em 2026-09-30.
  • Relato operacional: evento e935c9d1da77dffda8f3783a do lote de captura de 2026-09-30; registra a intenção de mapear o schema e o pipeline de NPCs, mas nĆ£o comprova sua execução.
  • Relato operacional: evento 8c15551079b3380ca84694ea do lote de captura de 2026-09-30; reporta uma inspeção de código/mundos e o mapeamento de campos acima. NĆ£o foi reproduzida diretamente nesta curadoria.
  • Relato operacional: evento 3c0c870ab2443bf6409cb81c do lote de captura de 2026-10-05. Registra uma anĆ”lise declarada do compĆŖndio campaign-codex.macros, incluindo importadores Markdown e parsers Watabou/Donjon; o código, o compĆŖndio e o world citados nĆ£o foram acessĆ­veis nesta curadoria.
  • Confirmação pĆŗblica parcial: Watabou Cave Parser - Campaign Codex, publicação do autor no Reddit, encontrada em 2026-10-05. Descreve a importação de SVG de Watabou como cena com paredes; nĆ£o confirma o restante do inventĆ”rio.