InícioDocs para devsComo criar e substituir uma ficha completa de sistema
Tutoriais de implementação 3 min de leitura

Como criar e substituir uma ficha completa de sistema

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

A ficha original Example Expedition salvou Stamina 17 pela API do contexto. Gravewright 0.3.0, interface em inglês.
A ficha original Example Expedition salvou Stamina 17 pela API do contexto. Gravewright 0.3.0, interface em inglês. · Abrir captura completa ↗

Comece pelo pacote completo do sistema

O pacote Example Expedition contém uma ficha original completa de personagem/NPC, com campo de vigor validado, manifesto, estilos e licença. Baixe esse pacote em vez de copiar só uma chamada de registro. Siga os arquivos completos e as instruções de ZIP do guia. O alvo é o Gravewright 0.3.0, sem catálogo de RPG.

Instale e crie uma campanha

  1. Como dono, abra Sistemas, Instalar sistema, Instalar por ZIP e escolha system-source.zip depois de revisar os fontes. O manifesto declara system.actorTypes, system.itemTypes e a entrada de navegador.

  2. Como mestre, crie uma campanha descartável e escolha Example Expedition como sistema. Abra a mesa e confira que a versão instalada está ativa. Registrar uma ficha não transforma um complemento em sistema.

  3. Em Atores, crie um personagem e um NPC. Abra os dois. O pacote registra replace em actor.sheet e token.sheet com filtro character e npc. O host fornece título e controles da janela; o pacote desenha o corpo completo.

Execute o fluxo completo de edição

Digite vigor 17, salve, feche e reabra. Teste vazio, negativo e acima de 100; rascunhos rejeitados não podem substituir dados do servidor. Abra como jogador somente leitura. Crie um token vinculado e outro independente do mesmo personagem e altere vigor separadamente. A ficha vinculada compartilha o ator; o token independente usa snapshot e sheetVersion próprios. O pacote deve preservar os demais dados e enviar as duas revisões a saveSheet.

Escolha a substituição correta

Sem preferência concorrente explícita, a ficha correspondente do sistema da campanha tem prioridade. Um sistema pode registrar listas types separadas; omita types apenas se implementar todos os tipos de ator. Se dois módulos disputarem a mesma superfície, revise a preferência de substituição da mesa em vez de presumir ordem de carregamento. token.sheet explícito atende tokens; actor.sheet pode servir como alternativa do sistema quando não houver registro correspondente de token. Uma falha na substituição escolhida restaura a interface nativa. Leia as regras do SDK.

Mantenha complementos como Ação no nome da ficha em augment. Duas substituições completas não se tornam um editor mesclado. Salve a ficha do sistema antes de usar um complemento que envia sua própria cópia completa dos dados.

Valide uma atualização

Mude a versão do pacote, gere e instale outro ZIP e ative explicitamente a versão nova. Não altere arquivos instalados. Abra personagens antigos e os dois modos de token; preserve vigor, teste conflito entre sessões e feche durante a gravação. Falhas devem manter a janela aberta ou restaurar a superfície nativa, com diagnóstico útil. Desativar deve abortar leituras e remover elementos/listeners. Mantenha recursos, traduções e automações desse sistema no mesmo pacote e use somente as APIs disponíveis na 0.3.0.

Como usar a IA para uma substituição completa

text
Use o pacote completo Example Expedition no Gravewright 0.3.0. Acrescente um campo original e sua validação, preservando tipos character/NPC, leitura de ator e token, revisões, sheet-flush nativo, permissões e liberação de recursos. Explique cada arquivo alterado. Não entregue uma substituição vazia, separe regras em pacote complementar, importe partes privadas do host nem atualize o VTT. Verifique criar, editar, salvar, fechar, reabrir, tokens vinculados/independentes e sessões conflitantes.

Todos os tutoriais · Pacote-fonte completo