Skip to content

About

Adaptador experimental de animações para o sistema GM no Foundry VTT, usando Sequencer e bibliotecas com JB2A.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

GUM Animations

Hub extensível de integração entre o sistema GUM e módulos de animação do Foundry VTT.

O GUM publica eventos semânticos. O GUM Animations encaminha cada evento ao primeiro adaptador visual disponível. Ele não altera rolagens, dano, condições ou efeitos do sistema.

Requisitos

  • Foundry VTT 13 ou 14;
  • GUM com API pública 1.3.0 ou mais recente.

O núcleo não exige Sequencer, JB2A ou Automated Animations. Cada adaptador declara e detecta suas próprias dependências. A primeira integração incluída é com Automated Animations, que usa Sequencer e suas bibliotecas de recursos normalmente.

Automated Animations

Quando Automated Animations está ativo, o adaptador recebe uma rolagem concluída do GUM e chama:

AutomatedAnimations.playAnimation(sourceToken, item, {
  targets,
  hitTargets,
  playOnMiss
});

Assim, a configuração visual continua no botão A-A do próprio Item. O GUM Animations apenas fornece o Item usado, o token de origem, os alvos e o resultado da rolagem.

Ativações normais de Item não são processadas duas vezes: itemUse com gatilho activate é ignorado porque a rolagem concluída já representa esse fluxo. Consumos sem rolagem usam o gatilho consume.

Efeitos persistentes

Itens Efeito do GUM exibem um controle adicional A-A Efeito persistente. Ele abre no A-A a ponte ActiveEffect nativa do Item Efeito, em vez de configurar a animação de uso do Item.

A configuração permanece armazenada nessa ponte e é propagada pelo GUM ao único ActiveEffect marcado como portador visual. Assim, criar ou ligar o efeito inicia a animação persistente; desligar ou remover o efeito permite que o ciclo nativo do A-A a encerre. Aplicações vindas de Itens, Regiões, Escudo do Mestre ou API usam o mesmo caminho sem animar cada ação mecânica irmã.

API de adaptadores

Disponível após o hook gumAnimations.ready e em game.modules.get("gum-animations").api:

Hooks.once("gumAnimations.ready", api => {
  api.adapters.register({
    id: "meu-adaptador",
    label: "Meu módulo visual",
    priority: 50,
    isAvailable: () => game.modules.get("meu-modulo")?.active === true,
    canHandle: ({ eventType, context }) => eventType === api.eventTypes.ROLL && Boolean(context.item),
    async handle({ context }) {
      // Reproduzir a animação e retornar false apenas se quiser
      // permitir que o próximo adaptador tente tratar o evento.
      return { handled: true };
    }
  });
});

Os adaptadores são avaliados por prioridade. O primeiro que tratar o evento interrompe a cadeia, evitando animações duplicadas.

API de presets

Módulos externos podem registrar provedores de presets sem fazer parte do núcleo:

api.presets.register({
  id: "comunidade.magias",
  label: "Presets de Magias",
  version: "1.0.0",
  moduleId: "gum-spell-presets",
  describe: () => presetsDisponiveis,
  apply: options => aplicarPresets(options)
});

A interface para escolher e atualizar provedores será uma etapa posterior. O contrato já separa o hub dos pacotes de conteúdo e permite que outros módulos forneçam presets.

Estado da versão 0.4.0

  • hub ordenado e extensível de adaptadores;
  • adaptador inicial para Automated Animations;
  • sucesso e falha encaminhados como hitTargets e playOnMiss;
  • consumo de Item sem duplicar ativações originadas por rolagem;
  • registro público de provedores de presets;
  • editor de mapeamentos próprio removido em favor da configuração A-A do Item;
  • nenhuma dependência visual obrigatória no núcleo.
  • configuração específica de animações persistentes dos Itens Efeito pela ponte ActiveEffect do GUM.

Desenvolvimento

Coloque o repositório em Data/modules/gum-animations, habilite o módulo no mundo e ative o módulo visual correspondente ao adaptador que deseja usar.

About

Adaptador experimental de animações para o sistema GM no Foundry VTT, usando Sequencer e bibliotecas com JB2A.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages