Entenda a plataforma. Crie suas ferramentas.

Aprenda a criar módulos e sistemas

Escolha o que quer construir e siga do primeiro arquivo ao recurso funcionando na mesa.

Criar, instalar e atualizar seu primeiro módulo

Da pasta vazia ao botão na mesa, com arquivos completos, instalação, ativação e uma segunda versão.

Todas as capacidades de extensão e onde implementá-las

Mapa explícito de cada método para seu projeto, helpers, superfícies, integrações de servidor e limites da release.

Como criar um pacote de sistema original completo

Um ZIP instalável com fichas de ator/token funcionais, tipos de item, iniciativa armazenada e três packs originais.

Como criar um módulo de diário

Crie, instale e execute um módulo comum que cria diários privados e acrescenta rascunhos de sessão persistentes.

Como criar um diário do zero por um módulo

Use create pelo formulário table.interface e abra o documento privado criado.

Como criar um módulo que atua na ficha

Comece com uma pasta vazia e entregue uma ação real para renomear atores e tokens na ficha existente.

Como criar e substituir uma ficha completa de sistema

Use o pacote funcional Example Expedition, instale, crie atores e verifique tokens vinculados e independentes.

Como criar um módulo de compêndio

Monte o pacote completo a partir de pasta vazia, instale e confira seu conteúdo original.

Como incluir compêndios em um sistema

Monte o pacote completo a partir de pasta vazia, instale e confira seu conteúdo original.

Como criar um módulo de ferramentas de cena

Monte módulo que consulta camadas, edita metadados/pastas, cria uma porta nativa e transmite cena de teste.

Como criar um módulo de ferramentas de token

Coloque, mova, duplique, configure e remova tokens; controle visão, ocultação e condições com duração.

Como criar um módulo de ferramentas de combate

Crie laboratório de encontro com participantes, iniciativa, ordem, estados, turnos, rodadas e limpeza.

Como criar ferramentas de itens e inventário

Crie, organize, duplique, compartilhe e edite itens originais com revisões e permissões nativas.

Como criar ferramentas de cartas e baralhos

Crie definições reutilizáveis, compre, revele, mova, transfira e reúna cartas com posse real.

Como criar ferramentas de áudio e trilha da cena

Configure faixas nativas, playlists, fontes espaciais, vozes da cena e trilhas temporizadas com revisões corretas.

Como criar ferramentas de chat, dados e prontidão

Crie um módulo funcional para mensagens, rolagens, moderação, busca de documentos e atualização da prontidão.

Como criar automações de missões e ações de quadro

Crie e leia uma missão real, avance objetivos, atribua atores e gerencie todos os vínculos do quadro.

Como criar, sortear e restaurar tabelas de rolagem

Crie uma tabela de diário original, altere um peso preservando dados e publique sorteios nativos com ou sem reposição.

Como criar, organizar e compartilhar documentos de diário

Crie diários ricos nativos, preserve páginas ao editar, organize pastas e controle acesso e apresentações.

Criar um módulo de personagens e pastas

Criar, organizar, renomear e autorizar atores com tipos do sistema.

Salvar configurações e preferências do módulo

Implementar JSON pessoal, compartilhado e local com revisões e descarte.

Enviar e usar arquivos de módulos e campanhas

Usar File/Blob, imagens de ator, cartas, provedores nativos e downloads.

Traduzir um módulo e reagir a eventos

Ler arquivos do pacote, traduzir interface e assinar eventos sem acumular listeners.

Manter módulo que usa o SDK original host.call

DTOs concretos de ator/token, revisões opacas e os demais contratos multipart/locais.

Criar formulários Customize e janelas nativas do módulo

Formulário completo com migração, CAS, traduções, ciclo de modal e montagem em preferences.

Criar integração Django confiável e hooks de servidor

App Python completo com rotas autenticadas, alterações nativas e sinais depois do commit.

Como criar e ativar um pacote de idioma da instalação

Empacote seis textos originais, ative globalmente, escolha o idioma da conta e confira a alternativa em inglês.

Como versionar, assinar e distribuir um módulo

Prepare ZIPs imutáveis, confira registros Ed25519 e entenda instalação, ativação e revogação.

Exemplos por kind 29

Exemplos completos por kind

Escolha um contrato e vá direto ao exemplo completo, arquivos para download, resultado esperado e validação.

Módulo de navegador: resumo da campanha

Pacote completo com ação na mesa, leitura autorizada da API e modal nativo.

Pacote de sistema: ficha de personagem editável

Um sistema original em pacote único, com tipos de ator, ficha mínima completa e salvamento por revisão.

Pacote de idioma: catálogos em português e espanhol

Pacote mínimo de idioma para a instalação, com catálogos válidos, ativação e alternativa em inglês.

Pacote Django: endpoint exclusivo do proprietário

App confiável de servidor com manifesto, AppConfig, URL e leitura com verificação de permissão.

actor.directory: Contador de atores legíveis

Conte atores cujas fichas o membro atual pode abrir e atualize após mudanças de atores.

actor.sheet: Inspetor de revisão da ficha

Leia a ficha real e mostre nome, revisão da ficha e chaves dos dados abaixo da ficha nativa.

token.sheet: Inspetor de token vinculado ou independente

Leia a ficha no contexto do próprio token para não confundir um snapshot independente com dados do ator.

item.directory: Contagem de itens por tipo

Agrupe itens legíveis pelo tipo definido pelo pacote, sem presumir um catálogo de RPG.

item.sheet: Inspetor de dados do item

Mostre nome, tipo, versão e dados reais do sistema como JSON seguro abaixo do editor nativo.

scene.directory: Estado de transmissão das cenas

Diferencie a cena transmitida aos jogadores da cena em que o mestre está navegando.

scene.controls: Controle de informações da cena

Adicione um botão funcional que leia a cena da montagem e mostre dimensões e grade no modal nativo.

scene.overlay: Marcador do centro da cena

Marque o centro da cena e mantenha a posição correta ao mover e ampliar, sem capturar o ponteiro.

chat.log: Estatísticas do chat visível

Conte apenas mensagens retornadas pelo histórico autorizado e informe seus autores visíveis.

combat.tracker: Resumo do turno atual

Mostre atividade do encontro, rodada e combatente atual visível, sem implementar regras de iniciativa.

journal.sheet: Estrutura do diário

Mostre título, tipo e apenas títulos das seções na projeção autorizada do diário.

preferences: Preferência pessoal persistente de densidade

Salve uma preferência pessoal compacta/confortável com revisão compare-and-swap e mostre conflitos entre abas.

table.interface: Busca de documentos autorizados

Busque documentos da mesa em um painel e mostre nomes, kinds e trechos como texto.

Busca: os 7 kinds e o filtro vazio

Oito funções concretas, categorias de missão/diário, recentes autorizados e validação.

Imagens de ator: portrait e token

Duas funções completas de montagem com seletor File e a operação multipart real de host.call.

Entradas de compêndio: os cinco kinds

Capture actor, item, journal, scene e deck com leitura autorizada e importação pelo GM.

Packs de compêndio: 3 tipos instalados e 7 locais

JSON original completo por tipo de pack, restrições reais do manifesto e arquivos de exemplo.

Exemplos de Blueprint para cada kind de objeto

Escolha uma receita completa de door, lever, torch ou region e confira conexões execution/data e os 44 tipos de nó.

Blueprint kind door: abrir, fechar e preservar a trava

Grafo v2 completo: abre a porta fechada, fecha a porta aberta e mantém uma porta trancada.

Blueprint kind lever: interruptor de dois estados e Empty Object

Alternância off/on completa e uso do mesmo kind em um controlador privado sem imagem.

Blueprint kind torch: girar o mecanismo e controlar a chama

Tocha composta com ações independentes de estado e chama nos dois ramos de alternância.

Blueprint kind region: placa de pressão com primeiro/último ocupante

Grafos completos de entrada e saída: abrem uma porta na primeira chegada e fecham na última saída.

Kinds de conexão: execution e data, um grafo completo

Acompanhe um grafo de alavanca que consulta estado por dados tipados e executa ações por conexões ordenadas.

Os 44 tipos de nó de Blueprint, com exemplos completos

Configuração concreta e grafo validado para download de cada NODE_TYPES, de event a cooldown.

Referência do projeto 19

Primeiros passos

Instalação, pré-requisitos, primeira execução e preparação do código-fonte.

Arquitetura

Camadas de execução, serviços de domínio, permissões e persistência.

Mapa do código

Encontre os arquivos e o domínio responsáveis por cada fluxo da aplicação.

Desenvolvimento

Fluxo de desenvolvimento, migrações, contratos gerados e preparação de releases.

Referência da API pública

API Python, API de domínio do navegador, operações do SDK, payloads e erros.

Sistemas e módulos

Pacotes instaláveis, declaração de sistemas, ciclo do navegador, assinatura e contratos do SDK.

Arquitetura do frontend

Jinja2, Datastar, JavaScript nativo, PixiJS, estilos e preparação de assets.

Testes

Django, node:test, Playwright e validação nativa com dados descartáveis.

Configuração

Configuração local à instalação, perfis de execução e variáveis de ambiente.

Implantação

Hospedagem, segurança, proxies reversos, backups e recuperação operacional.

Instalador e Runner no Windows

Preparação nativa no Windows, ferramentas portáteis, execução e recuperação.

Instalador e Runner no Linux

Preparação nativa no Linux, ferramentas portáteis, dependências e limites da plataforma.

Instalador e Runner no macOS

Preparação nativa no macOS, ferramentas portáteis, execução e plataformas suportadas.

Referência do Map Builder

Fluxos do Builder, Smart Objects, automação, limites suportados e contratos de desenvolvimento.

Importação e exportação Universal VTT

Fluxos de importação e exportação, coordenadas, limites e autorização.

Referência dos fluxos da aplicação

Guia completo do projeto para preparar campanhas e usar as ferramentas da mesa.

Portabilidade ética de módulos

Licenças, direitos sobre conteúdo e integração com os domínios responsáveis.

Contribuição

Convenções de contribuição, licenciamento, revisão e validação.