Macros e ações de token

Macros & Ações de token são atalhos personalizados para comandos repetidos com frequência. As macros fazem parte do jogo. As ações simbólicas pertencem a personagens individuais. De resto, são a mesma tecnologia. Saiba mais aqui.

Por exemplo, pode criar um atalho que faça com que uma personagem lance um grito de guerra e execute automaticamente uma habilidade frequentemente utilizada. Para um acesso rápido, pode adicionar estes comandos à sua Barra Rápidaou às Ações de Token.

Criando a sua primeira macro

Aceda ao separador«Coleções» no VTT. Clique no botão «+Adicionar » ao lado do título «Macros». Aqui pode escrever a sua primeira macro simples. 

Vamos começar de forma muito simples, com uma macro que se limita a enviar uma linha de texto para o chat e a lançar um d20. 

Nome: A minha primeira macro

Ações: 

Esta é a minha primeira fotografia macro!
/role 1d20 + 5

Uma macro mais avançada

Agora, vamos tentar uma macro mais avançada. Esta macro pode ser utilizada em qualquer jogo de D&D 5E para efetuar um teste de resistência para qualquer ficha selecionada. Funciona da mesma forma tanto para PCs como para NPCs, pelo que um GM nunca teria de abrir uma ficha de personagem para lançar os dados.

Nome: Salvamento

Ações: 

/w gm &{template:default} {{name=@{selected|token_name} tenta um ?{Escolha o teste de resistência|
Força (@{selected|strength_save_bonus}), teste de resistência de Força [[1d20 + @{selected|strength_save_bonus}]]|
Destreza (@{selected|dexterity_save_bonus}), Teste de Defesa de Destreza [[1d20 + @{selected|dexterity_save_bonus}]]|
Constituição (@{selected|constitution_save_bonus}), Teste de Defesa de Constituição [[1d20 + @{selected|constitution_save_bonus}]]|
Inteligência (@{selected|intelligence_save_bonus}), Teste de Defesa de Inteligência [[1d20 + @{selected|intelligence_save_bonus}]]|
Sabedoria (@{selected|wisdom_save_bonus}), Teste de Defesa de Sabedoria [[1d20 + @{selected|wisdom_save_bonus}]]|
Carisma (@{selected|charisma_save_bonus}), Teste de Defesa de Carisma [[1d20 + @{selected|charisma_save_bonus}]]}}}

Criando a sua primeira ação de token

As ações de token são uma variante das macros que pertencem a uma personagem específica. Os comandos são, em geral, os mesmos; apenas os contextos diferem. Poderá encontrá-las e geri-las no separador «Ferramentas Avançadas / Atributos» & «Habilidades» de cada ficha de personagem.

Atalho! Se estiver a utilizar a ficha «D&D 2024» da Roll20, criar «Ações de Ficha» é incrivelmente simples. Basta abrir a ficha da sua personagem, aceder a qualquer janela modal de ação ou habilidade e selecionar «Adicionar à barra de fichas»

Caso contrário, no separador «Ferramentas Avançadas» da ficha de personagem, pode clicar no botão «+ Nova Macro ». Vamos criar um que lance automaticamente a iniciativa do seu personagem no seu jogo de D&D 5E e, em seguida, a adicione ao «Turn Tracker» do Roll20.

Nome: Iniciativa

Macro:

 @{selected|token_name} lança o dado para a iniciativa!
/roll 1d20 + @{selected|initiative_bonus} &{tracker}

Utilizando Macros & Ações de Token

As macros podem ser ativadas premindo o botão associado na sua Barra Rápida ou digitando-as diretamente no chat! Para executar uma macro no chat, escreva # e o comando (por exemplo, #test) e prima Enter.

As ações do token podem ser acionadas pressionando o botão associado na barra de ações do token. 

Comandos múltiplos

Um dos pontos fortes do sistema de macros é a sua capacidade de executar várias ações com um único comando. Para tal, basta colocar cada elemento numa linha separada, e as ações serão executadas por ordem quando executar a macro.

Exemplo

Se eu quiser criar uma macro que inclua um emote, além dos seus lançamentos de ataque e de dano, a macro ficaria assim:

Nome: adaga

Macro:

/me enfia a adaga com força
/roll 1d20+10 contra CA
/roll 1d4+9 de dano

As macros também podem incluir uma combinação de linhas de comando e linhas que não são de comando, por exemplo:

Eu invoco o poder de Moradin!
Eu o castigo!
/role 1d20+4 contra reflexo
/role 1d8+4 de dano

Isso primeiro expressaria emoção e, em seguida, enviaria "Eu o castigo!" no chat e, em seguida, faça os dois lançamentos."

Macros aninhadas

As macros podem ser aninhadas umas dentro das outras, o que permite combinar macros e chamar várias macros com uma única ação. Para aninhar uma macro, basta incluir o nome da macro que pretende chamar numa linha separada dentro da sua macro.

Exemplo

Neste exemplo, teremos três macros:#dano#ataquee#ambos

Macro #dano = /roll 1d4+11
Macro #ataque = /roll 1d20+9
Macro #ambos =
#ataque
#dano

Aninhamento numa consulta de lançamento de dados

Se estiver a aninhar uma macro numa consulta Roll, certifique-se de que existe um espaço após o nome da macro, para que esta seja devidamente reconhecida.

Qual macro? | Atacar, #usar-espada | Defender, #usar-escudo

Resolução de problemas

Devido à ordem das operações, as chamadas de macro aninhadas em consultas de lançamento de dados são totalmente expandidas antes de a consulta completa ser executada. Isto significa que, se uma macro aninhada numa consulta de lançamento de dados contiver quaisquer «caracteres problemáticos» que entrem em conflito com a sintaxe da consulta (tais como «}», «,» e «|»), essa macro poderá fazer com que toda a consulta deixe de funcionar. A razão é que a consulta irá considerar os caracteres problemáticos na macro referenciada como parte da sintaxe original.

Se for esse o caso, poderá ser necessário remover esses caracteres problemáticos (na própria macro chamada) ou substituí-los por entidades HTML.

As macros que contêm substituições de entidades HTML podem deixar de funcionar fora de uma consulta Roll. deve ser guardado como Habilidades.

Ao reabrir uma macro de coleções, as entidades HTML são revertidas; se essa macro for posteriormente guardada, essas reversões também serão guardadas. Este comportamento não se verifica em Habilidades.

Capacidades de aninhamento

Uma habilidade é outro nome para uma macro específica de uma determinada personagem e que é criada na ficha de personagem, disponível no separador «Diário». Tal como as macros, as habilidades podem ser aninhadas umas dentro das outras, o que lhe permite encadear habilidades e ativar várias habilidades com uma única ação.

Aninhar uma função é semelhante a aninhar uma macro, mas com uma ligeira diferença. Tal como numa macro, basta incluir o nome da função que pretende chamar numa linha separada, dentro da função que a chama. Além disso, tem de substituir o símbolo do número (#) pelo símbolo de percentagem (%) e, em seguida, incluir o nome da personagem antes do nome da habilidade, utilizando uma barra vertical (|) para os separar.

A tecla do tubo vertical encontra-se acima da tecla da barra invertida (\) na maioria dos teclados. Esta tecla encontra-se normalmente junto à tecla «Enter» num teclado norte-americano e na fila dos números nos teclados europeus.

Exemplo

Neste exemplo, teremos três habilidades: %damage%attacke %both, bem como a nossa personagem, que se chamaráBugbear

Habilidade%damage = /roll 1d4+11
Habilidade%attack = /roll 1d20+9
Habilidade%both =
%{Bugbear|attack}
%{Bugbear|damage}

Mais exemplos

Aqui estão alguns exemplos específicos do sistema:

Macros DnD 5e/Next

Macros Pathfinder

Botões de comando de habilidades

Os botões de comando de habilidades podem ser utilizados para ativar Habilidades (ou lançamentos de dados da ficha) a partir de um botão clicável no Chat de Texto. Estão intimamente relacionados com Botões de comando dos Mods (API). 

A sua sintaxe é a seguinte:

[Etiqueta](~<palavra-chave>|<nome da habilidade>)

Tal como no caso de Atributo e chamadas de , apalavra-chavepode ser«selecionado»,«alvo»ou o «nome_da_personagem», à sua escolha. Também é possível utilizar um character_id como palavra-chave. 

Se tiver um botão de comando de habilidade guardado algures numa das separadores da Janela de Personagem, pode optar por omitir uma palavra-chave:

[Etiqueta](~<nome da habilidade>)

Dando continuidade ao exemplo de Habilidades, o Bob, o Assassino, poderia inserir[Balançar o Machado!!](~Machado Enorme) noutra das suas Habilidades, para que pudesse despedaçar os seus inimigos com maior facilidade.

Macros de atributos

As macros de atributos combinam os exemplos mencionados acima. Ao utilizar um atributo atribuído a uma personagem como modificador variável, pode criar macros complexas com base na personagem. Uma vez que a variável na macro está associada a um atributo da personagem, quaisquer alterações efetuadas no editor de personagens irão atualizar automaticamente o valor.

Utilizando um token selecionado com uma macro

A palavra-chave selecionada permitir-lhe-á obter informações do elemento que estiver atualmente selecionado no ecrã quando o roll/macro for executado. Assim, por exemplo, se pretender obter o valor da Barra 1 a partir do token selecionado durante um lançamento, pode escrever:

/roll 1d20 + @{selected|bar1}

Pode utilizar "bar1", "bar2" ou "bar3". Além disso, pode obter um atributo da personagem associada a esse token:

/roll 1d20 + @{selected|Intelligence}

Pode obter o nome dos tokens atualmente selecionados utilizando a variável «token_name»:

/em @{selected|token_name} dispara a sua arma!

Se o token selecionado tiver um diário de personagem associado, pode obter o nome a partir do diário de personagem, em vez de utilizar a variável «character_name»:

/em @{selected|character_name} bloqueia com o seu escudo!

Pode ativar habilidades a partir do diário da personagem associada, utilizando o nome da habilidade como variável:

>{selected|Attack}

Por fim, introduzimos um terceiro argumento para as variáveis, que lhe permite obter o «valor máximo» de uma barra ou de um atributo:

/roll 1d20 + @{Guard|Intelligence|max}
/roll 1d20 + @{selected|bar2|max}

Todos os nomes, incluindo os das personagens, dos atributos e das habilidades, não distinguem maiúsculas de minúsculas quando utilizados. Isto significa que tanto «GUARD» como «guard» corresponderão à personagem chamada «Guard».

Atributos e fichas de personagens

As fichas de personagem apresentam um grande número de atributos aos quais poderá querer fazer referência nas suas macros personalizadas. Uma coisa que deve ter em conta é o atributo «Fórmula de cálculo automático». As fichas de personagens apresentam frequentemente atributos calculados com base em fórmulas que envolvem outros atributos. Ao referenciar esse atributo, será apresentada a fórmula em vez do valor.

{selected|character_name} possui{selected|action_points} pontos restantes.

Rolf possui ((ceil(((13+0)+(14+0))/12)+0)+0) pontos restantes.

Para contornar esta situação, é necessário envolver a referência ao atributo num roll inline:

{selected|action_points}@{selected|character_name} possui pontos restantes.

Rolf possui 3 pontos restantes.

Utilizando um token direcionado com uma macro

À semelhança do que acontece com a palavra-chave «selected», que permite recuperar informações de um token selecionado, a palavra-chave «target» permite aceder às variáveis e capacidades de um token alvo. Este comando permite aos jogadores escolher entre fichas que normalmente não podem selecionar, o que é útil para fazer lançamentos contra os inimigos. Por exemplo, se instruir um jogador a lançar um único 1d20 contra um alvo com o atributo «inteligência», o lançamento seria apresentado da seguinte forma:

/roll 1d20 - @{target|intelligence}

Isto fará com que apareça um ecrã de solicitação para que o jogador selecione o alvo de ficha contra o qual vai lançar os dados:

A palavra-chave de destino é utilizada de forma semelhante à palavra-chave selecionada mencionada anteriormente, com duas diferenças principais. Em primeiro lugar, a palavra-chave «target» permite aos jogadores utilizar valores de fichas que não controlam. Em segundo lugar, a sintaxe para fazer referência à parte «max» de um atributo é ligeiramente diferente. Consulte a subsecção sobre utilização avançada abaixo para obter mais detalhes sobre a sintaxe completa.

Utilização avançada para chamadas de atributos direcionadas

A sintaxe completa para a variável de destino é:

@{target|<nome_do_alvo>|<nome_do_atributo>|<sinalizadores_opcionais>}

(Note que «target_name» pode ser o que quiser e pode incluir espaços.)

Portanto, se pretender incluir vários alvos na sua macro, pode fazer o seguinte:

{target|Target1|HP} vs @{target|Target2|AC}

E se desejar utilizar o máximo de um atributo:

{target|Target1|HP|max}

Tenha em atenção que, se pretender utilizar o valor «máximo» de um atributo, deve especificar o nome do atributo, mesmo que se limite a indicar «target1», tal como acima.

Além disso, se utilizar o mesmo «target_name» em várias consultas de atributos, só lhe será solicitado uma vez e o mesmo token será utilizado para responder a todas as consultas de atributos. Isto também se aplica quando tem macros ou comandos com várias linhas:

/eu ataca @{target|foe|character_name}!
Para acertar: [[1d20+3]] contra @{target|foe|npc_AC} AC

Referenciando atributos repetidos

Por RowIndex

Os atributos numa linha repetida podem ser referenciados através do seu RowIndex. ORowIndex de um atributo começa em 0 (o índice refere-se ao deslocamento a partir do topo), pelo que a primeira linha utiliza $0, a segunda utiliza $1, a terceira utiliza $2, etc.

No caso de uma secção repetitiva denominada «Items», poderá aceder ao atributo «ItemBonus» do segundo item de uma personagem utilizando a seguinte sintaxe:

{selected|repeating_items_$1_itembonus}

Por RowID

Também pode utilizar oRowIDpara fazer referência ao atributo. A vantagem de utilizar oRowIDé que este não é afetado por uma alteração na ordem (seja por eliminação ou por reordenação das linhas). Para obter oRowID(caso não tenha sido indicado de alguma forma pelo autor da ficha de personagem), deve consultar o código-fonte da ficha. Percorra o código HTML para cima até encontrar uma etiqueta com uma propriedade denominadadata-reprowid. O valor desta propriedade é oRowID:

<div class="repitem" data-reprowid="-KC0zCLum1Rq3V5wssyE">

ORowIDé então utilizado em vez doRowIndex:

{selected|repeating_items_-KC0zCLum1Rq3V5wssyE_itembonus}

Opções de lançamento de dados

As opções de lançamento de dados são indicadores utilizados num lançamento de dados para indicar ações especiais a realizar com o resultado do lançamento.

Lançamento de iniciativa

Para enviar o resultado de um lançamento diretamente para o Turn Tracker, selecione o Token ou a iniciativa e inclua a seguinte opção de lançamento na sua macro:

/role 1d20 + 5 &{tracker}

A opção de lançamento de dados «tracker» no Roll20 mostra os resultados do lançamento e utiliza esse resultado como valor no contador de turnos. Se o token selecionado não tiver uma vez na ordem de jogada, será adicionado um novo. Se já tiverem voltas, estas serão atualizadas com o novo valor.

Além disso, pode adicionar ou subtrair o resultado do lançamento ao valor atual da volta da ficha selecionada, utilizando os seguintes indicadores:

/roll 1d20 + 5 &{tracker:+}
/roll 1d20 + 5 &{tracker:-}

Num jogo como o Shadowrun, em que pretende subtrair 10 da iniciativa atual após cada turno, poderia utilizar uma macro global como esta:

/me @{selected|token_name} encerra o seu turno. [[10 &{tracker:-}]]

Note-se que o indicador «tracker» funciona tanto em lançamentos normais como em lançamentos em linha.

Pode até mesmo fazer referência a estes valores da mesma forma que faria com os atributos, utilizando a sintaxe:@{tracker|Nome do item}

Suprimindo mensagens de erro

A opção «noerror» da execução suprimirá quaisquer erros (tais como erros de variável não encontrada) numa execução.

/roll 1d20 + @{selected|nonexistent_attribute} &{noerror}

Utilizando uma variável com uma macro

A forma mais fácil de incluir uma variável numa macro que especifique no momento da sua execução é utilizar umaconsulta Roll. Por exemplo, se pretender adicionar um modificador variável a um lançamento, pode criar uma macro da seguinte forma:

/roll 2d20 + ?{Modifier|0}

Quando a macro for executada, aparecerá uma mensagem a solicitar o modificador a incluir. Se não for especificado nenhum modificador, a parte «|0» da consulta indica que se deve utilizar 0 como valor por predefinição.

Encontrará mais informações sobre as consultas «Roll Queries» na Referência do Dice.

Especificando uma variável no chat

Se pretender utilizar um modificador de variável com o seu comando de macro, basta terminar o comando da macro com o modificador e, em seguida, especificá-lo ao chamar a sua macro.

Por exemplo: se pretender uma macro para 1d20+x (em que x é o valor da minha variável), poderá criar a seguinte macro:

#d20 /role 1d20+

#d204

Solicitações suspensas para consultas de rolo

Pode especificar uma lista de opções que podem ser apresentadas ao jogador, em vez de apenas um campo de texto livre.

Aqui está a sintaxe:

{Name of Query|Option1|Option2|Option3|Option4|Option5}

Também pode especificar um valor diferente para o resultado, que não seja «label», da seguinte forma:

{Name of Query|Label 1, value1|Label 2, value2}

Exemplos

Ataque Especial:

... + [[ ?{Ataque furtivo?|Não, 0|Sim, 3d6} ]] + ?{Ataque poderoso?|Não, 0|Sim, 6 [Ataque poderoso!]}

D&D 5e Teste de Ataque:

[[ ?{Tipo de Ataque|Padrão, 1d20|Vantagem, 2d20kh1|Desvantagem, 2d20kl1} ]]

Feitiço de Cura:

?{Feitiço|
   Curar Feridas Leves, **Curar Feridas Leves** O alvo recupera [[1d8+5]] HP. 
   Cura Feridas Moderadas, **Cura Feridas Moderadas** O alvo recupera [[2d8+8]] HP. 
   Cura Feridas Graves, **Cura Feridas Graves** O alvo recupera [[3d8+8]] HP.
}

Exemplo (aninhamento de consultas de rolo)

?{Nome da consulta|
   Etiqueta 1, ?{valor1|
      Etiqueta 1A, valor1A |
      Etiqueta 1B, valor1B 
   } |
   
   Etiqueta 2, ?{value2|value2} 
}

É possível alcançar níveis adicionais de aninhamento através do «empilhamento» de entidades HTML:

Exemplo

?{Nome da consulta|
   Etiqueta 1, ?{valor1|
      Etiqueta 1A, ?{valor1A|
         Etiqueta 1Ai, valor1Ai |
         Etiqueta 1Aii, value1Aii
      } |
      
      Etiqueta 1B, ?{value1B|
         Etiqueta 1Bi, value1Bi |
         Etiqueta 1Bii, value1Bii
      }
   } |

   Etiqueta 2, ?{value2|value2} 
}

Barra Macro

Pode criar botões de acesso rápido para qualquer uma das suas macros, os quais aparecerão numa barra na parte inferior do ecrã. Em primeiro lugar, crie a sua macro como habitualmente. Para ativar a barra rápida de macros, assinale a opção «Mostrar barra rápida de macros» no menu de definições.

Para adicionar uma macro à barra, basta selecionar a opção «Na barra» ao lado do nome da macro. Se se tiver esquecido de ativar a barra rápida de macros, ao ativar uma macro, a barra rápida será automaticamente exibida.

A barra rápida e as macros selecionadas passarão a ser apresentadas na parte inferior do ecrã, por baixo dos retratos das personagens. Para reorganizar os botões, passe o cursor sobre um botão e utilize a alça que aparece do lado direito para o arrastar. Clique no puxador para reorganizar o botão ou arraste-o para fora da área para o remover.

Ao clicar com a tecla Shift pressionada numa macro na barra de acesso rápido às macros, abre-se o editor dessa macro específica.

Menu Macro

Enquanto jogador ou GM, pode clicar com o botão direito do rato num botão de macronabarra rápida de macros para abrir um menu de configuração que lhe dá acesso a algumas funcionalidades simples que afetam a forma como a macro é apresentada.

Renomear

Selecione a opção«Renomear»para abrir uma caixa de diálogo que lhe solicitará um novo nome a apresentar para a macro. Isto é particularmente útil para macros criadas ao arrastar botões para fora das fichas de personagens.

Cor

Selecione a opção«Cor»para abrir o seletor de cores. Isto permite-lhe alterar a cor de fundo dobotão de macro, para facilitar a distinção visual entre os diferentes botões. A cor do texto do botão irá alterar-se para manter o contraste com a cor de fundo escolhida.

Preenchimento automático

Algumas áreas de texto no Roll20 suportam o preenchimento automático para:

• Macros (utilizando #)
• Atributos (utilizando @)
• Habilidades (utilizando %)

A funcionalidade de preenchimento automático ajuda-o a aceder rapidamente a macros, atributos ou habilidades sem ter de escrever os seus nomes completos.

Onde funciona

O preenchimento automático está disponível em:

• As Campo «Ações» ao criar ou editar uma macro

• As Campo de uma Habilidade (no separador «Atributos» & «Habilidades» de uma personagem)

• O Chat de texto janela

Como Funciona

1. Digite um dos símbolos #, @ ou % seguido de algumas letras ou números.

2. O Roll20 irá apresentar uma lista de macros, atributos ou habilidades correspondentes que pode inserir.

3. Utilize as teclas de seta para cima/para baixo para navegar pela lista e prima Enter para selecionar.

Regras de Acesso

• Apenas macros que pode ver nas suas separador «Coleções» é que serão apresentadas.

• Apenas atributos e habilidades dos personagens que controla serão exibidos.

Exemplo

Se controlar uma personagem com um atributo denominado Inteligência, escreva:

@int

A lista irá apresentar todos os atributos que incluam «int», tais como @intelligence.

Sugestão

No chat, depois de lançar um dado a partir da ficha da sua personagem, prima a tecla tecla de seta para cima .

Revela o código que gerou o lançamento. É ideal para combinar vários comandos num único botão de macro personalizado.

Tabelas Roláveis

As macros podem incluir tabelas deslocáveis. O GM deve criá-los e torná-los visíveis para o jogador, para que estes possam utilizá-los em macros.

Utilizando modelos de lançamento de dados

Ao utilizar uma ficha de personagem, é provável que utilize um modelo de lançamento de dados, clicando no botão de lançamento ou invocando um lançamento da ficha numa macro ou numa habilidade. Não é necessária nenhuma ação adicional da sua parte, pois o autor da folha já configurou tudo antecipadamente para si.

Se estiver interessado em utilizar os modelos Roll nas suas próprias macros personalizadas ou em criar os seus próprios modelos personalizados, continue a ler.

A utilização de um modelo de rolo é bastante simples. Inclua um indicador na sua mensagem de chat para indicar que está a utilizar um modelo de Roll e forneça os dados pretendidos. Eis um exemplo que utiliza o modelo predefinido, disponível em todos os jogos, independentemente do sistema ou da ficha de personagem:

&{template:default} {{name=Ataque de Teste}} {{attack=[[1d20]]}} {{damage=[[2d6]]}}

O &{template:<template_name>} especifica o modelo «Roll» a utilizar com o nome indicado. Depois, basta fornecer todos os dados para o modelo no formato {{<nome_da_propriedade>= <valor>}}. O «nome da propriedade» que deve utilizar depende do modelo — a documentação da Ficha de Personagem deve indicar-lhe o que está disponível, e disponibilizamos abaixo documentação sobre todos os modelos integrados. «Valor» pode ser texto ou um lançamento em linha, incluindo macros, habilidades, etc. Tenha em atenção que, se utilizar uma macro ou uma habilidade, o lançamento de dados deve ser feito diretamente no texto, e não através do comando «/roll».

Aqui está um exemplo que utiliza a funcionalidade "%{Character|attack}":

&{template:default} {{name=Teste com habilidade}} {{attack= %{Character_Name|attack} }} {{damage= #damagemacro }}

Quando posso utilizar modelos de rolo?

Pode utilizar um modelo de roll em mensagens gerais (sem um comando como «/desc» ou «/emote») e em mensagens privadas. Não é possível utilizar modelos de lançamento com o comando «/roll»; em vez disso, os modelos de lançamento destinam-se a ser utilizados com lançamentos embutidos. Desde que utilizem lançamentos em linha, pode utilizar modelos de lançamento com macros e habilidades de personagens, e os autores das fichas podem utilizá-los nos seus botões de lançamento nas fichas.