Criador do Módulo
Exemplos: bandeja de dados e dock de ação
Compare o tempo de execução do host ao vivo, a visualização do contrato interativo e as exposições representativas do host no Module Lab.
Bandeja de dados: andaime de concreto e tempo de execução do host
O andaime CLI é o pacote concreto Dice & Chat. O Dice Tray original do Fabled usa o mesmo modelo: um alvo de conta contribui com um painel de composição de bate-papo e um comando global, solicita dice.roll.self, opcionalmente solicita chat.post.self e aponta para ativos de ação/frame/locale revisados.
- O pacote fornece uma expressão de dados, escolha de visibilidade, botões de dados, predefinições e rótulos localizados.
- O renderizador fabled.dice-tray.v1 permitido na lista pertence a Fabled; o módulo não fornece UI React arbitrária.
- O anfitrião verifica o descritor de ação exato, executa a rolagem nativa, possui o resultado e a apresentação 3D e aplica regras de público.
- Module Lab apresenta uma prévia do dispositivo canônico Dice Tray do Fabled em desenvolvimento. Ele não pode carregar um caminho de projeto arbitrário nem instalar, ativar, aprovar ou publicar um pacote.
Action Dock: visualização interativa do contrato
O pacote fabled-labs.token-action-hud tem como alvo vtt e visualiza uma sobreposição de seleção compacta para o token controlado. Ele contribui com uma configuração de modo compacto userCampaign e usa descritores Action Dock revisados que permanecem inertes como outros ativos até que o contrato do renderizador VTT de produção seja admitido.
| Capacidade | Por que a visualização pede isso | Consentimento |
|---|---|---|
| tokens.read.controlados | Leia a visualização segura do token controlado pelo usuário | campanha e usuário |
| framework.invoke.controlado | Invocar uma ação de token controlado revisada | campanha e usuário |
| events.observe.declarado | Observe a seleção declarada e as mudanças de estado de giro | campanha |
| dice.roll.self (opcional) | Role para uma ação revisada quando o usuário a invoca | usuário |
A visualização demonstra contexto filtrado por permissão, rejeição de estado obsoleto, envio de comando idempotente, localização e configurações de escopo, enquanto Fabled mantém autoridade de ação. Um manifesto válido para esquema é apenas o limite do pacote; o contrato do renderizador de produção indisponível ainda impede a admissão fora do Laboratório.
Comando de boas-vindas e ficha de personagem: exposições anfitriãs
O Module Lab também inclui duas exposições representativas do anfitrião, e não demonstrações do pacote completo. O comando de boas-vindas espelha um módulo de campanha gerenciado pelo proprietário cujo comando Spotlight produz um resultado de bate-papo comum e desaparece após ser desativado. A Folha de Personagem reflete uma contribuição revisada apenas de marcador para o FramePreview canônico do Fabled, com negação de VIEW e desmontagem em modo de segurança mantendo os dados do personagem dentro do host.
Efeitos de feitiços: CLI candidata a partir do código-fonte
npm run modules:cli -- module init arcane-arsenal --template spell-effects --publisher-id my-studio --publisher-name "My Studio"O modelo inclui seis exemplos: arcane_bolt, dragon_fire, frost_breath, toxic_breath, sword_swing e melee_hit. O anfitrião da versão de código-fonte correspondente aceita 12 predefinições no total, incluindo também lightning_arc, meteor_strike, frost_nova, void_vortex, radiant_sigil e thorn_burst. As receitas definem cores fixas, intensidade e uma duração de 300–2200 ms através do mesmo contrato fabled.vtt-effect.v1 com sete chaves. Fornecem apenas efeitos visuais: sem shaders arbitrários, camadas, dano, cura, custos de recursos ou regras de feitiços importadas.
Após a revisão e instalação da versão exata, o proprietário da campanha ativa o módulo em Campanha → Módulos. No VTT, um mestre de jogo autorizado usa a ferramenta de alvos para selecionar 1–8 fichas existentes, abre o menu de contexto de outra ficha de origem, expande Arcane Arsenal e escolhe uma receita. O Fabled valida o lançamento e transmite o efeito autorizado. A desativação remove o menu e impede novos lançamentos; os efeitos já admitidos terminam em até 2200 ms.
O padrão reutilizável
- Declare a intenção no manifesto e nos ativos JSON exatos.
- Solicite os recursos mínimos e escopos de consentimento.
- Deixe o Fabled possuir renderizadores, filtragem de contexto, mutações autorizadas e resultados.
- Valide e inspecione localmente e, em seguida, envie evidências imutáveis para revisão.
- Espere desativação, substituição, revogação e modo de segurança para eliminar as contribuições de forma limpa.