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.

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.