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.
- Foundry VTT 13 ou 14;
- GUM com API pública
1.3.0ou 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.
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.
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ã.
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.
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.
- hub ordenado e extensível de adaptadores;
- adaptador inicial para Automated Animations;
- sucesso e falha encaminhados como
hitTargetseplayOnMiss; - 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.
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.