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

Como usar este mapa

Este índice cruza os contratos públicos da revisão 0e91fef do host 0.3.1 com os projetos de implementação. Ele cobre 139 métodos da API de domínio, 17 operações do SDK original, 13 superfícies e os helpers de ciclo de vida. O link de cada método leva a código executável, entradas e teste; não é uma promessa de que qualquer combinação arbitrária de ideias é suportada.

Comece pelo resultado que quer construir, e use a tabela para localizar uma capacidade específica. Uma receita pode reunir várias chamadas porque criar, configurar, consultar e apagar fazem parte do mesmo recurso. As receitas executam apenas por clique e identificam ações destrutivas. Use uma instalação/campanha descartável.

Qual pacote preciso criar

Não existe um enum global de tipos de módulo. “Compêndio” pode significar pack mutável da campanha, catálogo instalado com um sistema ou catálogo local do operador; cada origem tem regras próprias. A montagem depende da superfície, não do nome que você deu ao módulo.

Todos os métodos de domínio

Em métodos genéricos, use api.dominio.metodo(payload, {signal, requestId}) com os campos da receita. Leituras não precisam requestId. list/get são projeções autorizadas de state. actors.sheet, dice.roll, table.search, chat.remove e outras conveniências têm assinaturas próprias demonstradas nos guias. Não confunda o nome JavaScript com a ação da fachada Python.

api.actors

api.tokens

api.maps

api.journals

api.items

api.combat

api.cards

api.audio

api.compendiums

api.chat

api.dice

api.table

Todas as operações do SDK original

Use host.call(nome,payload,{signal,onProgress}) somente com o contrato correspondente. File e Blob são objetos reais, não JSON nem caminhos locais. DTOs e expectedRevision do SDK original são diferentes de version/sheetVersion da API de domínio. Os projetos abaixo mostram essa diferença em código.

Todas as superfícies de montagem

augment acrescenta controles à interface existente. replace assume o corpo completo daquela superfície; você passa a fornecer a navegação e ações que quer oferecer. Para ficha de ator/token, o sistema completo mostra substituição funcional; para agir na ficha existente, use augment. As 13 páginas abaixo fornecem arquivos completos para experimentar cada superfície.

Helpers locais e ciclo de vida

Os eventos de domínio incluem actors.changed, tokens.changed, maps.changed, maps.layersChanged, journals.changed, items.changed, combat.changed, cards.changed, audio.changed, compendiums.changed, chat.changed, chat.message, table.presence e table.lobbyChanged. Podem agrupar invalidações e fazer leituras iniciais/reconexão; não disparam uma automação uma única vez garantida. Cada assinatura precisa ser liberada.

Map Builder e automação visual

Os quatro donos door/lever/torch/region, as conexões execution/data e os 44 node.type têm grafo completo, JSON e passos no editor. O catálogo de nós explica recursos, alvos e efeitos. Use a ação nativa de Test behavior/playtest antes de aplicar na cena. Esses grafos são documentos de desenvolvimento, não uma API browser para importar qualquer JSON nem um campo novo do manifesto.

O tutorial de cenas mostra a API pública de camadas/objetos. Criar novos kinds ou portas do editor exige contribuição ao core e seus testes; a release 0.3.1 não promete uma API de plugin para registrar tipos arbitrários de nó.

Integrações de servidor e limites da release

A integração Django mostra Context.from_request, comandos públicos, rotas autenticadas/CSRF e sinais depois do commit. As fachadas Python api.actors/tokens/maps/journals/items/combat/cards/audio/compendiums/resources/chat/dice/table/events têm assinaturas na referência. O contexto carrega IDs, sem congelar permissões; cada serviço revalida acesso. Contas, administração, instalação e campanhas são adaptadores globais da aplicação, não métodos do api entregue a uma montagem: consulte a referência de adaptadores para ferramentas do operador.

Não há maps.create ou audio.upload no SDK de domínio: os tutoriais preparam cena/arquivos pela interface nativa e usam as operações públicas disponíveis depois. Não há SQL/Python arbitrário por chamada de módulo browser, permissão de GM implícita, mudança de campanha por UUID nem bypass de conteúdo privado. system.combat aceita iniciativa declarativa. Provedores Python existentes são código confiável de servidor; não justificam distribuir um novo RPG como sistema mais Server Rules separado. Uma necessidade sem contrato deve ser apresentada como limitação, preservando a versão solicitada.

Como conferir a cobertura ao evoluir o host

Este mapa usa uma cópia versionada de frontend.json e registry.json em extension-contracts.json. Ao atualizar a documentação para outro host, compare os arquivos fonte e a revisão, atualize os projetos e execute suas receitas contra os serviços reais. Compatibilidade de nome não prova payload, permissão, efeito visual ou transação. Refaça testes de escrita e dados independentes em fixtures novas.